PerchAI
Perchの使い方

スラッシュコマンド

Perch TerminalとCLIで各スラッシュコマンドを実際に使う方法、得られるもの、そしてそのまま頼む代わりにコマンドを使うべき場面。

スラッシュコマンドは、モデルへのタスクではなく、Perch自体への直接的な指示です。プロンプトで/と入力すると一覧が表示されます。その多くは手軽なセッション操作ですが、五つは実際の作業を行います。/goalは複数のターンにまたがって自律的に動き、/verifyは回答をあなたの出典と照合し直し、/deepresearchは複数ラウンドで質問を調査して出典付きのレポートを返し、/delegateはタスクをバックグラウンドエージェントに引き渡し、/flockはワーカーのチームを動かします。

このページでは、それぞれをいつ使い、使うと何が起きるかを説明します。すべてのコマンドとフラグの簡潔な一覧は、CLIリファレンスを参照してください。

使える場所

スラッシュコマンドは、Perch Terminal(デスクトップアプリとapp.perchai.app)とCLIで使えます。ウェブチャットにはありません。一部は特定の利用環境専用で、以下に記しています。

/goal

/goalは、最も使われていないコマンドです。通常のターンは頼まれたことをして止まるため、作業に十二ものステップが必要なら、「続けて」と言い続けなければなりません。/goalは、Perchが自らターンを重ねて追い続ける目標を設定し、完了の監査に合格するか、予算を使い切るまで、自分自身を呼び出し続けます。

作業のステップが多く、口で説明できるゴールがあるときに使ってください。

/goal make the test suite pass
/goal reconcile every invoice in this folder against the GL and write up the exceptions

質問ひとつで済む場合には使わないでください。一ターンで済む目標は、監査の手間が増えるだけです。

実行の様子を見て操舵する

目標が実行されると、各ターンがツール呼び出しとともにその場で表示されます。操作には次のコマンドがあります。

コマンド動作
/goal現在の目標を表示します。状態、使用済みターン数、最後に停止した理由です。
/goal pause目標を失わずに一時停止します。
/goal resume停止したところから目標を再開します。
/goal clear目標を完全に破棄します。stop、off、cancel、resetでも同じです。

/goal statusは引数なしの/goalと同じで、/goal continueは/goal resumeと同じです。

実行が止まる場面

目標が永遠に実行され続けることはありません。次のいずれかの理由で終了し、Perchはその理由を伝えます。

停止意味
Complete完了の監査に合格しました。作業は完了です。
Budget40ターンまたは4時間の実時間に達しました。残っているのは途中までの成果です。
No progress直前のターンでツール呼び出しがなく、監査にも合格しなかったため、空転を続ける代わりに停止しました。
Blockedある操作にあなたの承認が必要です。
Failedターンがエラーになりました。
CancelledCLIのCtrl-CまたはデスクトップアプリのEscであなたが停止しました。

Complete以外は、どれも/goal resumeで再開できます。

権限モードがここで効いてくる

ここが多くの人が意外に思う点です。Default権限モードでは、最初の書き込みやコマンドで承認待ちになり、目標はBlockedを報告して止まります。これは正しい動作ですが、Defaultモードで一晩中放置する目標は、あまり進まないということでもあります。

留守の間に目標を実行させたい場合は、Auto Review(元に戻せる作業は自動で進み、元に戻せない操作は引き続き確認されます)またはTake the Wheel(完全な自律動作)に設定してください。それぞれのモードで許可されることについては、権限モードを参照してください。

終了しても残る

目標はスレッドとともに保存されるため、セッションをまたいで残ります。CLIを終了し、デスクトップアプリを閉じ、ページを再読み込みしてから、同じフォルダやスレッドに戻って/goal resumeを実行すれば、目標とターン数はそのまま残っています。

目標がスレッドごとであることから、二つのことが言えます。あるフォルダのスレッドに設定した目標は別のスレッドからは見えません。CLIではデフォルトのスレッドが作業ディレクトリに紐づくためです。そして、まったく同じ目標文でもう一度/goalを実行すると、カウントをリセットせずに既存の目標を続行します。異なる文なら新しく始まります。

/verify

/verifyは、回答に含まれる主張を、インデックス済みの出典と照合し直します。リトリーバルだけでモデル呼び出しを伴わないため、速く結果が返り、トークンも消費しません。

/verify                  # check the last answer Perch gave
/verify <paste text>     # check text you wrote or pasted
/verify --changed        # re-check only what moved since your last check

集計と、主張ごとの行が返ってきます。

Citation check — 6 claims in the last answer checked against your sources
✓ 4 verified · ~ 1 uncertain · ✗ 1 not found

✓は出典が主張を裏付けていること、~は一致が弱く自分で確認すべきこと、✗は出典のどこにも裏付けがないことを意味します。このコマンドが存在する理由は✗の行です。Perchが出典付きのものを下書きしたあと、そしてその下書きを手放す前に実行してください。

--changed とチェックポイントの意味

/verify --changedが答えるのは、より限定された問いです。前回確認してから、足元の出典に変化があったか。頼りにしたものが今も成り立つか。

重要なのは、前回の/verify実行がチェックポイントになるということです。チェックポイントを設定する専用のコマンドはありません。各チェックは、依拠した出典を記録するため、あとからの--changedは、出典が実際に変わった主張だけを照合し直し、残りには触れません。そのスレッドで一度も/verifyを実行していなければ、--changedには比較対象がなく、その旨が表示されます。

