用途:codepatrol-report 用于对代码仓库的某一个领域进行安全调查并输出报告。它由 codepatrol skill 启动的 subagent 执行,资料明确说明不假设用户直接调用。
主要能力与流程:先读取主 CHECKLIST.md 与 .dev/codepatrol/checklist.md,按 targets.md 指定路径,以入口→内部逻辑→数据层顺序追踪数据流;对适用观测点逐项记录有无问题及依据,发现问题时定位到文件路径:行号。lifecycle- 开头的领域改用“起点事件×资产”对应表方式调查,并保留在报告中。简单问题写出具体修正内容,需要设计变更的问题标注并建议另行讨论。
必要步骤:调查结果必须通过 codex-consultation 交给 Codex 批判性复审,不能省略或用直接执行 codex exec 代替;按观测点类别分 2〜4 组分别咨询,小领域可合成 1 组。之后按 REPORT-TEMPLATE.md 组装报告;若已有报告则遵循 reinvestigation.md。写入目标由 config.md 决定:Cosense 输出为单页文本并按 cosense skill 写入,失败则落到工作目录;本地输出为 .dev/codepatrol/{领域名}-{YYYY-MM-DD}.md,重名时追加时刻。
限制:调查须在满足 codepatrol 执行环境前提下进行,否则只报告不满足项并结束;不能向用户提问;不切换分支、不 pull、不 commit;不得事先阅读已有报告、问题名清单、修复 PR 或汇总页,以免调查被引导;Codex 因用量上限、花费上限、认证或通信故障而无最终回答时,不输出报告并中断,仅对临时性通信错误可等待数分钟后重试 1〜2 次。与报告责任划分相关的说明见 checklist-vs-report.md,其余机制细节暂未提供。