用途
sentinel-approve 是 CocoPlus 项目中 CocoSentinel 质量评估流程的审批环节,用于为已经过 CocoSentinel 评估的文件(artifact)记录一份与内容 SHA 绑定的正式批准。它不负责评估本身,只负责在评估结果基础上完成审批留痕,使审批可追溯、可审计。
主要能力
- 校验当前目录是否已初始化 CocoPlus(存在 .cocoplus/),未初始化则提示运行 $pod init 后停止。
- 读取待审批文件,计算其内容的 SHA-256,并查找 .cocoplus/sentinel/<sha>.json 中对应的评估结果;若不存在则提示先运行 $sentinel <file>。
- 根据评估结果中的 outcome 字段决定审批路径:
- APPROVED:无需理由,直接进入记录步骤。
- CONDITIONAL:列出所有 BLOCKING 级别的关注项,要求开发者提供非空且实质性的书面理由(至少 20 个词),否则要求补充。
- BLOCKED:拒绝审批,提示先解决 FAIL 发现并重新运行评估。
- 将审批记录追加写入 .cocoplus/sentinel/approvals.jsonl,字段包括 artifact_path、artifact_sha、approved_at(ISO8601 时间戳)、outcome 和 conditional_rationale。
- 输出确认信息,包含文件路径、SHA、结果与审批时间,并提示审批与 SHA 绑定,文件修改后审批将自动失效并在下次会话开始时通知。
使用方式
开发者通过 $sentinel --approve [file] 调用;若未提供文件路径,技能会询问要审批的文件。随后技能按上述步骤自动校验、查找评估结果并引导完成审批。
适用场景
适用于已在 CocoPlus 项目中运行过 CocoSentinel 评估、需要正式记录审批结论的开发流程,尤其是需要为带条件通过的产物留下可审计理由的场景。
限制
- 必须先存在对应 SHA 的评估结果,不能跳过评估直接审批。
- BLOCKED 状态的产物无法审批。
- CONDITIONAL 审批必须提供实质性书面理由,空理由或过短理由不被接受。
- 审批与文件内容 SHA 绑定,文件一旦修改,原审批自动失效。
- 该技能只记录审批,不执行修复或重新评估。