用途
该技能执行 CocoBrew 六阶段流程中的第二阶段(Plan,2/6),目标是把已批准的规格说明(spec.md)转化为可执行、可审查的计划。它强制要求先完成 Spec 阶段,并通过 CocoSpec 质量门禁检查规格质量,再调用 Coco 原生 plan 模式生成计划,最终形成 plan.md 并更新项目元数据。
主要能力
- 前置检查:验证当前目录存在 .cocoplus/,并检查 meta.json 中 phases_completed 包含 "spec";不满足则停止并提示。
- CocoSpec 质量门禁:启动只读的后台 Haiku 子智能体,对 spec.md 和 discuss.md(若存在)按五个维度评分(0-2 分):价值(可验证成功指标)、范围(MVP 与明确排除项)、验收(可测试通过/失败标准)、边界(错误处理、性能、兼容性、安全)、风险(识别与缓解/升级计划)。评分结果写入 lifecycle/spec-score.md。
- 门禁行为:总分≥9 通过,并检查快速模式资格(范围≤3 个文件且无 EHRB 指示);总分 8 需开发者处理低于 2 分的维度;总分≤7 需为每个低于 2 分的维度输出不确定性声明(UNCERTAIN/ASSUMPTION 格式),开发者处理后方可继续。
- 读取规格:完整读取 spec.md,若 discuss.md 存在则提取其中必须遵守的决策(评估方法、准确率阈值、模型选择、仓库分配、生产安全要求等)。
- 调用原生 plan 模式:强制进入 Coco 原生 $plan 模式,分析规格并生成结构化执行计划,等待开发者明确批准。
- 记录计划:生成 plan-YYYYMMDD-NNN 格式的计划 ID,写入 .cocoplus/lifecycle/plan.md(包含日期、阶段、阶段 ID、规格 ID、概述、工作流、依赖、预估时长、所需角色、批准信息)。
- 更新元数据:初始化 .cocoplus/flow.json 模板(stages 为空数组,由 Build 阶段填充),更新 AGENTS.md 和 lifecycle/meta.json。
- Git 提交:提交 plan.md、flow.json、meta.json、AGENTS.md,提交信息为 "feat(plan): approved execution plan v1"。
使用方式
该技能通常由 CocoBrew 流程编排调用。执行前需确保项目已通过 $pod init 初始化并完成 Spec 阶段。技能会引导开发者进入 Coco 原生 plan 模式进行审查和批准,批准后自动完成记录与提交。具体安装命令暂未提供。
适用场景
适用于使用 CocoBrew 流程管理开发项目的团队,特别是在需要将规格说明转化为结构化执行计划、并在编码前进行质量把关和计划审查的场景。
限制
- 必须存在 .cocoplus/ 目录且 Spec 阶段已完成,否则停止。
- 必须调用 Coco 原生 plan 模式并获得开发者明确批准,不可跳过。
- 总分≤7 时必须输出不确定性声明并由开发者处理。
- 该技能只创建空的 flow.json 骨架,不填充具体阶段。
- 依赖 Coco 环境与 Haiku 子智能体,具体模型和平台要求暂未提供。