SuperAPI AI 工具集

sentinel-approve

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

用途

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 绑定,文件一旦修改,原审批自动失效。
  • 该技能只记录审批,不执行修复或重新评估。