クイックスタート
基本的な使い方
プラグインがインストールされたClaude Codeセッションからスキルを呼び出します:
text
/forge <タスクの説明>
/forge https://github.com/org/repo/issues/123
/forge https://myorg.atlassian.net/browse/PROJ-456GitHub IssueまたはJira URLを指定すると、パイプラインはIssueの詳細を取得し、最終サマリーをコメントとして投稿します。
使用例
text
# 小規模タスク、自動承認
/forge --effort=S --auto 認証ミドルウェアのnullポインタクラッシュを修正
# 中規模タスク、PR作成をスキップ
/forge --nopr APIクライアントにリトライロジックを追加
# 大規模タスク、デバッグ診断付き
/forge --effort=L --debug 新しいバリデーションレイヤーを追加フラグ
| フラグ | 説明 |
|---|---|
--effort=<S|M|L> | 工数レベルを指定。フローテンプレート(light/standard/full)を決定。デフォルト:M。 |
--auto | AIの判定がAPPROVEの場合、ヒューマンチェックポイントをスキップ。REVISEの場合は一時停止。 |
--nopr | PR作成をスキップ。変更はコミット・プッシュされるがPRは作成されない。 |
--debug | summary.md に実行診断のデバッグレポートを追加。 |
--discuss | プレーンテキスト入力に対してパイプライン開始前の質問ダイアログを起動。 |
| (自動検出) | specディレクトリ名を指定して再開。フラグ不要。 |
中断されたパイプラインの再開
specディレクトリ名を指定。.specs/ ディレクトリの存在から自動検出されます:
text
/forge 20260320-fix-auth-timeoutパイプラインの中止
MCPツールを使用:
text
mcp__forge-state__abandon with workspace: .specs/20260320-fix-auth-timeoutまたは状態ファイルを削除:
bash
rm .specs/20260320-fix-auth-timeout/state.json実行中に起こること
- 入力バリデーション — 決定論的 + セマンティックチェック
- ワークスペースセットアップ —
.specs/にrequest.mdとstate.jsonを作成 - 分析フェーズ — 状況分析と調査(読み取り専用)
- 設計 — アーキテクトが
design.mdを作成、レビュアーが承認または修正 - ヒューマンチェックポイント — 設計をレビュー
- タスク分解 — タスクを分割、レビュー
- 実装 — 各タスクをTDDで実装、その後コードレビュー
- 検証 — 包括的レビュー + 最終ビルド/テスト検証
- PR作成 — コミット、プッシュ、PR作成
- サマリー — 改善レポート付き
summary.md
詳細なフェーズの説明は パイプラインフロー を参照してください。工数ベースのフェーズ選択は フローテンプレート を参照してください。