mdd

name	mdd
description	Markdown 驱动开发（MDD）— 通过 Markdown spec 文件管理人机协作，支持 /new 清空上下文后继续工作。Use when 用户需要重构、新功能开发、执行复杂多步任务、或说"按 spec 执行"、"mdd"、"markdown 驱动"。

Markdown 驱动开发（MDD）

核心协议

你是执行者，不是设计者。Markdown spec 文件是唯一权威指令源。用户通过修改 spec 来控制方向，你严格按照 spec 执行。

铁律

1. 严格按 spec 执行 — 不自行扩展范围，不"顺手"做 spec 外的事
2. 不在聊天里提问 — 模糊点写到 spec 的「待确认」区，标记 [待确认]
3. 不修改用户内容 — spec 中用户写的部分只读，只能追加待确认和更新状态
4. 不猜测意图 — 不确定就写待确认，不自行决定

---

工作流一：初始化项目 /mdd setup

在项目中建立 MDD 目录骨架，并在 CLAUDE.md 末尾追加一行引导：

mkdir -p docs/specs
cp <skill-assets>/task-template.md docs/specs/_TEMPLATE.md

在项目 CLAUDE.md 末尾追加（如已有则跳过）：

复杂任务走 MDD 工作流，使用 /mdd run <task-name> 执行，详细协议见 mdd skill。

完成后提示用户：目录已建，模板已就位，可以 /mdd new <name> 创建第一个任务。

---

工作流二：创建任务 /mdd new <name>

1. 复制 docs/specs/_TEMPLATE.md → docs/specs/<name>.md
2. 把模板中的 [任务名称] 替换为 <name>
3. 状态设为 🔴 待开始
4. 提示用户：spec 文件已创建，请填写后 /new 然后 /mdd run <name>

---

工作流三：执行任务 /mdd run <name>

启动

1. 读取 docs/specs/<name>.md — 这是唯一任务指令
2. 检查「待确认」区是否有未解决的 [待确认] — 有则先提醒用户处理
3. 确认理解目标、约束、步骤、验收标准后开始执行

执行

• 逐个步骤执行，每步完成后更新该步骤状态为 ✅
• 遇到模糊点：暂停，在 spec 底部「待确认」区追加问题，标记时间戳
• 不执行 spec 未列出的步骤

收尾

• 更新 spec 顶部状态：🟢 已完成 / 🟡 待确认
• 填写「完成记录」：时间、改动文件列表、验证结果
• 如有待确认事项，提示用户审核后 /new 继续
• 改完就提交commit，commit内容必须是中文

---

Spec 文件格式

# [任务名称]

**状态：** 🔴 待开始 / 🟡 进行中 / 🟢 已完成 / 🔵 待确认
**对应文档：** [相关需求/接口文档]
**预估影响范围：** [文件数量/目录]

## 目标
[一句话描述]

## 当前问题
[具体问题描述]

## 约束
- [约束1]
- [约束2]

## 执行步骤
1. [步骤1]
2. [步骤2]

## 验收标准
- [ ] [标准1]
- [ ] TypeScript 类型检查通过
- [ ] 开发服务器启动正常

## 完成记录
- **完成时间：** [日期]
- **改动文件：** [列表]
- **验证结果：** [结果]

## 待确认
<!-- Claude 在此追加问题，用户审核后删除 -->