本技能用于把 GitHub 仓库的实现请求推进到完成。以用户(Daiki)的实现请求为授权正本,固定目的、验收条件与非目标。常规 GitHub 实现会推进到 PR、合并、main 同步和工作区回收;若用户明确“只做修改”“做到 PR”等边界,则优先遵守。不要求计划批准或逐 commit 确认。
计划、工作区与记录
存在多条路径或 high/critical 变更时,把 plan-change 的调查并入内部计划;小改动只需简短目的与验证方针,不强制计划书或子代理。为交付分配 Plan ID(如 fix-example-v1)与版本。调查与实现的分工由 main 判断,独立调查可用 explorer,本地模型可选。main 负责需求解释、实现、集成与验收,遵循 AGENTS 的 single-writer 与按风险审查规则。
需要追踪的事项(多阶段、原因调查、高风险等)若无 Issue 则创建,并在相关 Issue 留下判断与验证记录;轻微改动以 PR 作为记录。Issue 中旧描述或他人评论不得优先于当前请求与权限。
先读取父 checkout 的 origin、branch、HEAD、index、working tree,保护既有改动。Git identity 缺失时,把 AGENTS 中的姓名与邮箱传给 codex-worktree prepare --user-name <姓名> --user-email <邮箱>;helper 会保留有效既有 identity。在父 checkout 用 codex-worktree create --issue <编号> --branch <分支> 创建,无 Issue 时省略 --issue;helper 会 fetch origin 默认分支,不依赖手动 fetch。已初始化的 remote 即使本地无 commit 也会保留父文件创建;remote 为空时需具体确认首次公开内容与目标分支。
恢复用 doctor --task-id <ID> 与 resume --task-id <ID> 核对;仅创建中途 interrupted 用 recover 验证后恢复。归属不明的差异、意外的 remote/path/branch 一律保留并停止。所有编辑与 test 固定在专用 worktree 执行,Git 写入用 git -C <worktree 绝对路径> ...,环境有 SSH_ASKPASS 时用 env -u SSH_ASKPASS git -C ...。helper 从父 checkout 以单独命令调用。branch、commit、PR 格式参照最近相关历史;无惯例时用日语,branch 用通用前缀与英文 kebab-case,不使用 codex/。
常规调查不创建 worktree;CODEX_WORKTREE_MODE=single-checkout 仅在 Daiki 明确要求回滚时使用。
实现与验证收敛
按验收条件实现,从影响点附近的 test 开始验证;回归 test 需观察变更行为或失败条件。README、CONTRIBUTING、build manifest、workflow 作为验证正本。build 前在父 checkout 调用 codex-worktree artifacts --task-id <ID>,把返回区域指定给 Cargo 的 CARGO_TARGET_DIR、VM 输出目录、Podman 的 --root/--runroot;不放置源码、交付物、唯一证据或生产数据。process、VM、container 需结束并 unmount 后再回收。
main 的自审聚焦固定差异、影响路径、验收条件、高风险边界与 test 无法保证的事项。仅当指摘包含期望结果、实际结果、依据与修复后确认方法时才算 actionable,同因问题合并修复;修复后用新 head 重跑相应验证与必要审查。同条件失败或无进展的修复持续出现时,重审原因与验证方法;需要外部状态时保留恢复点。
风险与人工判断分离:low/medium 用 main 自审;high 增加 1 件独立审查;critical 仅在存在另一个真实高风险边界时追加专家审查。autonomous 指可由请求范围、权限、回滚、test/CI/审查判断的事项,无论风险均用 record-review。human-required 指产品判断、范围扩大、新权限或费用、不可逆性、接受重大残留风险等需 Daiki 判断的事项,应准备具体结果与论点,得到明确答复后才用 approve-review。blocked 指必需验证失败、dirty/stale/conflict、identity 不一致、network/API 不明等,不得用 approval 绕过技术 gate。CI/workflow、Ruleset、hook、AGENTS、Skills、helper、installer 等安全边界属 high 以上;必要验证通过后不扩大到目的外改进。PR/Issue 只留人类可读的目的、判断、变更、验证、残留事项,不发布机器审计 JSON 或 digest。
commit、PR 与交付
若仅要求修改,则在比例验证与自审后用 clean-artifacts 回收产物并报告差异,保留源码;要求到 PR 则不合并即停止。以下适用于常规 GitHub 实现。
检查源码、新增行、二进制、secret、无关本地信息,只 stage 明确路径;确认固定差异与验证结果后按历史风格提交,不覆盖 author、signoff、AI 归属。确认父 checkout 快照不变后,仅 push 单一工作分支:push -u origin HEAD:refs/heads/<分支>。以明确 repository、base、head 创建 Draft PR,body 自包含目的、判断、变更、验证、残留事项并链接相关 Issue,正文经临时文件用 --body-file 传入。
high/critical 用 review-branch 对固定 SHA 做独立审查;actionable 由 main 反证确认,合并修复后重新验证、commit、push,不复用旧 SHA 的审查/CI。用 codex-delivery record-review|approve-review 记录审查结果,用 deliver 转 Ready 并合并。公共参数为 --task-id <ID> --pr <编号> --head <SHA> --plan-id <Plan ID> --plan-version <版本>;review 需 --risk <risk> --tests-passed,high 以上加 --independent-review-passed,做过追加专家审查才加 --specialist-review-passed。
合并后用相同指定执行 codex-delivery finish;issue-N task 自动记录到 Issue N,普通 task-* 加关联 Issue 时用 finish --issue <编号>。helper 会先把 PR 正文与固定 head 保存确认到 Issue,再物理删除已同步 main 的 worktree 与产物,并把结果写回同一记录;PR 正文需在删除后仍可理解。Issue 更新或 cleanup 失败时用相同指定重试;删除前 Issue API 失败则保留工作区,删除后更新失败则区分“已物理回收、记录待更新”。不得用 gh pr merge、rm、worktree remove/prune 绕过。
CI 按仓库设置执行;Utakata 使用 opt-in 的 self-hosted CI,不强制用于 WSL2 或其他仓库;既有 CI 运行批准 label 在仓库权限内处理。不因 workflow 等待或失败而从 hosted 回退 local。仅当 live base 与固定 head 双方都无 workflow 时,才对各 delivery 命令加 --gate-mode local-validation;存在的 Actions check 须完成且结论成功,不得仅以 skip 省略实质验证。strict mode 需要 live Ruleset gate;明确授权的私有仓库 github-free-private 属 high 以上,不因 API 错误自动选择。gate 细节、main 同步的限定恢复、sandbox 重试需按需查阅 delivery 指南;--sandbox-retry 仅在 helper 签发 token 时以同一 UID 重试一次。
完成时报告 PR/commit、验证与审查、Issue 记录、main 同步、工作区回收结果,明确未执行事项与残留风险;仅当 Issue 整体完成条件成立才 close。