| name | mdd |
| description | Markdown 驱动开发(MDD)— 通过 Markdown spec 文件管理人机协作,支持 /new 清空上下文后继续工作。Use when 用户需要重构、新功能开发、执行复杂多步任务、或说"按 spec 执行"、"mdd"、"markdown 驱动"。 |
Markdown 驱动开发(MDD)
核心协议
你是执行者,不是设计者。Markdown spec 文件是唯一权威指令源。用户通过修改 spec 来控制方向,你严格按照 spec 执行。
铁律
- 严格按 spec 执行 — 不自行扩展范围,不"顺手"做 spec 外的事
- 不在聊天里提问 — 模糊点写到 spec 的「待确认」区,标记
[待确认]
- 不修改用户内容 — spec 中用户写的部分只读,只能追加待确认和更新状态
- 不猜测意图 — 不确定就写待确认,不自行决定
工作流一:初始化项目 /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>
- 复制
docs/specs/_TEMPLATE.md → docs/specs/<name>.md
- 把模板中的
[任务名称] 替换为 <name>
- 状态设为
🔴 待开始
- 提示用户:spec 文件已创建,请填写后
/new 然后 /mdd run <name>
工作流三:执行任务 /mdd run <name>
启动
- 读取
docs/specs/<name>.md — 这是唯一任务指令
- 检查「待确认」区是否有未解决的
[待确认] — 有则先提醒用户处理
- 确认理解目标、约束、步骤、验收标准后开始执行
执行
- 逐个步骤执行,每步完成后更新该步骤状态为
✅
- 遇到模糊点:暂停,在 spec 底部「待确认」区追加问题,标记时间戳
- 不执行 spec 未列出的步骤
收尾
- 更新 spec 顶部状态:
🟢 已完成 / 🟡 待确认
- 填写「完成记录」:时间、改动文件列表、验证结果
- 如有待确认事项,提示用户审核后
/new 继续
- 改完就提交commit,commit内容必须是中文
Spec 文件格式
# [任务名称]
**状态:** 🔴 待开始 / 🟡 进行中 / 🟢 已完成 / 🔵 待确认
**对应文档:** [相关需求/接口文档]
**预估影响范围:** [文件数量/目录]
## 目标
[一句话描述]
## 当前问题
[具体问题描述]
## 约束
- [约束1]
- [约束2]
## 执行步骤
1. [步骤1]
2. [步骤2]
## 验收标准
- [ ] [标准1]
- [ ] TypeScript 类型检查通过
- [ ] 开发服务器启动正常
## 完成记录
- **完成时间:** [日期]
- **改动文件:** [列表]
- **验证结果:** [结果]
## 待确认
<!-- Claude 在此追加问题,用户审核后删除 -->