SuperAPI AI 工具集

sentinel-report

安全与审计

查看项目

更新于 10-23 23:07

技能介绍

CocoSentinel 评估历史报告用于为当前项目生成一份 CocoSentinel 评估历史与审批状态的汇总报告,调用方式为 $sentinel --report。

用途:该技能面向项目中的制品(artifact)评估记录,集中展示各维度评估结论以及审批是否完成,便于开发者了解哪些制品已通过、哪些有条件通过、哪些被阻止,并定位待处理事项。

主要能力:

  1. 前置校验:检查 .cocoplus/ 目录是否存在;若不存在,输出“CocoPlus is not initialized. Run $pod init first.”并停止。
  2. 收集评估结果:读取 .cocoplus/sentinel/ 下所有 JSON 文件(排除 approvals.jsonl 和 active-evaluation.lock),每个文件视为一个维度评估结果;若没有结果,输出“No CocoSentinel evaluations found for this project. Run $sentinel <file> to evaluate an artifact.”并停止。
  3. 收集审批:若 .cocoplus/sentinel/approvals.jsonl 存在,则读取并按 artifact_sha 建立索引。
  4. 生成报告:将每条评估结果与审批记录按 SHA 交叉匹配,输出报告头(项目名与当前日期)、评估总数及 APPROVED / CONDITIONAL / BLOCKED 计数,然后以表格逐项列出制品路径、SHA 前 8 位、结论和审批状态(如 Yes 日期、Yes with rationale、No),并单独列出需要整改的受阻制品(注明失败维度)以及待审批的条件性制品(注明需开发者提供理由的阻断性关注点)。

使用方式:在已初始化的 CocoPlus 项目中执行 $sentinel --report 触发;技能按上述步骤读取本地文件并输出文本报告。

适用场景:项目内已有 CocoSentinel 评估结果,需要快速查看整体审批进度、识别受阻制品、跟踪条件性审批待办时使用。

限制与注意事项:技能明确要求审批必须按 SHA 交叉匹配,否则可能把旧版本制品的审批误认为当前版本已获批;报告中不得省略 CONDITIONAL 制品,因为待审批的条件项往往是最需要处理的内容。退出标准为:报告展示全部评估的结论与审批状态、突出受阻制品、列出等待审批的条件性制品。