codex-review
Installation
SKILL.md
Codex Review
在 Herdr 中发起一个独立、只读的 Codex reviewer,由调用者核验可定位的审查结论。
Router Rules
- 仅在明确要求 Herdr + Codex 审查,或本技能调用已有该任务上下文时使用。普通正确性审查交给现有 review 流程;可维护性问题沿用
code-quality-review;非 Herdr 的 Codex 协作不要走本技能。 - 若已被分配为 leaf reviewer,直接完成审查,不调用本技能、orchestra 或更多 Agent。讨论/研究这些技能不授权启动进程。
- 通过已加载的
herdr-orchestra名称/实际路径读取其references/delegation.md;它是唯一进程控制 owner。本包不分配 pane、不重复环境探测、不直接启动 Codex。缺少依赖时报告源路径skills/developer-tools-integrations/herdr-orchestra/与未完成项,不绕过 Herdr。 - 核对当前加载的本包身份;同名第三方入口不等于此源。若仍加载含自动 CHANGELOG 的旧入口,报告不匹配,不修改安装、全局配置或 hooks。宿主加载边界见仓库
docs/harnesses.md。
Compact Workflow
- 按 审查契约 明确 cwd、用户标准与一个审查范围,捕获 HEAD/ref、diff 和相关输入内容。当前全部改动默认含 staged、unstaged、untracked;用户指定 staged-only 时保留该边界。
- 准备六字段文本 handoff 与完整 leaf prompt。以 Codex CLI 边界 的交互 root 参数
--sandbox read-only --ask-for-approval never --no-alt-screen请求一个新kind=codexworker;实际执行时核验当前 help。用户指定模型则保留,否则继承配置。 - 交给 orchestra 一次派发与收集。prompt 是任务文本,不是 shell 命令或
/reviewUI 操作;启动失败不得切换到exec review或另一 reviewer。 - 对 receipt 核对身份、目标、生命周期与完整响应。截断时仅由 orchestra 向同一 ready worker 请求缺失的小段;只读 reviewer 不写 temp file、不扩大 sandbox。恢复未完成就保持 incomplete。
- 接受前复核输入与 finding anchors。目标变化则标记 scope drift;完整且范围一致才核验结论。输出已接受发现、被排除的重要误报与不确定性,不自动修复或递归复审。