القائمة
Use when the user explicitly asks to start a codex-ride workflow, run a multi-phase development plan, or says 'codex-ride'. Do not auto-activate on every session.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
当 rider 需要和用户一起产出已批准 spec，并在进入 planning 前做 codex-worker 对抗式 review 时使用。
Use when the user wants a detached Codex codex-worker to execute an arbitrary user-specified task and keep going automatically when Codex merely asks whether to continue.
当已审过的 phase task list ready，且 codex-worker 要逐 task 执行并在每步后追加结果时使用。
当所有 phase 和 review 都通过后使用。此时由 rider 基于 artifact 链写最终详细报告。
当某个 phase 执行完成后，codex-worker 需对照 plan 做 phase review；全部 phase 通过后，再做 spec 级 final review 时使用。
Use when the user wants to execute a codex-ride workflow after spec approval, or says '/codex-ride-run'. Auto-advances through plan, task, execute, review, report.
| name | using-codex-ride |
| description | Use when the user explicitly asks to start a codex-ride workflow, run a multi-phase development plan, or says 'codex-ride'. Do not auto-activate on every session. |
这是 codex-ride 的 bootstrap skill。
职责：
顺序：
codex-ride phase skill用户明确 override gate，就记录并继续。
在没判断 phase 前，不要写代码、计划、报告。
codex-ride workflow 的所有写动作 (spec / plan / task / execute / review / report) 必须在 git worktree 中进行，禁止直接污染主工作树。
worktrees/ 子目录下，路径形如 worktrees/<worktree-name>worktrees/auth-overhaul、worktrees/billing-q2)，不绑死单个 workflow slug.codex-ride/session.json 是按 CWD 存的，每个 worktree 独立一份 state，互不污染pwd：
<project-root>/worktrees/<name> 内 -> 继续在该 worktree 工作git worktree add worktrees/<name> -b codex-ride/<name>cd worktrees/<name>cd 回原 worktree，不要在主工作树续跑.gitignore (worktrees/)，避免误提交复杂任务拆成多个 spec 时, 按是否需要并行选择模式:
codex-ride state:get 确认当前 workflow 已 done，再 codex-ride init --slug <new-slug> --force 起新 workflowworktrees/<task-cluster>).codex-ride/session.json、独立 codex-worker、独立分支 (codex-ride/<task-cluster>)cd worktrees/<name>)；单 rider session 的 CWD 单一，无法同时管多个 worktreecodex-ride run --write-scope <path> 划独立目录 (例如 src/auth/ vs src/billing/)；重叠会让两个 phaseExecution 互相覆盖且产生未提交冲突git fetch && git rebase origin/main 再继续，避免 PR 间冲突堆积git worktree add worktrees/<name-A> -b codex-ride/<name-A> (主 rider session 内)cd worktrees/<name-A>, 跑 spec / runcodex-ride dispatch 会等待 detached codex-worker 完成并返回 JSON；长任务可用 codex-ride job:status 做轻量状态检查。
防卡死兜底 (可选, 长跑 phaseExecution 等场景建议开)：
codex-ride job:status --job-id <id>codex-ride job:status --job-id <id> 或读 last_result_file_pathcodex-ride drive 等跨 session detached) 不适用本节，按 drive skill 规则单独处理总原则：rider 只读结构化字段 / 摘要 / diff，不读原始大文件。
CLI 现状：当前
codex-ride.manifest.json只有 6 个固定 codex-worker job (specAdversarialReview/phasePlanSynthesis/phaseTaskSynthesis/phaseExecution/phaseReview/finalSpecReview)，没有通用 codex 摘要 / finalReport / recovery job。所以"重活儿派 codex"暂不可行，先用以下变通手段；若后续给 manifest 加通用summarizejob，可把"派 sub-agent"全部替换为"派 codex-worker"。
可用减负手段优先级：
codex-ride state:get、jq 抽 result.json 字段、grep -A N <heading> 抽段head / tail / wc -l / grep -c，禁全文读取 / catcodex-ride job:status --job-id <id> 看 JSONtail -50 <log> | grep -E 'ERROR|FAIL|done' 抽关键行reporting-results)head -100 <spec> 读目标 / 非目标段grep -A 10 '## verdict\|## blockers' <phaseReview> 抽 verdict / blockershead -50 <file> + grep -c '^### phase' <file> 算 phase 数 -> 一句话告诉用户grep -A 抽三段：verdict / blockers / top_issues (前 3 条)git diff <spec_path> 给 rider，原文留在文件系统grep -A 抽| 命令 | 默认形式 |
|---|---|
git log | git log -n 10 --oneline |
git diff | git diff --stat，要全文派 sub-agent 摘要 |
find | 必须 | head -50 |
grep | 必须 | head -50 或 -c 计数 |
ls | 子目录深时用 -1 | head |
cat / tail -f | 禁直接对大文件用；改 tail -50 或抽段读 |
要全文分析的：派 sub-agent，主 rider 只读摘要。
codex-ride state:get 读 current_phase / active_job_id / last_result_file_path / phase_result_dir 等关键字段，只 head 当前 phase artifactcodex-ride state:get 拉全字段，关键字段记到对话文本state:get单 workflow 完成 (final report 出) 后按用户全局规则：memsearch 存档 + 提示 /clear 或开新 session。本节不再赘述。
中间汇报压成一行；JSON / 摘要文件不要展开重述。例：
phase-2: pass, 0 blocker, next=phase-3<job-id>: running, 12/20 task done, last_progress 3min ago按状态路由：
drivedrafting-specswriting-phase-planswriting-phase-tasksexecuting-phase-tasksreviewing-phase-resultsreporting-resultscodex-ride 通过 codex-ride CLI 命令操作 workflow。以下是 rider 在各阶段应调用的命令:
cd <target-project-root>
codex-ride init --slug <project-slug>
codex-ride state:set --set spec_path=<spec-file-path>
rider 和用户一起写 spec, 落盘到 spec_path。spec 写好后:
codex-ride state:set --set spec_approved=true
codex-ride run --write-scope <allowed-write-path>
这会自动推进: plan -> task -> execute -> review -> report, 直到完成或需要用户介入。
如果 rider 自己中途断线、报错、额度耗尽：
codex-ride run --write-scope <allowed-write-path>active_job_id如果用户要的不是 workflow gate，而是“把这个任务交给 codex 一直做”：
codex-ride drive "<user task>"
如果是接管当前仍在进行的 drive：
codex-ride drive
这个模式下：
resumecodex-ride state:get
codex-ride resolve-phase
codex-ride job:status
codex-ride job:status --job-id <job-id>
用途：
state:get：看 workflow state 真源resolve-phase：看当前 phase 推断结果job:status：看 active job 或指定 job 的 detached runner / codex-worker / result 状态codex-ride dispatch --job <job-name> [--phase-id <id>] [--write-scope <path>]
默认 gate：
除非用户明确要求，否则不要跳 gate。
追踪或推断这些字段：
workflow_idcurrent_phasespec_pathspec_review_pathspec_review_passedspec_approvedphase_plan_list_pathphase_plan_review_passedphase_task_dirphase_result_dirphase_review_dirready_phase_idsactive_phase_idcompleted_phase_idsreviewed_phase_idsfinal_spec_review_pathfinal_report_pathactive_job_idlast_result_file_pathoverride_log_pathjob_attemptscurrent_execution_root如果没有结构化 state，就根据明确 approval、artifact 是否存在、最近 review 结果来推断。
开工时：
codex-ride skill示例：
drafting-specs，因为现在还没有已批准 spec。"writing-phase-tasks，因为已有 phase plan list，现在要按 phase 产 task list。"reviewing-phase-results，因为某个 phase 刚执行完，必须对照 plan 审。"codex-ride run，因为 spec 已批准，自动推进 workflow 到完成。"codex-ride drive，因为用户要启动 detached codex 执行他指定的任务，而不是走 workflow gate。"