implement

name	implement
description	指定されたGitHub Issueをworktree環境で実装する完全ワークフロー。Subtask検出からPRマージまでを統括。

Issue実装ワークフロー (/implement)

役割: Sisyphus (Main Agent) が実行する実装のメインループ 環境: Host環境 + Git Worktree

---

🔄 全体フロー

1. Issue分析 & 準備

   • 粒度チェック (200行以下?)
   • Subtask検出 (親Issueの場合 → 再帰的に実行)
   • 既存実装の確認

2. 環境構築 (Phase 1)

   • /create-worktree で独立環境を作成
   • 作業ディレクトリへ移動 (cd .worktrees/issue-XXX)

3. 実装サイクル (Phase 2-3)

   • TDDサイクル: Red → Green → Refactor
   • 品質保証: Lint, Test, 品質レビュー (9点以上)
   • 客観的基準: quality-review-flow 準拠

4. PR作成 (Phase 4)

   • ユーザー承認
   • /pr-and-cleanup でPR作成と環境削除

5. CI監視 & 自動マージ (Phase 5) ← 承認不要・自動実行

   • pr-merge-full.sh で一括実行
   • CI完了待機 → 成功で即マージ
   • CI失敗時は自動修正（最大3回）
   • 3回失敗でエスカレーション

---

📋 Sisyphus 実行ガイド

1. 準備フェーズ

まず、Issueのサイズと依存関係を確認します。

• 粒度チェック: 200行を超える場合は /decompose-issue を提案
• Subtask検出: 親Issueの場合は /decompose-issue を実行し、各Subtaskに対してこのワークフローを適用
• 作業開始:

  /create-worktree <issue_id> <branch_name>
  

2. 実装フェーズ

重要: すべてのファイル操作・コマンド実行は Worktreeディレクトリ内 で行います。

# 必ず移動してから作業
cd .worktrees/issue-<id>-<name>

TDDの実践

1. Red: テストケースを作成（write tool）
2. Green: テストを通す最小限の実装（write/edit tool）
3. Refactor: コードを整理

3. 品質レビューフェーズ

PR作成前に必ず品質チェックを行います。

1. 自己チェック:

   # プロジェクトに応じたコマンド
   npm run lint && npm test
   # または
   cargo clippy && cargo test
   

2. 専門レビュアーによるレビュー:
   • quality-review-flow skill を参照
   • 9点未満の場合は修正して再レビュー

4. PR作成フェーズ

1. 承認ゲート: ユーザーにPR作成の許可を得る
2. PR作成と環境削除:

   /pr-and-cleanup <issue_id>
   

5. CI監視&自動マージフェーズ

PR作成後、承認なしで自動的にCI監視→マージまで実行します。

一括実行コマンド（推奨）

bash .pi/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number>

このスクリプトが以下を自動実行します：

1. CI完了待機（最大10分）
2. CI成功 → 自動マージ（--merge --delete-branch）
3. Issueラベル更新（env:merged）

CI失敗時の自動対応

CI失敗時は ci-workflow に従い自動修正を試みます：

失敗種別	自動対応
Lint/Format	--fix で自動修正 → push → 再待機
Test/Build	コード修正 → push → 再待機
3回失敗	PRをDraft化してユーザーにエスカレーション

# CI失敗時の手動対応が必要な場合
gh run view --log-failed  # ログ確認
# 修正後
git add . && git commit -m "fix: CI修正" && git push
# 再度マージ試行
bash .pi/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number>

詳細: ci-workflow skill および pr-merge-workflow skill を参照

---

⛔ 禁止事項

1. メインブランチでの直接作業: 必ずWorktreeを作成すること
2. テストなしの実装: TDDを原則とする
3. レビューなしのPR作成: 必ず品質レビューを通すこと
4. Worktree外のファイル操作: 誤ってルートディレクトリのファイルを書き換えないこと