弱くなった主張、つまり後退したものから先に示されます。対応が必要なのはその部分だけだからです。--since-lastは、そちらのほうが読みやすければ使える別名です。

/deepresearch

/deepresearchは、一度の検索では足りない質問のためのコマンドです。質問を小さな問いに分解し、インデックス済みのファイルとウェブ(合う場合は専門的な情報源も)を検索し、複数のラウンドで見つかったものを読み、出典付きのレポートと主張台帳を返します。

/deepresearch what changed in EU AI Act enforcement this year
/deepresearch --rounds 5 does creatine improve strength in trained adults
/deepresearch --web only use the public web for this merger timeline

/researchと/deep-researchは同じコマンドです。手早いチャットの返答ではなく、確認できる出典のある調査済みの回答がほしいときに使ってください。一行で済む調べものや、/goalに任せるべきゴールのあるタスクには使わないでください。

フラグ

フラグ動作
--rounds Nラウンドの予算を1から6の間で設定します。デフォルトは3です。-rや--rounds=Nも使えます。
--webワークスペースのファイルを省き、公開ウェブだけで調査します。--web-onlyも同じです。
--resume強制中断された実行を続行します。--continueも同じです。

質問なしで/deepresearchだけを実行すると、ヘルプが表示され、使用量は消費されません。再開待ちの実行がある場合は、そのことも知らせます。

返ってくるもの

チャットの返答は、レポート、番号付きの出典リスト、主張台帳です。台帳は三つの区分に分かれます。あなたのファイルに裏付けられたもの、ウェブのみのもの、裏付けのないものです。返答では裏付けのある主張と裏付けのない主張が強調され、完全な記録には三つすべてが載ります。

デスクトップとCLIでは、完全なレポート、計画、すべての出典、完全な台帳を含むMarkdownファイルもperch-research/の下に書き出されます。このファイルが、その実行の恒久的な記録です。

再開とその期限

強制中断されると実行は待機状態になり、/deepresearch --resumeで続行できます。猶予は約45分です。それを過ぎると待機は期限切れになり、元の質問からやり直します。正常にキャンセルした場合は、代わりに途中までのレポートが書き出され、再開できるものは残りません。

--webでは、あなたのファイルに裏付けられた主張は出てきません。フォルダ内にまだインデックス済みのものがなければ、インデックスを作成するまで同じことが言えます。

/delegate

/delegate <task>は、範囲の決まったタスクをバックグラウンドエージェントに引き渡し、あなたにはプロンプトを返します。エージェントは非同期で動き、結果をレビュー用に返すため、長いジョブが今いるセッションを妨げることはありません。/bg <task>は同じコマンドの短い形です。

/delegate summarize every PDF in ./contracts and list the renewal dates

タスクが自己完結していて、実行を眺めているより自分の作業を続けたいときに使ってください。途中であなたの入力が必要なタスクや、操舵したいタスクは、メインのセッションに残しておきましょう。

/flock

/flock <task>は、ひとつの難しいタスクにワーカーのチームをあて、結果があなたに届く前にチェッカーのワーカーが検証します。実験的な機能でコマンドメニューには表示されませんが、デスクトップアプリとCLIで使えます。

/flock review this branch for regressions and verify the tests

一度きりの確認では足りない作業のためのもので、通常のターンのほうが速いため、小さなタスクは開始前に断られます。チームの編成と進行についてはFlockを参照してください。

セッションコマンド

これらはタスクを実行せず、セッションについて何かを変更または表示します。

コマンド動作対象
/model [tier|name]モデルの表示または設定。Roostティアか、モデルの固定指定です。モデルティアを参照。両方
/usageプランに含まれる使用量(Perch Token)と、このセッションの使用量を表示します。両方
/compact古いターンを要約してコンテキストウィンドウを空けます。デスクトップ
/contextコンテキストメーターと圧縮の詳細を表示します。CLI
/persona [saffron|quill]口調の表示または切り替え。ペルソナを参照。CLI
/mode [ask|agents|plan]チャットモードの表示または設定。CLI
/permission [mode]Perchが確認なしでどこまで進められるかの表示または設定。CLI
/thinking [on|off]選択中のモデルの拡張思考の表示または切り替え。CLI
/local-tools [on|off]ローカルのシェルとファイルツールの表示または切り替え。CLI
/cwd [dir]作業ディレクトリの表示または変更。CLI
/thread [new|id]現在のスレッドIDの表示、リセット、設定。CLI
/skills [name]Perchのコアスキルを一覧表示するか、ひとつのスキルの本文を表示します。CLI
/memory-audit <text>メモがメモリに保存されるかどうかと、その理由を確認します。メモリを参照。CLI
/statuscwd、認証、モード、ペルソナ、権限、スレッドを表示します。CLI
/clearこのターミナルセッションのローカルの会話メモリを消去します。CLI
/helpすべてのコマンド一覧を表示します。CLI
/login、/logoutブラウザのOAuthでサインインするか、保存済みの認証を消去します。CLI
/exitCLIを終了します。CLI

Perchの作業中に

ターンの終了を待たなくても操舵できます。テキストを入力してEnterを押せば、ターンの途中で指示を追加できます。CLIではCtrl-Cで現在のターンを止め、Ctrl-Eで詳細を展開します。

次のステップ