PerchAI
Perchの使い方

Ask、Plan、Agents

三つのチャットモードが、そのターンが答えるだけなのか、承認を待つ計画を書くのか、実際に作業するのかを決めます。権限モードとは別もので、そちらは確認なしでどこまで走るかを決めます。

Perch TerminalとCLIのすべてのターンは、三つのチャットモードのいずれかで動きます。Perchが望みより多く、あるいは少なく動いていると感じたら、まず触るべきはモードです。

モードそのターンがすること
Askチャットだけから答えます。ツールは使わず、何も変わりません。
Plan読み取りだけで周囲を見て、計画を書き、何かを変える前にあなたの承認を待ちます。
Agents実際に作業します。権限モードが許す範囲で、ファイルを読み書きし、コマンドを実行し、コネクターを使います。

入力欄のモードメニューで切り替えるか、CLIでは/mode ask、/mode plan、/mode agentsを使います。/modeだけなら現在のモードを表示します。

Ask

Askは、作業をするのではなく作業について話すためのモードです。Perchは会話だけから答え、ツール呼び出しはいっさい行わないので、何も読まれず、書かれず、実行されません。考えを声に出して整理したいとき、ある進め方だと何が必要になるのか尋ねたいとき、あるいはファイルの読み込みが連発するのではなく手短な答えがほしいときに使ってください。

Plan

Planは、起きる前に目を通しておきたい作業のためのモードです。Perchはワークスペースを調べ、ファイルを読み、検索し、それから計画を書きます。計画している間は、何かを変えるものは一切動きません。変更を加えるツールはすべてブロックされたままなので、ファイルが手つかずだと分かったうえで計画を読めます。

返ってくるのは、タイトル、目的、手順の載った計画カードです。デスクトップではカードが履歴のなかに残り、その下に承認と却下が並びます。CLIでは出力されて、こう尋ねます。

Plan ready for approval: Fix the failing auth tests
Approve and execute this plan? [y]es / [n]o:

計画はあなたのフォルダーにも、.perch/plans/の下のmarkdownとして書き出されます。エディターで読んだり、取っておいたり、誰かに渡したりできます。

  • 承認するとPerchは実行を始めます。作業のあいだ、チャットモードはAgentsに戻ります。
  • 却下すると何も動きません。何を変えるか伝えれば、Perchが計画を直します。

大きなリファクタリング、大事なファイルに触れる作業、不慣れなリポジトリでの最初の作業では、Planが妥当な既定です。

Plan is also a permission mode

ややこしいことに、Planは二か所に出てきます。チャットモード(/mode plan)と権限モード(/permission plan)です。どちらも違う方向から同じことをしていて、どちらを設定しても、計画が承認されるまで変更を加えるツールはブロックされたままになります。実務上の違いは、権限モードのほうは自分で変えるまで残り続けることです。

Agents

Agentsは作業モードで、ほとんどのターンはここで動きます。Perchは読み、編集し、コマンドを実行し、コネクターを呼び、補助のエージェントを立て、ブラウザを操作します。そのうちどれだけがあなたに尋ねずに起きるかは、チャットモードの管轄ではありません。それは権限モードの話です。

チャットモードと権限モードは別の設定です

身につけておく価値のある区別はこれです。

  • チャットモードは、そのターンがどんな種類かを決めます。答えるのか、計画するのか、作業するのかです。
  • 権限モードは、ターンが作業に入ったあと、どこまでがあなたに尋ねずに走るかを決めます。

権限がDefaultのままのAgentsモードのターンは、最初の書き込みやコマンドで止まって確認します。Take the WheelのAgentsモードのターンは、まったく止まりません。Default、Auto Review、Take the Wheel、Planがそれぞれ何を許すかは権限モードを参照してください。

モードが効く場所

三つのチャットモードはPerch Terminal、つまりデスクトップアプリとCLIの一部です。Perch AI Webにモードメニューはありません。答えるだけで、ウェブ検索がオンなら検索もします。働きかける対象になるローカルのファイルやターミナルもありません。