工作量拆分-Cosmic

COSMIC 工作量拆分工作流

基于 COSMIC 标准，将需求文档拆解为功能点与子过程明细。通过多步骤工作流（工作区准备 → 功能点摸底 → 用户确认 → 执行拆解 → CSV 导出）完成自动化拆分。

何时调用 用户要求根据需求文档进行 COSMIC 工作量拆分 用户要求进行功能点分析或 CFP 度量 用户提到 COSMIC 拆分、COSMIC 功能点等关键词 前置条件 用户提供需求文档路径（支持 .md 或 .docx 格式） 项目根目录下存在 结果s/ 文件夹 工作流概览

本工作流包含 5 个步骤，通过 TodoWrite 工具追踪进度：

工作区准备 — 创建产出文件夹、转换文档格式（Task 子代理） 模块与功能点摸底 — 梳理功能点清单（Task 子代理） 摸底结果确认 — 与用户沟通确认功能点清单（主 技能 处理） 执行 COSMIC 拆解 — 将功能点拆解为子过程描述（Task 子代理） 拆解结果审阅与 CSV 导出 — 用户审阅、生成最终 CSV（主 技能 处理） 启动流程 第一步：接收需求文档

从用户消息中获取需求文档的路径。如果用户未提供路径，询问用户提供需求文档。

第二步：确定产出路径

根据需求文档文件名（去掉后缀）确定产出路径：结果s/<需求文档名>/

例如：需求文档为 docs/ID-E004-客户管理需求.md，则产出路径为 结果s/ID-E004-客户管理需求/

第三步：推断当前工作进度

检查产出路径下的文件来推断当前处于哪个步骤：

文件状态 推断结论 进入步骤 产出文件夹不存在 全新工作 步骤 1 文件夹存在，无 需求摸底说明与拆分计划.md 工作区已准备，摸底未开始 步骤 2 需求摸底说明与拆分计划.md 存在，所有功能点均为 [ ]（无 [x]） 摸底已完成，待用户确认 步骤 3 需求摸底说明与拆分计划.md 存在，部分为 [x]、部分为 [ ] 拆解进行中 步骤 4 所有功能点为 [x] 且 拆解明细.md 存在 拆解完成 步骤 5 第四步：生成 Todo 清单

使用 TodoWrite 工具生成待办事项，根据推断的进度设置各步骤状态：

id: cosmic-step-1, content: "工作区准备（创建文件夹、转换文档格式）" id: cosmic-step-2, content: "模块与功能点摸底（梳理功能点清单）" id: cosmic-step-3, content: "摸底结果确认（与用户沟通，确认功能点清单）" id: cosmic-step-4, content: "执行 COSMIC 拆解（将功能点拆解为子过程描述）" id: cosmic-step-5, content: "拆解结果审阅与 CSV 导出"

已完成的步骤标记为 completed，当前步骤标记为 in_进度，后续步骤标记为 pending。

第五步：告知用户当前进度

向用户报告推断的进度状态，例如：

全新工作："检测到这是一份新的需求文档，将从头开始 COSMIC 拆分工作。" 续接工作："检测到上次工作已进行到【功能点摸底】阶段，将从该步骤继续。"

然后按照对应步骤开始执行。

路径约定

本 技能 中所有相对路径均相对于 技能.md 所在目录解析。例如 prompts/xxx.md 即与本文件同目录下的 prompts/xxx.md。执行 Shell 命令时，需将相对路径拼接为绝对路径后使用。

文件访问链接格式

当主 技能 向用户汇报已生成或已更新的产出文件时，除了说明文件名称和用途，还必须在 AI 回复中提供可点击的文件访问超链接。

规则如下：

链接只出现在 AI 回复里，不要写入产出文件正文。 链接格式优先使用 Markdown 链接 + file:/// 绝对路径 URI。 Windows 本地路径转链接时，将反斜杠 \ 统一替换为正斜杠 /，例如：

• 需求摸底说明与拆分计划
• 拆解明细
• 拆解明细 CSV

如果平台对本地文件链接支持有限，仍应优先输出上述链接格式，必要时可同时附上绝对路径文本作为兜底。 子代理调度方式

重要：本工作流通过 Task 工具调度子代理，提示词模板存放在 prompts/ 目录下。调度步骤：

使用 Read 工具读取对应的提示词模板文件 在提示词前面拼接本次任务的具体参数（文件路径、运行模式等） 通过 Task 工具（sub代理_type: generalPurpose）发起子代理执行 硬性执行约束

以下约束是强制要求，优先级高于"主 代理 自己把事情做完"的一般倾向：

步骤 1、步骤 2、步骤 4 必须通过 Task 工具执行。 主 代理 不得直接完成这些步骤的正文工作。 主 代理 在步骤 1、步骤 2、步骤 4 中，只允许做以下事情： 推断当前工作进度 读取提示词模板 拼接运行参数 发起 Task 接收子代理结果 更新 TodoWrite 状态 向用户同步进度或请求确认 主 代理 在步骤 1、步骤 2、步骤 4 中，禁止做以下事情： 直接读取需求正文后自行进行功能点摸底 直接创建或修改 需求摸底说明与拆分计划.md 直接创建或修改 拆解明细.md 直接执行本应由子代理完成的文档复制、功能点识别、COSMIC 拆解工作 把 prompts/*.md 中的内容当作主 技能 的执行正文直接照做 如果 Task 没有成功发起，或者子代理返回失败 / 阻塞，主 代理 必须停止降级执行。 此时只能： 向用户说明当前卡在哪一步 报告已尝试的 Task 调度 请求用户确认是否重试或调整策略 如果你发现自己已经开始"准备直接做步骤 1 / 2 / 4 的业务内容"，说明你偏离了本 技能 的约束，必须立刻停止并改为先发起 Task。 Task 调度标准模板

在步骤 1、步骤 2、步骤 4 中，统一使用下面的调度顺序：

Read 对应的提示词模板文件 组装 Task prompt，格式如下： 【本次运行参数】

• 参数 1：...
• 参数 2：...

【执行要求】

• 你必须在本次子代理上下文中完成任务
• 完成后返回产出文件路径、执行结果、是否存在阻塞

【提示词模板正文】