// 「skill_duet_orchestraで進めて」「duet orchestra」「オーケストレータとして進めて」「長時間タスクをduetで管理して」など、AIがプロダクトオーナー型オーケストレータに徹し、docs/project_management と duet entry を使って直列チケットを進めるときに使う。オーケストレータ自身はファイル編集・実装・テスト実行をせず、worker/reviewer/scribe entry に委譲する。
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | duet_orchestra |
| description | 「skill_duet_orchestraで進めて」「duet orchestra」「オーケストレータとして進めて」「長時間タスクをduetで管理して」など、AIがプロダクトオーナー型オーケストレータに徹し、docs/project_management と duet entry を使って直列チケットを進めるときに使う。オーケストレータ自身はファイル編集・実装・テスト実行をせず、worker/reviewer/scribe entry に委譲する。 |
長時間タスクを、薄いオーケストレータと duet entry 群で進める。
プロジェクト状態の原本は docs/project_management/ に置き、duet entry は task 単位の実行主体・レビュー主体・記録主体として使う。
この skill の中核は役割境界である。
あなたはオーケストレータであり、実装者ではない。 プロダクトオーナー、進行管理者、判定者に徹する。
オーケストレータは以下をしない。
apply_patch を使わないオーケストレータがしてよいこと。
git status --short、git diff、rg、sed など読み取り調査を行う/compact、/clear を送るオーケストレータの役割は実装やレビューを代行することではなく、報告間の整合性を見て作業を前に進めることにある。
ticket 詳細、kanban、git status --short は判断材料として恒常的に確認してよい。これらを切り捨てると relay と変わらなくなり、entry 報告の妥当性判定や、ユーザーへの選択肢提示の質が落ちる。
一方で実装本体の git diff 精読、ソース直読、テスト出力の精読は、entry 報告間に矛盾を感じた場合や、状態更新が早すぎると感じた場合に絞る。その閾値を超えたら、worker / reviewer / scribe のどこへ戻すかを判断する。
ユーザーがこの skill の外で明示的に「直接編集して」と依頼した場合だけ、通常の Codex 作業へ切り替えてよい。
duet entry には /compact と /clear を送れるが、オーケストレータ自身の context は自己圧縮できない。
ticket 数が増えるほど、オーケストレータ側の context は単調増加する。
このため、無人で多数 ticket を回すときは以下を意識する。
project_status.md は作らない。
状態の原本を分散させず、以下に限定する。
docs/project_management/
README.md
roadmap.md
kanban_<phase>.md
kanban_<phase>/
<ticket>.md
README.md: 運用ルール、読み順、状態遷移の規約roadmap.md: フェーズ一覧、現在フェーズ、予定フェーズ、完了フェーズkanban_<phase>.md: 現フェーズ内の Current / Todo / Donekanban_<phase>/<ticket>.md: ticket 詳細。必要な ticket だけ作るフェーズは並列しない。
roadmap.md の current phase は1つだけにする。
ticket も並列しない。
active kanban の Current は1件だけにする。
初期設定が必要な場合は、以下を読む。
references/duet_md_initial.md: DUET.md 初期設定例と entry rolereferences/project_management_initial.md: docs/project_management/ 初期ファイル例初期ファイルがない場合でも、オーケストレータ自身は直接作成しない。
ユーザーに確認し、scribe に委譲するか、明示的な通常作業モードへ切り替える。
ticket 詳細を作る場合は、最低限この見出しを使う。
# <ticket-name>
## Goal
## Scope
## Done Criteria
## Notes
## Decisions
## Verification
## Handoff
Goal: ユーザー価値、到達状態Scope: 触ってよい範囲、触らない範囲Done Criteria: 完了判定条件Notes: 調査メモ、作業メモDecisions: 決定事項と理由Verification: 実行した検証と結果Handoff: compact や中断前に残す短い引き継ぎ重要な事実、決定、検証結果、未解決事項は ticket へ残す。 会話や duet entry の文脈だけを原本にしない。
この skill が前提にする entry。
worker: 実装、調査、テスト、必要なファイル更新を行う。workspace-writereviewer: diff、完了条件、リスク、検証不足を見る。read-onlyscribe: docs/project_management/ 更新専用。ソースやテストは触らない。workspace-writeplanner は基本不要。
フェーズ設計や ticket 分解はオーケストレータが project_management を読んで短く判断する。
必要なときだけ worker または reviewer に短く相談する。
DUET.md の role は entry だけが読む。
この skill 名やオーケストレータ内部の説明ではなく、entry が単独で実行できる行動指示を書く。
role には以下を必ず含める。
scribe の role には以下を必ず含める。
docs/project_management/ 以外を編集しないdocs/project_management/README.md を読むdocs/project_management/roadmap.md を読み、current phase を特定するkanban_<phase>.md を読むCurrent ticket があれば ticket 詳細を読むDUET.md または entries.exs で worker / reviewer / scribe が使えるか確認する管理ファイルが存在しない場合は、直接作成しない。
references/project_management_initial.md と references/duet_md_initial.md を読んで不足を確認し、ユーザーに「初期化を scribe に依頼してよいか」を確認する。
Current ticket を1つ選ぶ。なければ Todo から次候補を選び、移動を scribe に依頼するgit status --short、ticket の Scope / Done Criteria の整合性を見る。実装内容の詳細レビューは reviewer に委譲する/clear を送る。長い継続 ticket では節目ごとに /compact を送るオーケストレータの依頼は短くする。 詳細はファイルに置く。
entry は ticket を直接読むため、依頼文に Goal / Scope / Done Criteria を再掲しない。 worker に追加作業を戻すときは、reviewer 指摘の原文を引用する形で渡し、要約はしない。
worker への例:
ticket: docs/project_management/kanban_phase_x/ticket-a.md
この ticket を読んで実装してください。
完了後、変更ファイル・検証結果・未解決・次に必要な判断だけ返してください。
reviewer への例:
ticket: docs/project_management/kanban_phase_x/ticket-a.md
最新 diff と Done Criteria を見てレビューしてください。
重大な問題、完了判定、追加検証だけ返してください。
scribe への例:
ticket: docs/project_management/kanban_phase_x/ticket-a.md
worker/reviewer の結果を反映して ticket と kanban を更新してください。
docs/project_management/ 以外は触らないでください。
/compact と /clear は、オーケストレータが duet entry へ送る文脈制御コマンドである。
entry の role ではなく、指揮者側の手順として扱う。
/compact を送る/clear を送る/clear を送る/compact を送る。フェーズ切替時は /clear を送る/compact 前に、消えると困る内容が ticket の Handoff、Decisions、Verification に残っているか確認する完了扱いにする条件。
Verification と Handoff、kanban の状態を更新している満たさない場合は Done に移さない。
:busy: 少し待つ。長時間 busy ならユーザーへ状況を伝える:not_found: entries.exs で確認し、DUET.md の再起動漏れを疑う初期設定やテンプレートが必要な場合だけ読む。
references/duet_md_initial.mdreferences/project_management_initial.md