← プロジェクト一覧に戻る

Planning with Files
計画を3つのファイルとしてディスクに置き、毎ターン読み直させる。文脈が消えても計画は残る
エージェントスキルMIT
Planning with Filesとは
長い作業には特有の壊れ方があります。エージェントは計画を持っていたのに、文脈が消去または圧縮され、戻ってきたエージェントが自信満々に別の仕事を仕上げてしまう、という壊れ方です。このスキルは計画を会話から外し、ディスク上に移します。計画のファイル、分かったことのファイル、済んだことのファイルの3つで、毎ターンそれらをエージェントの目の前に戻します。計画がファイルである以上、消去や異常終了、圧縮を越えて残り、実行中に人が自分で読むこともできます。任意で有効にできる関門は、計画がそう示すまでエージェントに完了を宣言させません。開発元は盲検のA/B比較結果を公開しており、これは多くのスキルにはない点です。
Planning with Filesで何ができますか?
- 文脈の消去を越えて残る — 計画は会話ではなくディスク上にあるため、文脈の消去や異常終了、圧縮が起きても、何をしていたかが失われません。
- 毎ターン計画を差し戻す — エージェントの記憶に任せず、フックが毎ターンファイルを読み直させます。計画と単なる提案の違いはここにあります。
- 実行中に人が計画を読む — リポジトリ内の普通のMarkdownファイルなので、途中で開いて、エージェントが今どう認識しているかを確認できます。
- 分かったことと進捗を分ける — 学んだ内容と完了した内容が別のファイルになっているため、途中の発見がチェックリストの中に埋もれません。
- 早すぎる完了を拒む — 任意の関門を有効にすると、計画ファイルが認めるまでエージェントは完了を宣言できません。自信を伴う早期終了を防げます。
Planning with Filesを選ぶ前に
- 作業用のファイルがプロジェクト内に書き出されます。版管理に含めるかどうかを早めに決めてください。誤ってコミットされた計画ファイルは履歴の雑音になります。
- 毎ターン計画を読み直させる分、毎ターン費用がかかります。迷走する長い作業に比べれば安いものですが、計画の要らない短い作業では割に合いません。
スター推移
8月29日〜10月30日 · +1.4k
26.4k27.8k
よくある質問
Planning with Filesは商用利用できますか?
Planning with FilesはMITライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。
Planning with Filesはどの形で使えますか?
Planning with Filesはローカル実行の形で利用できます。