用途:这是 CocoBrew 六阶段流程中的第 5 阶段(评审),用于在发布(Ship)前对项目做一次综合质量与合规审查,并形成需要开发者人工批准的评审报告。
前置校验:执行前需确认当前目录存在 .cocoplus/,否则提示先运行 $pod init 初始化;随后读取 .cocoplus/lifecycle/meta.json,确认 phases_completed 中已包含 test。若未完成 Test 阶段,则提示先运行 $test 并停止。
主要能力(聚合五类来源):
- 代码质量发现:读取匹配 .cocoplus/quality-findings-*.md 的文件,提取 critical 与 high 严重级别的问题。
- CocoCupper 发现:读取 .cocoplus/grove/cupper-findings.md,提取最近 5 条发现。
- 规格符合性检查:对照 .cocoplus/lifecycle/spec.md 中的成功标准与交付物,以及 test.md,逐项检查是否被测试、是否通过、交付物是否存在。
- 测试摘要:从 test.md 提取通过/失败汇总。
- 决策覆盖检查:从 plan.md(及可能存在的 discuss.md)提取关键决策(评估目标、数据来源、准确率阈值、所用模型、仓库分配、生产安全要求等),扫描 SQL 函数、评估配置、flow.json 阶段定义、提示词文件等实现产物,判断决策是否被落实;计划中有而实现中缺失或被违背的记为 Coverage Gap,其严重程度等同于 must-fix,在解决或经书面理由确认前阻止 $ship。
使用方式:技能按上述来源汇总后写入 .cocoplus/lifecycle/review.md,报告含质量发现、智能洞察、规格符合性表、交付物清单、测试摘要、决策覆盖表、决策点、审批状态(初始为 PENDING DEVELOPER APPROVAL)等章节。随后向开发者提问“是否批准并进入 Ship?(yes/no/revise)”:选 yes 则将审批状态更新为 APPROVED 并记录时间戳;选 no 则输出评审被拒、需返工;选 revise 则询问需修订的章节(质量/合规/测试)。仅在批准后,才把 review 加入 meta.json 的 phases_completed、向 AGENTS.md 追加记录(不超过 200 行),并执行 git add 与 git commit(提交信息为 docs(review): quality and compliance review approved)。
限制与约束:开发者必须显式批准,不得在无 critical 发现时自动批准;不得因测试全部通过而跳过规格符合性检查;不得在聚合全部来源前写报告;Coverage Gap 不可当作建议处理,会阻止 Ship。退出条件包括 review.md 含指定章节、决策覆盖表列全 plan.md 与 discuss.md 的关键决策、审批状态为 APPROVED、meta.json 含 review、Git 日志存在对应提交。