コンテンツにスキップ

コマンドリファレンス

すべての動詞は機械エンジン bash <skill-dir>/runner/flow.sh <command> にディスパッチする。Claude Code、Cursor、Antigravityでは /flow … と入力する。Codex CLIでは $flow … と入力する。Windows PowerShellでは bash ではなく <skill-dir>\runner\flow.cmd <command> を呼ぶ。

/flow status — 今どこにいて、何が止めているか
/flow next ゲートチェック + 次のステージを開ける
/flow assess ブラウンフィールド評価
/flow card ビルドカードを作成
/flow check C-001 カードを検証(done = 現実世界の証拠)
/flow auto 自律ビルド(セキュリティクラスでhalt)
/flow doctor 環境チェック
コマンド 動作
/flow resume プロジェクト途中にコールドで入るための読み取り専用セッションストーリー概要:最後のセッション(コマンド名のみ、生の引数は決して)、進行中カードとdwell、ゲート状態、1つの NEXT -> 行。ロックを取らない。既存プロジェクトをコールドで引き継ぐとき最初に実行する。
/flow (status) 今どこにいるか、何が止めているか、resume と同じヘルパーからの NEXT -> 行、現在のステージdwell、カードリスト(10枚超は要約に圧縮)、1行のメモリ要約。
/flow recall ステージやカードの開始時に耐久メモリを読み戻す——未解決debt、最新のレトロ、前カードのスコープ、ハーネスの摩擦とbacklog、監査の健全性、プレイブック。
/flow unlock クラッシュや放棄されたセッションの後に、このプロジェクトの並行ロックをクリアする。
/flow doctor macOS・Linux・Windowsを横断する環境自己チェック:bash、python、grep、git、インストールパス。
コマンド 動作
/flow next 現在のステージをゲートチェック。通過したら次を開ける(またはステージ00から開始)。通過したばかりのステージの意味チャレンジは機械的通過の後に適用される。
/flow gate <stage> [--json] 1つのステージ(またはカードには --card C-NNN)の読み取り専用機械スキャン:何も進めず所見を報告する。進行は next/check のものだ。--json は閉じた gate.report エンベロープを出力する。
/flow assess ブラウンフィールド:計画の前に flow/00-inspect.md に現状評価を足場掛けしてゲートをかける。オペレータレビュー。
/flow skip <stage> --reason 対応する未解決debt行のあるゲートを進める。非セキュリティクラスのみ。ステージ05は決してスキップできない。
/flow clarify Scope・PRD・Contract上の ## Open decisions 配下に残った - [ ] 箇条書きを列挙する。助言的であり、next ゲートではない。
/flow constitution flow/constitution.md 内のオペレータ執筆プロジェクト不変条件をチェックする。助言的であり、next ゲートではない。
/flow converge 現在のコードを計画に照らして突き合わせる追記のみの残余カード。トランザクショナル——全カードか無か。既存カードを編集しない。差がなければ CONVERGED を出力し何も書かない。
コマンド 動作
/flow card 次のビルドカードを作成。すべての計画ゲート通過後のみ。
/flow card start|done C-NNN カードを進行中に印付け、または check と同じ規則でゲートされるCLI所有の done への反転——失敗すれば取り消す。手編集と共存する。
/flow check C-NNN カードを検証する:[FILL] プレースホルダ、ステータス、必須セクション、完了証拠。
/flow ready ビルド可能なtodoカードを並行安全性ヒント付きで列挙する。
/flow auto 自律実行をプレフライトする。auto stop でクリアする。Tier-Aは自動マージ、Tier-Bは fresh サブエージェントによる1回の修復、Tier-Cセキュリティクラスはhalt。
/flow attest semantic|live-verify|status|recover 証明付き実行コントロールプレーンが使うフィンガープリント束縛の証跡を発行・検査する。
/flow workspace add|list|enter|remove|check|doctor|port マルチエージェントworktree分離:エージェントごとに1つの git worktree。1つのブランチ切り替えが全端末を反転させない。workspace port は決定的なカードごとポートを割り当てる。
/flow loop-prep <card> 単一数値目標への反復のための配管:分離worktreeと、カードのallowed filesから導出された数値検証コマンド。
/flow loop-log <card> --iterations N --start M --end K --outcome … 終了したループ実行を使用テレメトリに記録する。
コマンド 動作
/flow mode [teach|work] ゲート成果物を誰が書くかを表示・設定する。デフォルト teach。
/flow project-type [web|cli|library|skill] プロジェクトタイプを表示・設定する。完了証拠規則と契約の継ぎ目を選択する。デフォルト web。
/flow debt add|list DEBT.md に意図的ゲートスキップを記録・列挙する。セキュリティクラス項目はオペレータのみ。
/flow rules [cursor|windsurf|roo|cline|aider|openhands|copilot|list] [--write] サードパーティハーネスがflowの規律に従うためのworkspace規則の足場を出力(または書き込み)する。助言的。

