Skip to content

CLIフラグ

使用方法

text
/forge [フラグ] <タスクの説明またはURL>

フラグ

--effort=<S|M|L>

工数レベルを指定。フローテンプレートを決定します:

工数テンプレートスキップされるフェーズ
Slightタスクレビュー (4b)、チェックポイント B、包括的レビュー (7)
Mstandardタスクレビュー (4b)、チェックポイント B
Lfullなし — 全チェックポイント必須

デフォルト:M。XSはサポート外。

--auto

AIレビュアーの判定がAPPROVEまたはAPPROVE_WITH_NOTES(CRITICALな指摘なし)の場合、ヒューマンチェックポイントをスキップ。REVISEの場合は一時停止。

工数Lでは無視 — 人間の承認が常に必要。

--nopr

PR作成をスキップ。変更はフィーチャーブランチにコミット・プッシュされますが、プルリクエストは作成されません。

--debug

summary.md## Debug Report セクションを追加。実行フロー診断を含みます:

  • トークン外れ値
  • リトライ回数
  • リビジョンサイクル
  • 欠落しているphase-logエントリ

注意:## Improvement Report はこのフラグに関係なく常に追加されます。

--discuss

プレーンテキスト入力に対してパイプライン開始前の質問ダイアログを起動します。パイプライン開始前に最大5つの確認質問を行い、回答を収集します。収集した回答は pipeline_init_with_context に渡され、より詳細なタスク説明が生成されます。

プレーンテキスト入力にのみ適用されます — GitHub IssueやJira URLでは無視されます。--auto と組み合わせると、ディスカッションモードは抑制されます。

再開(自動検出)

中断されたパイプラインを再開するには、specディレクトリ名を入力として指定します。 .specs/ 配下にディレクトリが存在する場合、自動的に再開として検出されます:

text
/forge 20260320-fix-auth-timeout

特別なフラグは不要です。オーケストレーターは確認なしで直接処理を進めます。

後方互換性: --resume が入力に含まれていても無視されますが、効果はありません。 再開は常にディレクトリの存在から自動検出されます。

使用例

text
# 小規模タスク、チェックポイント自動承認
/forge --effort=S --auto 認証ミドルウェアのnullポインタクラッシュを修正

# 中規模タスク、PR作成なし
/forge --nopr APIクライアントにリトライロジックを追加

# 大規模タスク、デバッグ出力付き
/forge --effort=L --debug 新しいバリデーションレイヤーを追加

# プレーンテキスト入力、パイプライン開始前の質問ダイアログあり
/forge --discuss 検索エンドポイントにキャッシュを追加

# GitHub Issueから
/forge https://github.com/org/repo/issues/123

# Jiraから
/forge https://myorg.atlassian.net/browse/PROJ-456

# 中断されたパイプラインの再開(.specs/ ディレクトリから自動検出)
/forge 20260320-fix-auth-timeout

Released under the MIT License.