// Story Orchestra として 1 つの story を最後まで運ぶときに使う共通 skill。story pick → story branch 作成 → task 分解・委託 → Pre-Final の E2E シナリオ設計 → final review → final PR → 人間 handoff まで扱う。default は codex が担当し、escalation 条件を超えるときだけ claude-code が担当する。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | story-orchestrate |
| description | Use when codex carries a ready type:story through story branch setup, task delegation, task PR aggregation, Pre-Final E2E scenario design, final review, final PR, and human handoff. Use story-breakdown before this when tasks are not implementation-ready. |
採用された 1 story を持ちきる Orchestra の手順。root AGENTS.md / CLAUDE.md には概要だけを置き、Story-level branch、Pre-Final review、Final review、hotfix 例外の詳細はこの skill を正とする。task 分解は story-breakdown skill を正とし、この skill では ready な story を最後まで運ぶ。
story-breakdown 済み、または ready 状態の type:story Issue を Orchestra として開始するときagent:opencode 単発 task → story-NN を経由しない (<trunk> 直接 PR)type:task 単独で picked された場合 → story を作らず直接実装フローへgithub-read で読み、Goal / Acceptance Criteria / Out of Scope を確定するgit symbolic-ref --short refs/remotes/origin/HEAD | sed 's@^origin/@@'
git remote set-head origin --auto 後に再判定する。まだ空なら TRUNK=<branch> を人間判断で明示するgit fetch origin のうえ story-<NN> を origin/<trunk> 起点で作成 (NN は story Issue 番号)
git fetch origin
git switch -c story-<NN> origin/<trunk>
git push -u origin story-<NN>
story-<NN> を base にするため、task 委託前に remote branch を作成しておく。story-breakdown の出力または story Issue 本文を読み、配下 task が implementation-ready であることを確認するstory-breakdown に戻すstory-breakdown に戻して起票する。起動は Pre-Final review まで待つimplementation-contract を使い、作業 branch / PR target / Scope / Out of Scope / Acceptance Criteria / Verification / Stop Conditions / 完了時に PR 作成まで求めるかを明示するagent:claude-code → claude CLI を起動して委譲。Claude Code の Agent tool を使う場合は isolation: worktree と必要な skills: を明示するagent:opencode → opencode CLI を起動。ただし opencode 単発 task は <trunk> 直接消化なので story 配下には入れないagent:opencode または agent:claude-code に委譲するstory-<NN> を base にして作成される (実装 agent が github-write 経由で作成)gh pr merge を実行しない)story-<NN> が長期化すると drift が出る。Orchestra が定期的に <trunk> を取り込む:
git switch story-<NN>
git fetch origin
git merge origin/<trunk> # conflict 解消は Orchestra が実施
git push
merge / cherry-pick / rebase の途中状態を残さない (git status で確認)。
E2E シナリオ設計 task 以外の story-NN 配下 task PR がすべて merge されたら Pre-Final review に入る。final story PR の作成有無は Pre-Final review の開始条件にしない。
agent:claude-code へ委託し、起動プロンプトで e2e-scenario-design skill の使用を明示する。Claude Code subagent を使う場合は skills: [e2e-scenario-design, github-read, github-write] と isolation: worktree を指定するspecs/qa/<feature>.md / specs/manual/<feature>.md と story Issue 本文 Test DesignTest Design に残して E2E シナリオ設計 task を close してよいstory-<NN> 配下の全 task PR が merge されたら final review に入る。
story-<NN> の全体差分を再点検
github-read, implementation-contract) と root CLAUDE.md の review 指示を明示するstory: を起点に、QA spec から派生した実際の実装テストパスと、Manual spec から派生した実際の生成テスト / 出力パスのカバレッジを確認する。tests/qa/ や Playwright 固定を仮定せず、repo の既存 test stack に合わせるstory-<NN> 全体を再点検する (claude-code への二重チェック)story-<NN> から <trunk> への final PR を通常 PR として作成 (github-write)
story-<NN> に merge された直後に作成し、以後は story 全体の進捗・差分確認の固定導線として扱うCloses #<NN> で auto closegh pr merge しないstory-<NN> に追加し Phase 2 に戻る進行中 story がある状態で hotfix が必要になった場合はこの節に従う。
<trunk> 直接の単発 task として処理 (story-NN を経由しない)agent:opencode の単発 task は、進行中 story の有無に関わらず <trunk> 直接の PR として消化する。story-level branch と final review は使わない。merge 可否判断は Orchestra が行い、merge 実行は人間に委ねる。
<trunk> 向けに作らせない (story-<NN> が base)