Back to list
takemo101

sisyphus-implementation-guide

by takemo101

0🍴 0📅 Jan 24, 2026

SKILL.md


name: sisyphus-implementation-guide description: Sisyphus専用の実装フロー、Subtask処理、Phase別責任分担、チェックリスト、完了報告フォーマットを定義

Sisyphusへの指示(必読)

参照元: implement-issues.md から分離されたSisyphus専用実行指示 このセクションはSisyphus専用の実行指示です。上記ルールの要約版。


🔄 実装フロー

1. Issue受領
     ↓
2. 【単一Issue指定時】Subtask自動検出 ★重要★
     ├─ Subtaskあり → Step 3へ(Subtask単位で実装)
     └─ Subtaskなし → 粒度チェックへ(Step 4へ)
     ↓
3. 粒度チェック(200行以下か?)
     ├─ No(大きい)→ `/decompose-issue` を実行してから再度呼び出し
     └─ Yes(適切)→ 実装開始
     ↓
4. 各Subtaskを順次実装(container-worker)
     ※ 各Subtaskが独立した実装フローを実行:
        ブランチ → 環境 → TDD → レビュー(9点以上までループ) → PR
     ↓
5. CI監視 → マージ(各PR単位)
     ↓
6. 次のSubtaskへ(Step 4に戻る)
     ↓
7. 全Subtask完了 → 親Issue自動クローズ

実装フローの単位

状況実装単位作成されるもの
SubtaskなしIssue単位1ブランチ、1環境、1レビューループ、1PR
SubtaskありSubtask単位N個のブランチ、N個の環境、N個のレビューループ、N個のPR

各Subtaskで実行される完全フロー

Subtask #N:
  ブランチ作成 → container-use環境
       ↓
  TDD実装 (Red → Green → Refactor)
       ↓
  品質レビュー ←──────┐
       ↓             │
  9点以上? ──No────→ 修正(最大3回)
       ↓ Yes
  ユーザー承認
       ↓
  PR作成 → CI監視 → マージ → 環境削除
       ↓
  ✅ このSubtask完了 → 次のSubtaskへ

⚡ Subtask自動検出(単一Issue指定時は必須)

⚠️ 重要: Subtaskがある場合、各Subtaskごとに独立したfeatureブランチ・container-use環境・PRを作成する。

詳細は Subtask検出 & 依存関係解決 を参照。


粒度判定(実装開始前に必須)

推定コード量対応
200行以下→ そのまま実装
200行超/decompose-issue で分割してから再実行

詳細は Issue粒度判定 を参照。


実装フロー(分岐条件)

状況処理方法作成されるもの
Subtaskあり各Subtask単位で順次実装Subtask数 × (ブランチ + 環境 + PR)
Subtaskなし + 200行以下Issue単位で直接実装1ブランチ + 1環境 + 1PR
Subtaskなし + 200行超/decompose-issue で分割-
複数親Issue指定各親Issue単位で並列実装親Issue数 × (Subtask数 × ブランチ + 環境 + PR)

Phase別の責任分担(SSOT)

Note: 以下のフローはIssue単位でもSubtask単位でも同一この表がPhase責任の唯一の定義(Single Source of Truth)です。

責任分担マトリクス

