CMD 中 Claude Code（CC）实现 Kiro 式全流程项目交付（需求→设计→任务文档+图文）

一、前置环境准备

1. 工具依赖

1. VSCode + Claude Code 插件（CMD 终端依托 VSCode 内置 cmd，纯独立 cmd 无 CC，必须在 VSCode 打开终端 cmd）
2. 项目根目录新建固定文件夹结构（自动承载图文、各类文档）

./docs/
  ├─01_需求文档/
  ├─02_系统设计文档/
  ├─03_开发任务分解文档/
  └─images/  # 存放流程图、架构图、原型截图（图文配图目录）

3. 基础配置：在项目根新建 .claude.md 全局规则文件，固定输出规范，对齐 Kiro 大任务模式

2. .claude.md 全局指令（核心，让CC统一输出格式、强制图文）

# 全局项目交付规则（模仿Kiro大任务流水线）
1. 接收【大任务总需求】后，严格分三阶段串行输出，禁止打乱顺序：
   阶段1：PRD产品需求文档 docs/01_需求文档/PRD.md
   阶段2：系统设计文档 docs/02_系统设计文档/design.md
   阶段3：任务拆解文档 docs/03_开发任务分解文档/task_list.md
2. 图文强制要求：
   - 所有架构、流程、业务逻辑必须生成Mermaid流程图/架构图，保存为docs/images/*.mmd，同时在文档内嵌入渲染代码块
   - 涉及页面、数据表、交互，补充文字描述配套示意图说明
   - 所有图片资源统一存放 ./docs/images/，文档内使用相对路径引用
3. 文档统一标准：
   - 每个文档包含：版本、修改记录、业务背景、目标、范围、约束、风险
   - 设计文档：架构分层、数据库表、接口定义、部署方案、异常处理
   - 任务文档：拆分子任务、负责人、工期、依赖、验收标准、测试要点
4. 交付流程：
   第一步：确认总需求，输出PRD；等我确认PRD无误再进入设计；设计确认后输出任务清单
5. 输出格式：全部使用标准Markdown，分层标题清晰，表格齐全
6. 交互模式：全程像Kiro大任务模式，分步询问确认，不一次性输出全部内容

二、CMD（VSCode内置CMD终端）启动大任务完整流程

步骤1：CMD进入项目目录，唤起Claude Code交互

1. 打开VSCode，顶部终端新建 CMD 窗口
2. cd 到你的项目根目录

cd D:\workspace\demo-project
code .

3. 调出 Claude Code 对话面板快捷键 Ctrl+Shift+P → 输入 Claude Code: Start Chat，终端绑定对话上下文

步骤2：输入标准化大任务启动Prompt（复制直接用，一键开启全流程）

# 启动Kiro同款全流程大任务流水线
严格遵循根目录.claude.md规则完成完整项目交付，分步执行，每完成一份文档先等待我审核确认，再执行下一阶段，全程图文并茂，Mermaid图表全部存到docs/images目录。

本次大任务：【这里替换你的完整业务需求，例如：开发一套客户工单管理后台，支持工单提交、分配、处理、统计、权限管理】

执行流程约束：
1. 第一阶段：生成完整PRD需求文档，存放docs/01_需求文档/PRD.md，包含业务流程图（mermaid）、功能清单、用户角色、原型说明图
2. 我回复【PRD确认通过】后，进入第二阶段：系统设计文档design.md，包含整体架构图、数据库ER图、接口流程图、部署架构图，全部配图
3. 我回复【设计文档确认通过】后，第三阶段输出任务分解文档task_list.md，分前端/后端/测试/部署子任务，带任务依赖、工期、验收标准
4. 所有图表文件单独输出保存至docs/images，所有md文档内部嵌入图表代码实现图文展示
5. 文档全部生成完成后，汇总一份总交付说明文档docs/项目交付汇总.md

步骤3：CC 分步执行完整流程（模仿Kiro分段确认机制）

阶段1：输出需求文档 PRD（带图文）

CC会自动创建文件夹、生成PRD.md，同时生成 docs/images/business_flow.mmd 业务流程图
文档内部嵌入示例：

CMD终端会提示：需求文档已生成，请审阅，回复【PRD确认通过】进入下一阶段

阶段2：确认PRD后，生成系统设计文档

输入 PRD确认通过，CC自动生成：

• 架构分层图 images/arch.mmd
• 数据库ER图 images/db_er.mmd
• 接口调用时序图 images/api_seq.mmd
  设计文档包含技术选型、表结构、接口字段、缓存、异常、部署方案，图文穿插

终端提示：设计文档完成，请审阅，回复【设计文档确认通过】生成任务清单

阶段3：确认设计，输出完整任务分解文档

输入 设计文档确认通过，CC拆分颗粒度任务，用表格排版，配套任务依赖流程图，形成可直接排期的开发清单。

阶段4：全部文档汇总打包

三份文档+所有图表生成完毕后，自动输出交付汇总文档，列出所有文件路径、图表清单，完成整套大任务闭环。

三、CMD 快捷优化命令（简化重复操作）

1. cmd 一键初始化文档目录脚本

新建 init_docs.bat 放在项目根，cmd双击执行自动创建全套目录：

@echo off
md docs\01_需求文档
md docs\02_系统设计文档
md docs\03_开发任务分解文档
md docs\images
echo 文档目录初始化完成
pause

CMD执行：init_docs.bat 一键建好文件夹，不用手动创建

2. 快速唤起CC大任务的快捷片段

在cmd中可以直接复制简化指令，无需每次粘贴长prompt：

加载.claude.md全局规则，启动完整三阶段项目交付大任务，图文并茂，分阶段等待我确认再推进，当前需求：XXX

四、实现「图文并茂」核心关键点（CC必须遵守）

1. Mermaid 图本地化存储
   Kiro会自动生成图表，Claude Code通过指令强制将mmd图表单独落地到docs/images，文档内引用代码块，本地安装Mermaid插件即可VSCode直接看图，实现图文共存。
2. 图片路径统一规范
   所有md文档使用相对路径 ![流程图](./images/xxx.mmd)，统一管理配图，不会出现图片丢失。
3. 强制配图场景，避免纯文字
   • PRD：业务流程、用户角色图
   • 设计文档：架构、ER、时序、部署图
   • 任务文档：任务依赖拓扑图

五、和 Kiro 的行为对齐要点

功能点	Kiro 大任务模式	CMD Claude Code 配置实现方案
大任务分阶段串行	分步交付，人工确认再下一阶段	.claude.md 强制分段+关键词确认触发下一流程
自动生成全套三类文档	PRD/设计/任务清单	固定目录结构，指定文件输出路径
图文自动配套	内置图表嵌入文档	强制Mermaid绘图，独立保存图片目录
完整项目闭环交付	汇总交付包	最后生成汇总清单文档
终端命令驱动	内置命令	CMD批处理脚本+标准化对话Prompt

六、常见问题修复

1. CC不自动创建文件夹
   解决：先在cmd运行 init_docs.bat 手动初始化目录，再启动任务
2. 不生成Mermaid图片
   解决：在prompt追加一句：所有逻辑必须输出独立mmd图表文件，不允许仅文字描述流程
3. 跳过确认直接输出全部文档
   解决：检查.claude.md是否存在，必须开启分段确认规则，缺失则重新写入规则文件

七、完整实操示例（复制即用整套流程）

1. CMD进入项目，执行 init_docs.bat
2. 创建/覆盖 .claude.md 粘贴上方全局规则
3. VSCode CMD打开Claude Code对话，粘贴大任务启动Prompt，替换自己的业务需求
4. 等待CC生成PRD，审核后发送确认指令，依次走完设计、任务文档，整套图文全套文档自动落地到本地目录。