SuperAPI AI 工具集

codex-review

编程与开发

查看项目

更新于 10-16 09:29

技能介绍

用途:在 Herdr 内发起独立、只读的 Codex 审查,由调用者核验可定位的审查结论,适用于明确要求 Herdr + Codex 审查或已有该任务上下文的场景。普通正确性审查、可维护性审查及非 Herdr 的 Codex 协作均不走本技能;若已被分配为 leaf reviewer,直接完成审查,不再调用本技能、orchestra 或其他 Agent。

主要能力与使用方式:通过已加载的 herdr-orchestra 读取其 references/delegation.md,该文件是唯一进程控制 owner;本包不分配 pane、不重复环境探测、不直接启动 Codex。缺少依赖时报告源路径 skills/developer-tools-integrations/herdr-orchestra/ 与未完成项,不绕过 Herdr。需核对当前加载的本包身份,同名第三方入口不等于此源;若仍加载含自动 CHANGELOG 的旧入口,报告不匹配,不修改安装、全局配置或 hooks。

工作流程:按审查契约明确 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=codex worker,实际执行时核验当前 help;用户指定模型则保留,否则继承配置。交给 orchestra 一次派发与收集;prompt 是任务文本而非 shell 命令或 /review UI 操作;启动失败不得切换到 exec review 或另一 reviewer。

核验与输出:对 receipt 核对身份、目标、生命周期与完整响应;截断时仅由 orchestra 向同一 ready worker 请求缺失小段,只读 reviewer 不写 temp file、不扩大 sandbox;恢复未完成即保持 incomplete。接受前复核输入与 finding anchors,目标变化标记 scope drift,完整且范围一致才核验结论,输出已接受发现、被排除的重要误报与不确定性,不自动修复或递归复审。发现按优先级列出路径/行、触发场景、影响、证据与验证缺口;证据不足归入 uncertainty;无可行动发现须有完整审查依据。将通过、失败、未运行检查与 missing evidence 分开,blocked、timeout、unknown、空响应、缺段与 scope drift 不得写成通过。

限制:仅在调用者已有产物写权限内保存已捕获文本,不把审查授权扩展为修复、CHANGELOG、Git 写操作、安装、trust/config/hooks 变更或资源清理。包内资源以本技能加载时公布的实际目录解析,<skill-dir> 表示该目录,不假定安装目录之间相对位置;行为 fixtures 见 evals,独立词法输入见 trigger cases。创建交接汇总来源、实际检查与未验证边界,这些材料不证明新会话已加载本包。其他如收费、价格、平台等事实资料未提供。