用 /plan,而且完美适配你要的Kiro式完整文档流水线
一、/plan 核心优势(刚好匹配你的需求)
- 强制先出方案、不直接写文件,必须你确认后才落地文档,和Kiro“大任务分步审批”逻辑完全一致
- 天然支持分阶段:需求→设计→任务拆解,自带风险评估、依赖梳理
- CMD/VSCode终端直接输入斜杠命令,无需切换快捷键,一键进入规划模式
- 配合根目录
.claude.md规则,能强制输出图文Mermaid图表+三套完整文档
二、CMD终端完整可用指令(直接复制)
标准启动模板(三合一:/plan + 文档约束 + 图文强制)
/plan 开发一套客户工单管理后台,支持工单提交、分配、处理、统计、权限管理
严格遵循项目根目录.claude.md全局规则,完整执行三阶段交付:
1. 第一阶段:生成PRD需求文档 docs/01_需求文档/PRD.md,附带业务流程图mermaid,保存图表到docs/images,图文嵌入文档;完成后等待我确认【PRD通过】再进入下一阶段
2. 第二阶段:生成系统设计文档 docs/02_系统设计文档/design.md,包含架构图、数据库ER图、接口时序图,全部独立存mmd图片;等待我确认【设计通过】
3. 第三阶段:生成开发任务清单 docs/03_开发任务分解文档/task_list.md,分前后端/测试/部署任务,附带任务依赖拓扑图;
全程禁止跳过阶段、禁止一次性生成全部文件,所有图表必须落地到images目录,文档内使用相对路径引用,所有内容使用标准Markdown表格+图文结合
极简短版(重复使用推荐)
/plan 【替换你的业务需求】
按三阶段输出PRD、设计文档、任务清单,全部图文并茂生成Mermaid图表存docs/images,每阶段等我确认再推进
三、/plan 完整执行流程(CMD里和Kiro行为对齐)
- 输入
/plan + 需求
CC进入Plan只读模式,只输出整体执行路线,不会创建任何文件夹/文档,先给你总方案预览:目录结构、三份文档大纲、所有图表清单、风险点、执行顺序。 - 你审阅总规划,没问题回复:
确认规划,开始执行第一阶段PRD - CC自动创建docs全套目录、生成PRD.md、导出业务流程图到images,终端提示等待你审核
- 你回复
PRD确认通过 → 自动进入设计文档阶段,输出架构/ER/时序图 - 你回复
设计文档确认通过 → 输出任务分解文档+任务依赖图 - 全部完成后生成汇总交付文档,闭环整个大任务
四、/plan 和直接发Prompt的关键区别
| 方式 | 审批机制 | 文件操作 | 适配Kiro大任务 |
|---|
/plan | 双层确认:先审整体规划 → 再分阶段逐份文档确认 | 规划阶段只读,确认后才写文件,安全不脏仓库 | ✅ 高度匹配,分段可控 |
| 普通文字Prompt | 无强制前置规划,容易直接一次性生成全部文档 | 直接读写文件,无法提前预览整体方案 | ❌ 容易跳过审核步骤 |
五、避坑关键点(用/plan必加)
- 必须提前执行
init_docs.bat初始化文档目录,或在指令里加上:不存在docs目录则自动创建全套文件夹 .claude.md不能少,里面固化文档规范、图文要求、分段确认规则,不用每次重复写约束/plan模式下CC不会自动执行文件写入,一定要明确发送确认指令才会落地md和图表- 强制图文:指令里必须写明「所有流程/架构/数据表都生成独立mermaid文件存入docs/images,文档内嵌入图表代码块」
六、一键可复制 .claude.md 配套规则(配合/plan使用)
# /plan规划模式专用全局交付规范
1. 接收/plan任务后,分三阶段串行交付,无用户确认不得进入下一阶段
阶段1:PRD产品需求文档 ./docs/01_需求文档/PRD.md
阶段2:系统设计文档 ./docs/02_系统设计文档/design.md
阶段3:任务分解清单 ./docs/03_开发任务分解文档/task_list.md
2. 图文硬性要求:
所有流程图、架构、ER、时序、任务依赖图均生成独立mermaid文件保存至 ./docs/images/,文档内用相对路径嵌入渲染代码
3. 文档统一结构:版本记录、业务背景、功能范围、约束、风险、验收标准、配套图表
4. 交互规则:每完成一份文档,终端输出提示语等待用户关键词确认:
PRD完成 → 等待【PRD确认通过】
设计完成 → 等待【设计文档确认通过】
5. 全部文档生成完毕后,输出 ./docs/项目交付汇总.md 汇总全部文件与图表清单