IDD Skill：イシュー駆動開発ワークフローテンプレート

こんな人に向いています

• 自分のGitリポジトリで日常開発を進め、「イシューからマージまで」を繰り返し可能な一連の流れとして固定したい開発者・小規模チーム：インポート後、リポジトリ内のAIコーディングエージェントが公式の説明どおりのワークフローに従って、準備完了イシューの発見、認領、ブランチでの実装、PR作成、レビューコメントへの対応、CI待ち、リポジトリで選択したマージポリシーに沿ったマージとクリーンアップまで行います。公式はこのワークフローを「ポータブル」と説明しており、単一ツールに束縛されず、リポジトリとともにインポートして使えるものです。
• 複数のAIコーディングツールを併用し、ワークフローを単一クライアントに固定されたくない開発者：公式によると、コアループはGitHub Copilot、Claude Code、OpenAI Codex CLI、OpenCode、Antigravity CLI（旧Gemini CLI）を横断して動作します。
• 複数の作業セッションで異なるイシューを並行して進めたいチーム：公式によると、分散モードのデフォルトポリシーはfully_autonomous_mergeで、ワーカーセッションはそのままマージまで進められます。セッション間の調整方法や競合の回避方法については、公式の説明がありません。
• 導入前に確認しておきたい点：公式ページはGitHub以外のホスティングプラットフォームへの対応を説明しておらず、この点は未確認です。チームが全自動マージを受け入れない場合は、デフォルトポリシーを事前に評価・調整する必要がありますが、その調整方法は公式には示されていません。

最初の試みを3分で完了する

• 前提：ブランチの作成とPRのオープンが許可された自分のGitリポジトリがあること。環境には、公式が挙げるループ全体の依存関係――git、認証済みのgh CLI（または同等のGitHub MCP統合、どちらか一方で可）、jq、curlなどのRESTクライアント――を用意しておきます。
• インストール場所と方法：ファイルの手動コピーは不要です。公式の導入方法は、対象リポジトリ内でAIエージェントにインポート指示を直接出すことで、オンボーディングガイドがテンプレートのコピーを行います。
• きっかけ：リポジトリで対応エージェントを開き、以下の公式指示を一字一句そのまま入力します。

Import and onboard github:kurone-kito/idd-skill's IDD into this repository.

• 最初の試みは低リスクな操作にとどめるのがおすすめです。エージェントにワークフローガイドを読ませ、既存の準備完了イシューを一覧化し、次のステップの計画を説明させます。認領もコード変更もさせません。公式が説明するループの起点はまさに「ガイドを読む、準備完了イシューを発見する、認領する」であり、認領が発生する前ならいつでも中止できます。
• 成功のサイン：エージェントがワークフローの要点を復唱し、既存イシューを正確に一覧できれば、インポートとガイドの読み込みが機能しています。テンプレートファイルがリポジトリにコピーされていれば、オンボーディングは完了です。公式は具体的な配置先パスを示していないため、正確な場所はエージェントの実際の出力を基準にしてください（未確認）。

活用例

ケース1：準備完了イシューを1つ、丸ごと納品する。 シナリオ：バックログに準備完了の印が付いたissueがすでにあり、認領からマージまでのループを検証したい。エージェントに「準備完了イシューを1つ認領して、実装を完了して」と指示します。エージェントは公式の完全ループをなぞります――ワークフローガイドの読解、イシューの認領、ブランチでの実装、PR作成、レビューコメント対応、CI待ち、リポジトリで選択されたマージポリシーによるマージとクリーンアップ。観察できる節点は順に、ブランチの出現、PRの作成、CIステータスの変化、マージとブランチのクリーンアップで、それぞれ公式ループの決まった段階に対応します。デフォルトのfully_autonomous_mergeポリシーでは、作業セッションはマージまで進められます。そのため初回実行の前に、CIゲートとブランチ保護が整っていることを確認するか、指示の中で「今回はPRまでで止める」と明示してください。

ケース2：発見と計画だけ行い、何も変更しない。 シナリオ：この流れがリポジトリに合うかをまず評価したい、まだ作業させたくない。エージェントに「ワークフローガイドを読み、すべての準備完了イシューを実装方針つきで一覧化して。認領はしないで」と指示します。これはループの前半（ガイドの読解、イシューの発見）しか使わず、ブランチやPRは作成されません。イシューがどう「準備完了」と判定されるかは公式に説明がなく、エージェントが一覧は空だと報告した場合は、リポジトリ内のイシューステータスの付け方をまず確認してください。期待できる成果はイシューの一覧と実装計画のテキストで、実装に進むかどうかはあなたの次の指示が決めます。計画が実行可能と確認できたら、ケース1に従って1つのイシューで完全ループを試せます。

利用上の境界

• 副作用と確認ポイント：インポートするとリポジトリにテンプレートファイルがコピーされます。新規ファイルの追加のみか、既存ファイルへの変更も伴うかは公式に説明がないため、インポート後にエージェントが示す変更リストをまず確認しましょう。完全ループはブランチの作成、コードのコミット、PRのオープンを行い、デフォルトポリシーのfully_autonomous_mergeではマージまで進みます。どの操作で事前に確認を求めるかは公式に項目立てされた説明がないため、指示ごとに許可範囲を明示することをおすすめします。
• ネットワークとコマンドアクセス：完全ループには認証済みgh CLIまたは同等のGitHub MCP統合が必要で、curlなどのRESTクライアントも明示されています。つまりエージェントはループの中でこれらのツール経由でGitHub APIにアクセスします（イシューの読み取り、PRの作成とマージなど）。具体的にどのエンドポイントを呼ぶのか、他のネットワークアクセスの有無は、公式に項目立てされた説明がありません。
• 実行環境とクライアントの前提：公式はコアループがGitHub Copilot、Claude Code、OpenAI Codex CLI、OpenCode、Antigravity CLI（旧Gemini CLI）を横断して動作すると列挙しています。リスト外のエージェントで使えるか、OSに追加要件があるか、依存関係が欠けている場合に縮退動作するかは、いずれも公式に説明がありません。
• 公式が明示する制限と未知の事項：公式資料はGitHub以外のホスティングプラットフォームのサポートに触れておらず、fully_autonomous_merge以外にどんなマージポリシーがあるか、その切り替え方法も説明していません。CI失敗後のエージェントのリトライ挙動も未確認です。これらの詳細は、リポジトリにインポートされたワークフローガイドの原文を基準にしてください。