/flow contract、/flow tokens、/flow coherence、/flow consistency は各々1軸の漂流を旗立てし、自動修正しない。合わせて格子を成す:バージョン、URL、デザイントークン、成果物同士の追跡可能性。

コマンド 軸 報告内容
/flow coherence バージョン 宣言されたバージョンフィールド間の漂流——安い文書対コードの断片
/flow contract URL クライアントbase-URL対提供パス接頭辞の漂流。二重 /api や混在接頭辞のクラス。スキーマdiffツールが見逃す(web)
/flow tokens デザイン DESIGN.md 宣言トークン対実際に使われたCSS:未使用トークン、値の不一致、孤児変数
/flow consistency 追跡可能性 カードが主張し契約インターフェースが serve するすべてのPRD FRn、数値の成功指標、残ったプレースホルダなし

契約ゲートの後、カードを切る前に consistency と coherence を実行する。記述する面のビルド中に contract と tokens を実行する。

/flow design <file> はプロジェクト横断の掃引ではなく、単一UIファイルへの関連する機械チェックだ。

記述とタイミング:README.md

コマンド 動作
/flow harness <args> 耐久層CLIへのパススルー:intake、story、trace、decision、backlog、query、audit、propose、さらにinit、tool、intervention、promote-suggest、rollup、usage、prune、graph、journal。
/flow promote <file> プレイブックをクロスプロジェクトのナレッジベース ~/.claude/flow/playbooks にコピーする。
/flow usage [--global|--prune] ローカルJSONL使用ログをビルド分析に集計する:サイクルタイム、ゲート失敗率、ステージ・カードごとのdwell、コマンド内訳。ローカルのみ。
/flow retro 3つのレトロ質問を出力する。行を書くのはオペレータであり、エージェントではない。

/flow harness <args> は耐久層へのパススルーだ。セッションを越えて生き残るものを蓄えるflow所有のPythonとSQLiteのCLI。

サブコマンド 用途
intake タイプ・要約・フラグ付きで入ってきた要求を記録する。authのようなリスクフラグはレーンを自動昇格させる
story 作業単位とその証拠を追跡する。story complete --proof-source … で完了させる
trace カードチェック通過時に書かれるtier採点済み記録
decision 決定を記録し、後に実際の結果でループを閉じる
backlog propose が書き込む改善backlog
query 記録を読み戻す
audit 蓄積された記録のエントロピーとドリフトを採点する
propose 反復する摩擦と介入をbacklog項目に掘り起こす。決定的で、2回以上の発火で動く
init ハーネスデータベースを作成・更新する
tool kind別のインバウンドツール・能力レジストリ
intervention 人間・レビュアー・CI・エージェントの上書きを記録する
promote-suggest 反復する摩擦と介入からプレイブック案を起草する
rollup JSONL使用シンクを使用ストアに取り込む(冪等)
usage 使用ストアから使用分析を出力する
prune 各JSONLシンクを末尾N行に切り詰める(クラッシュセーフ)
graph グラフ実行器:ジャーナル項目の記録・進行

大半はエンジンがあなたのために書く——ステージの進行がintakeを生み、通過したチェックがtraceを記録する——手動の面はほぼ読み取りだ。この層は任意だ:python3 がなければゲートは動き続け、このストアだけ無効になる。

スキーマ、フラグ、ライブ権威表:skills/flow/harness/README.md

コマンド 動作
/flow eval [--stage 01|02|05|card|routing|converge] [--fixture <id>] [--n 3] [--timeout <s>] 意味ゲートの行動的証拠:モデルは中身がなく機械的にはクリーンなfixtureに実際に旗を立てるか?任意で課金。claude CLIがなければゼロ呼び出しでクリーンスキップする。
/flow eval --report オフライン、ゼロ呼び出し:最後の完全バッチのスコアカードと前バッチとの漂流。
/flow eval --replay 保存済みfixtureのキーレス再生——モデル呼び出しなし。欠落・古いfixtureはexit 1。評決はevalフロアに数えない。
/flow eval --diff <old> <new> オフラインのfixtureリグレッション分類器:2バッチをベースラインと比較する。