はじめに

Current Slipway build を使い、空の checkout から1回の user-controlled Run を開始します。

1. CLI generation を確認する

この documentation が対象とする interface には7つの user コマンドと machine protocol があります。

./slipway --help

Output に install、uninstall、list、doctor、run、status、stop が必要です。表示されない場合は旧 release です。Current checkout を build するか、より新しい compatible tag を選んでください。詳細はインストールを参照してください。

2. Host アダプターを1つ install する

AI ホストが作業する Git worktree 内で実行します。

./slipway install --tool claude
./slipway doctor

claude は codex、copilot、cursor、kilo、opencode、pi、qwen、windsurf に置き換えられます。Kiro は初回に surface が必要です。

./slipway install --tool kiro --surface ide   # または: --surface cli

install は host-local capability file だけを書き、hash を記録します。グローバルなホスト設定や ambient hook は変更しません。Generated path はホストアダプターを参照してください。

3. Run を明示的に開始する

AIコーディングツールで、生成された slipway-run capability を明示的に呼び出して1つの task を与えます。

reports コマンドに CSV export を追加し、test を追加する。

ホストは CLI に Action を要求し、それを実行して structured Outcome を報告します。Run が pause または summary に達するまで繰り返します。使用される protocol 操作は公開され documented ですが、手動で操作する必要はありません。各 response が正確な次のコマンドを既に含んでいます。

CLI を直接 integration するホストは、同じ ad-hoc Run を次のように開始できます。

./slipway run --json -- "reports コマンドに CSV export を追加する"

このコマンドは最初の orient Action を返します。CLI 自体は code を変更しません。

4. Source を選ぶ

Source	選ぶ場面
Ad hoc	Task が小さい、機微、緊急、offline、または Issue が不要な場合。
GitHub Change Issue	Durable で review 可能な revision-pinned requirements source が必要な場合。

Issue-backed Run では、生成された slipway-run capability に GitHub Change Issue を渡します。Host が Issue を fetch し、temporary ソースエンベロープを作成して CLI に渡します。Host integration を実装している場合を除き、envelope を手書きしないでください。

Host を離れずに rough idea、Objective、Change、既存 Run の次の段階を判断するには、生成された slipway-workflow capability を呼び出します。Current stage を確認し、最短の次の explicit capability または明示的な no-further-action outcome を示します。Draft が必要なら、同じ呼び出しで fact を調査し、genuine な human decision を 1 つずつ問い、self-contained な Change または planning Objective を合成します。汎用 skill catalog の routing、user-only external skill の呼び出し、Issue publish、Run start は行いません。アイデアから Run までのワークフローを参照してください。

Objective は複数の Change をまとめられますが、Run は開始できません。Managed Issue を publish する前に GitHub Issue ワークフローを読んでください。

5. 制御を保つ

Run が報告する pause reason は次の4つのいずれかです。

人間が決める必要のある decision——Issue source の変更や unavailable もここに含まれ、独立した reason ではなく decision として pause します；
Environment dependency の unavailable；
Action budget の exhaustion；
Exact destructive scope の confirmation。

Generated ホストが選べる response を示します。ユーザーは理由を説明せず skip、stop、reorder、take over できます。通常の implementation で繰り返し authorization を求めません。

Inspection command：

./slipway status
./slipway status <run-id> --json
./slipway stop <run-id>

stop は recovery data を保存します。Ended は Slipway に自動 Action が残っていないことだけを示します。Test、Review finding、リポジトリ policy、merge approval、release decision は独立しています。

6. 保存内容を理解する

Run data は <git-common-dir>/slipway/runs/ にあり、goal、accepted requirements、user answer、Outcome、コマンド summary を含む場合があります。Slipway は token、environment dump、unrelated file、full conversation、hidden reasoning を意図的には収集しませんが、ジャーナルに secret がないとは保証できません。

機微な content を扱う前に Run、復旧、プライバシーを読んでください。