| name | implement |
| description | 指定されたGitHub Issueをworktree環境で実装する完全ワークフロー。Subtask検出からPRマージまでを統括。 |
Issue実装ワークフロー (/implement)
役割: Sisyphus (Main Agent) が実行する実装のメインループ
環境: Host環境 + Git Worktree
🔄 全体フロー
-
Issue分析 & 準備
- 粒度チェック (200行以下?)
- Subtask検出 (親Issueの場合 → 再帰的に実行)
- 既存実装の確認
-
環境構築 (Phase 1)
/create-worktree で独立環境を作成- 作業ディレクトリへ移動 (
cd .worktrees/issue-XXX)
-
実装サイクル (Phase 2-3)
- TDDサイクル: Red → Green → Refactor
- 品質保証: Lint, Test, 品質レビュー (9点以上)
- 客観的基準:
quality-review-flow 準拠
-
PR作成 (Phase 4)
- ユーザー承認
/pr-and-cleanup でPR作成と環境削除
-
CI監視 & 自動マージ (Phase 5) ← 承認不要・自動実行
pr-merge-full.sh で一括実行- CI完了待機 → 成功で即マージ
- CI失敗時は自動修正（最大3回）
- 3回失敗でエスカレーション
📋 Sisyphus 実行ガイド
1. 準備フェーズ
まず、Issueのサイズと依存関係を確認します。
2. 実装フェーズ
重要: すべてのファイル操作・コマンド実行は Worktreeディレクトリ内 で行います。
cd .worktrees/issue-<id>-<name>
TDDの実践
- Red: テストケースを作成（
write tool）
- Green: テストを通す最小限の実装（
write/edit tool）
- Refactor: コードを整理
3. 品質レビューフェーズ
PR作成前に必ず品質チェックを行います。
- 自己チェック:
npm run lint && npm test
cargo clippy && cargo test
- 専門レビュアーによるレビュー:
quality-review-flow skill を参照- 9点未満の場合は修正して再レビュー
4. PR作成フェーズ
- 承認ゲート: ユーザーにPR作成の許可を得る
- PR作成と環境削除:
/pr-and-cleanup <issue_id>
5. CI監視&自動マージフェーズ
PR作成後、承認なしで自動的にCI監視→マージまで実行します。
一括実行コマンド（推奨）
bash .pi/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number>
このスクリプトが以下を自動実行します：
- CI完了待機（最大10分）
- CI成功 → 自動マージ（
--merge --delete-branch）
- Issueラベル更新（
env:merged）
CI失敗時の自動対応
CI失敗時は ci-workflow に従い自動修正を試みます：
| 失敗種別 | 自動対応 |
|---|
| Lint/Format | --fix で自動修正 → push → 再待機 |
| Test/Build | コード修正 → push → 再待機 |
| 3回失敗 | PRをDraft化してユーザーにエスカレーション |
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 を参照
⛔ 禁止事項
- メインブランチでの直接作業: 必ずWorktreeを作成すること
- テストなしの実装: TDDを原則とする
- レビューなしのPR作成: 必ず品質レビューを通すこと
- Worktree外のファイル操作: 誤ってルートディレクトリのファイルを書き換えないこと
