CocoSentinel 评估历史报告用于为当前项目生成一份 CocoSentinel 评估历史与审批状态的汇总报告,调用方式为 $sentinel --report。
用途:该技能面向项目中的制品(artifact)评估记录,集中展示各维度评估结论以及审批是否完成,便于开发者了解哪些制品已通过、哪些有条件通过、哪些被阻止,并定位待处理事项。
主要能力:
- 前置校验:检查 .cocoplus/ 目录是否存在;若不存在,输出“CocoPlus is not initialized. Run $pod init first.”并停止。
- 收集评估结果:读取 .cocoplus/sentinel/ 下所有 JSON 文件(排除 approvals.jsonl 和 active-evaluation.lock),每个文件视为一个维度评估结果;若没有结果,输出“No CocoSentinel evaluations found for this project. Run $sentinel <file> to evaluate an artifact.”并停止。
- 收集审批:若 .cocoplus/sentinel/approvals.jsonl 存在,则读取并按 artifact_sha 建立索引。
- 生成报告:将每条评估结果与审批记录按 SHA 交叉匹配,输出报告头(项目名与当前日期)、评估总数及 APPROVED / CONDITIONAL / BLOCKED 计数,然后以表格逐项列出制品路径、SHA 前 8 位、结论和审批状态(如 Yes 日期、Yes with rationale、No),并单独列出需要整改的受阻制品(注明失败维度)以及待审批的条件性制品(注明需开发者提供理由的阻断性关注点)。
使用方式:在已初始化的 CocoPlus 项目中执行 $sentinel --report 触发;技能按上述步骤读取本地文件并输出文本报告。
适用场景:项目内已有 CocoSentinel 评估结果,需要快速查看整体审批进度、识别受阻制品、跟踪条件性审批待办时使用。
限制与注意事项:技能明确要求审批必须按 SHA 交叉匹配,否则可能把旧版本制品的审批误认为当前版本已获批;报告中不得省略 CONDITIONAL 制品,因为待审批的条件项往往是最需要处理的内容。退出标准为:报告展示全部评估的结论与审批状态、突出受阻制品、列出等待审批的条件性制品。