Phase実行者内容入力出力ラベル操作
0SisyphusSubtask検出 & ブランチ作成Issue IDbranch_name, subtask_list+env:active +phase:0-branch
1container-worker環境構築branch_nameenv_idphase:1-env
2container-worker設計書参照(マトリクス使用)task_typecontextphase:2-design
3container-worker設計書実現性チェックcontextOK/NGphase:3-check(NGなら+env:blocked
4container-workerTDD: テスト作成(Red)context, test_spectest_filesphase:4-red
5container-workerTDD: 実装(Green)test_filesimpl_filesphase:5-green
6container-workerTDD: リファクタimpl_filesimpl_files (refined)phase:6-refactor
6.5container-worker実装完了自己チェックimpl_filesOK/NG-
7container-worker品質レビュー(+ ストレステスト任意)impl_filesreview_resultphase:7-review(任意: 8-stress
9container-workerユーザー承認依頼review_scoreapprovalphase:9-approval
10container-workerコミット & プッシュ & PR作成approvalpr_numberphase:10-pr +env:pr-created
11SisyphusCI監視pr_numberci_statusphase:11-ci
12Sisyphusマージ & 環境削除 & 親Issueクローズci_status, env_idmerged, closedphase:12-merge +env:merged

Note: Phase 0〜10 は container-worker、Phase 11-12 は Sisyphus が担当。 Phase 8 (ストレステスト) は任意のためスキップ可。親Issueクローズは Phase 12 の一部。

ラベル操作ルール(必須)

API詳細: {{skill:github-issue-state-management}} セクション「必須更新ポイント」を参照

タイミング実行者操作API
Phase開始時container-workerPhaseラベル更新issue-state.sh phase <num> <phase>
Blocked発生時container-workerステータス変更issue-state.sh block <num> <reason> "<説明>"
PR作成時container-workerステータス + PR番号記録issue-state.sh pr-created <num> <pr_number>
マージ完了時Sisyphusステータス変更issue-state.sh merged <num>

⛔ 違反禁止: Phase遷移時にラベルを更新しないこと。

Token消費の最適化ポイント

Note: 削減率は推定値です。実際の効果はプロジェクト構成に依存します。

Phase最適化手法推定効果
Phase 2設計書参照マトリクス(必須セクションのみ)大幅削減(全文読込回避)
Phase 3設計書実現性チェック(Gate)手戻り防止(無限Token消費回避)
Phase 6.5実装完了自己チェック(到達可能性/定義-使用相関)統合漏れ/スタブ残存防止
Phase 7TODO駆動再実装(TODOファイルのみ参照)大幅削減(設計書再読込回避)
Phase 8ストレステスト(読み取り専用エージェント並列)並列実行で時間短縮
Phase 7, 10Sisyphusからworkerへの委譲メインエージェントのコンテキスト維持

責任境界(厳格)

操作Sisyphuscontainer-workerPhase
Subtask検出0
ブランチ作成0
環境作成/操作1
設計書参照2-3
TDD実装4-6
品質レビュー7-8
ユーザー承認依頼9
PR作成10
CI監視11
マージ12
環境削除12
親Issueクローズ12

⛔ 違反禁止: container-workerがSisyphusの責任を実行すること、またはその逆。


Subtask順次実装時の全体像

Sisyphus (親エージェント)
│
├── Subtask #9 を処理
│   ├── Phase 0: ブランチ作成 (feature/issue-9-data-types) [Sisyphus]
│   ├── Phase 1-10: container-worker → 実装 → PR #25
│   └── Phase 11-12: CI監視 → マージ → 環境削除 [Sisyphus]
│
├── Subtask #10 を処理(#9と並列可能なら同時実行)
│   ├── Phase 0: ブランチ作成 (feature/issue-10-timer-engine) [Sisyphus]
│   ├── Phase 1-10: container-worker → 実装 → PR #26
│   └── Phase 11-12: CI監視 → マージ → 環境削除 [Sisyphus]
│
└── Phase 12(最終): 全Subtask完了 → 親Issue自動クローズ [Sisyphus]

⛔ 必須チェックリスト

実装前チェック

□ 【単一Issue指定時】Subtask検出を実行したか? ★最優先★
□ Issue粒度チェック(200行以下か?)
□ 大きい場合は `/decompose-issue` を案内したか?

実装中チェック

□ 【Subtaskあり】各Subtaskに独立したfeatureブランチを作成したか? ★重要★
□ 【Subtaskあり】各Subtaskに独立したcontainer-use環境を作成したか? ★重要★
□ 【Subtaskあり】各Subtaskで独立したレビューループを実行したか? ★重要★
□ 【Subtaskあり】各Subtaskに独立したPRを作成したか? ★重要★
□ 【レビュー】各Subtaskが9点以上を獲得するまでループしたか?
□ background_task を使用しているか?(⛔ task 禁止)
□ Subtaskは順次処理しているか?(1つ完了してから次へ)

機能完了チェック(PRマージ後の再確認)

重要: Phase 6.5 で既にチェック済みだが、PRマージ後に再確認を推奨。 詳細: {{skill:quality-review-flow}} セクション2(客観的品質基準)を参照

チェック確認方法必須
到達可能性エントリポイントからの参照確認(Phase 6.5で実施済み)再確認推奨
定義-使用相関未使用の引数/Props/パラメータがないこと(Phase 6.5で実施済み)再確認推奨
Smoke Testcargo run / npm run dev で基本動作確認
Epic紐付けEpic Issue の機能リスト(F-XXX)に完了マーク推奨
□ 【Smoke Test】アプリケーションが正常に起動・動作するか?
□ 全Subtask完了後、親Issueをクローズしたか?

ツール使用ルール

操作使用ツール備考
container-worker起動background_tasktask 禁止(MCPツール継承されない)
品質レビュー起動task✅ OK(レビューエージェントはMCP不要)
ファイル操作container-use_environment_file_*edit/write 禁止
コマンド実行container-use_environment_run_cmdbash でのテスト/ビルド禁止
CI監視・マージbash (gh コマンド)✅ OK(環境外のGitHub API操作)
環境クリーンアップdelete_env.sh (delete-environment skill)✅ OK(Sisyphusが実行)
親Issueクローズbash (gh issue close)全Subtask完了後

⛔ よくある間違い

❌ 間違い✅ 正しい方法
単一Issue指定時にSubtask検出をスキップ必ず detect_subtasks() を実行
親IssueをそのままSubtaskなしで実装開始まずSubtask検出 → なければ粒度チェック
Subtask全体で1つのブランチを共有各Subtaskごとに独立したfeatureブランチを作成
Subtask全体で1つのPRを作成各Subtaskごとに独立したPRを作成
Subtask全体で1つのcontainer-use環境を共有各Subtaskごとに独立した環境を作成
レビューをスキップしてPR作成各Subtaskで9点以上になるまでレビューループ
レビュー1回で諦めてPR作成最大3回までリトライ、それでも失敗ならDraft PR
大きなIssueをそのまま実装/decompose-issue で分割してから実装
task(subagent_type="container-worker", ...)background_task(agent="container-worker", ...)
Subtaskを並列実行Subtaskは順次実行(1つ完了してから次へ)
全Subtask完了後、親Issueを放置必ず自動クローズ処理を実行

完了報告フォーマット

## 📋 実装完了サマリー

### 親Issue
- **#{parent_id}**: {parent_title} → ✅ Closed

### Subtask結果

| Subtask | ブランチ | 環境ID | レビュー | PR | CI | マージ |
|---------|---------|--------|---------|-----|-----|-------|
| #{s1} | feature/issue-{s1}-xxx | env-aaa | 10/10 (1回目) | PR #{p1} | ✅ | ✅ |
| #{s2} | feature/issue-{s2}-xxx | env-bbb | 9/10 (2回目) | PR #{p2} | ✅ | ✅ |

### 統計
- 総Subtask数: N
- 成功: N
- 失敗: 0
- レビュー平均スコア: X.X/10

### 環境クリーンアップ
- ✅ env-aaa 削除済み
- ✅ env-bbb 削除済み

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon