implement

# 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に対してこのワークフローを適用 - **作業開始**: ```bash /create-worktree <issue_id> <branch_name> ``` ### 2. 実装フェーズ **重要**: すべてのファイル操作・コマンド実行は **Worktreeディレクトリ内** で行います。 ```bash # 必ず移動してから作業 cd .worktrees/issue-<id>-<name> ``` #### TDDの実践 1. **Red**: テストケースを作成（`write` tool） 2. **Green**: テストを通す最小限の実装（`write`/`edit` tool） 3. **Refactor**: コードを整理 ### 3. 品質レビューフェーズ PR作成前に必ず品質チェックを行います。 1. **自己チェック**: ```bash # プロジェクトに応じたコマンド npm run lint && npm test # または cargo clippy && cargo test ``` 2. **専門レビュアーによるレビュー**: - `quality-review-flow` skill を参照 - 9点未満の場合は修正して再レビュー ### 4. PR作成フェーズ 1. **承認ゲート**: ユーザーにPR作成の許可を得る 2. **PR作成と環境削除**: ```bash /pr-and-cleanup <issue_id> ``` ### 5. CI監視&自動マージフェーズ PR作成後、**承認なしで自動的に**CI監視→マージまで実行します。 #### 一括実行コマンド（推奨） ```bash 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化してユーザーにエスカレーション | ```bash # 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外のファイル操作**: 誤ってルートディレクトリのファイルを書き換えないこと