計画モード
このスキルは、ユーザーが実行ではなく計画を希望する場合に使用します。
基本動作
このターンでは、計画のみを行います。
- コードを実装しないでください。
- プランのマークダウンファイル以外のプロジェクトファイルを編集しないでください。
- ターミナルコマンドの実行、コミット、プッシュ、外部アクションを行わないでください。
- リポジトリやその他のコンテキストを調査する場合に限り、読み取り専用のコマンドやツールを使用しても構いません。
- 成果物は、アクティブなワークスペースの
.hermes/plans/配下に保存されたマークダウンプランです。
出力要件
具体的で実行可能なマークダウンプランを作成します。
必要に応じて以下を含めます:
- 目標
- 現在のコンテキスト / 前提
- 提案するアプローチ
- ステップバイステップの計画
- 変更される可能性のあるファイル
- テスト / 検証
- リスク、トレードオフ、未解決の質問
タスクがコード関連の場合は、正確なファイルパス、テストターゲット、検証手順を含めてください。
保存場所
write_file を使用して以下のパスにプランを保存します:
.hermes/plans/YYYY-MM-DD_HHMMSS-<スラッグ>.md
これをアクティブな作業ディレクトリ / バックエンドワークスペースからの相対パスとして扱います。Hermes のファイルツールはバックエンドを認識するため、この相対パスを使用することで、プランはローカル、Docker、SSH、Modal、Daytona の各バックエンドでワークスペースと一緒に保持されます。
ランタイムが特定のターゲットパスを提供する場合は、そのパスを正確に使用します。
提供されない場合は、.hermes/plans/ 配下に、タイムスタンプを含む適切なファイル名を自身で作成します。
対話スタイル
- リクエストが十分に明確な場合は、直接プランを作成します。
/planに明示的な指示がない場合は、現在の会話コンテキストからタスクを推測します。- 本当に仕様があいまいな場合は、推測せずに簡潔な確認質問をします。
- プランを保存した後、計画した内容と保存先のパスを簡潔に伝えます。
優れたプランの書き方
このスキルの残りの部分は、上記のマークダウンファイルの内容となる、優れた実装計画を作成するための技法です。
概要
実装者がコードベースに関するコンテキストがゼロで、センスに疑問があると仮定して、包括的な実装計画を書きます。触るべきファイル、完全なコード、テストコマンド、確認すべきドキュメント、検証方法など、必要なものをすべて文書化します。タスクは細かく分割します。DRY、YAGNI、TDDを守り、頻繁にコミットします。
実装者は熟練した開発者だが、ツールセットや問題ドメインについてはほとんど知らず、優れたテスト設計もあまり理解していないと仮定します。
中心原則: 優れた計画は実装を明白にします。誰かが推測しなければならない場合、その計画は不完全です。
完全な実装計画が役立つ場合
以下の前に常に使用します:
- 複数ステップの機能を実装する場合
- 複雑な要件を分解する場合
- サブエージェント駆動開発を介してサブエージェントに委任する場合
以下の場合でも省略しないでください:
- 機能が単純に見える場合(仮定がバグを生むため)
- 自分で実装する予定の場合(将来の自分がガイダンスを必要とするため)
- 一人で作業している場合(ドキュメントが重要であるため)
タスクの細かさ
各タスク = 2〜5分の集中作業。