codepatrol 用于按领域对代码仓库进行安全调查，并能把构成同一服务的多个仓库捆绑在同一套配置与 hub 页面下调查。当前 session 充当指挥角色，负责与用户对话、确定调查领域、把工作交给子代理并核对记录，指挥角色本身不读被调查代码，其行为准则参照 kuden:orchestrator skill。
主要能力由一组 skill 构成：codepatrol-setup 生成或更新调查对象列表与观察点列表；codepatrol-report 调查一个领域并输出报告；codepatrol-triage 对报告问题分类并生成 triage 页面；codepatrol-sync-state 把修复用 pull request 的状态同步到页面；codepatrol-autofix 修复单个问题并完成 pull request；codepatrol-autofix-deploynote 把部署前后人工要做的事整理为 release pull request 的评论。子代理需指定 Opus 及以上 tier 的模型。
使用前需满足运行环境条件：自身模型为 Opus 及以上 tier；已安装 Codex CLI（用 command -v codex 确认）；Codex 模型为 Sol 及以上 flagship 且 reasoning effort 在 medium 以上。仅做 triage 与状态同步时可跳过后两项确认。codex exec 只在确认时直接执行，向 Codex 咨询需由子代理通过 codex-consultation skill 完成，且不可用其他方式替代。
调查在检出调查用 branch 的 git worktree 中进行，从最新 default branch 切出，期间不切换 branch、不修改文件；相关仓库只读。配置文件位于 .dev/codepatrol/，包含 config.md、checklist.md、targets.md，报告可按配置写入 Cosense 或本地 .dev/codepatrol/{领域名}-{YYYY-MM-DD}.md（本地写入需 cosense CLI 时使用 npm install -g @helpfeel/cosense-cli）。并行调查原则上不超过 3 组，读文件不重叠的领域才并行。输出完成的报告不得删除，push 与创建 pull request 需等待用户指示。
适用场景：多仓库服务的安全审查、按领域生成与维护安全报告、问题 triage、自动修复与修复 PR 状态同步。限制：依赖 Opus 级模型与 Codex CLI 环境；client 类仓库需手动添加领域并在仓库固有层补充观察点；triage 与状态同步仅在报告写入 Cosense 时可用；相关资料未提供具体定价、许可、平台支持范围与效果数据。