プランモード
ユーザーが実行ではなく計画を必要とする場合に、このスキルを使用します。
コア動作
このターンでは、あなたは計画のみを行います。
- コードを実装しないでください。
- 計画のMarkdownファイル以外のプロジェクトファイルを編集しないでください。
- 変更を伴うターミナルコマンドの実行、コミット、プッシュ、または外部アクションを行わないでください。
- 必要に応じて、読み取り専用のコマンドやツールでリポジトリやその他のコンテキストを調査しても構いません。
- 成果物は、アクティブなワークスペースの
.hermes/plans/に保存されるMarkdown形式の計画です。
出力要件
具体的で実践可能なMarkdown計画を作成してください。
該当する場合、以下を含めてください:
- 目標
- 現在のコンテキスト / 前提
- 提案するアプローチ
- ステップバイステップの計画
- 変更される可能性のあるファイル
- テスト / 検証
- リスク、トレードオフ、未解決の質問
タスクがコード関連の場合は、正確なファイルパス、テスト対象の候補、および検証手順を含めてください。
保存場所
write_file を使用して、以下の場所に計画を保存します:
.hermes/plans/YYYY-MM-DD_HHMMSS-<スラッグ>.md
これは、アクティブな作業ディレクトリ / バックエンドワークスペースからの相対パスとして扱います。Hermesのファイルツールはバックエンドを認識するため、この相対パスを使用することで、ローカル、Docker、SSH、Modal、Daytonaの各バックエンドで計画がワークスペースに保持されます。
ランタイムが特定のターゲットパスを提供する場合は、その正確なパスを使用します。
そうでない場合は、.hermes/plans/ の下に、適切なタイムスタンプ付きのファイル名を自分で作成します。
対話スタイル
- リクエストが十分に明確な場合は、直接計画を作成します。
/planに明示的な指示がない場合は、現在の会話コンテキストからタスクを推測します。- 本当に仕様が不十分な場合は、推測する代わりに簡単な確認質問をします。
- 計画を保存した後、計画した内容と保存したパスを簡単に返信します。
良い計画の書き方
このスキルの残りの部分は、上記のMarkdownファイル内に入れる良い実装計画を作成する技術です。
概要
実装者がコードベースに関するコンテキストがなく、センスも疑わしいことを前提として、包括的な実装計画を作成します。必要なものをすべて文書化します: 触れるファイル、完全なコード、テストコマンド、確認すべきドキュメント、検証方法。細かく分割されたタスクを与えてください。DRY。YAGNI。TDD。頻繁なコミット。
実装者は熟練した開発者であるが、ツールセットや問題領域についてはほとんど何も知らないことを前提とします。また、優れたテスト設計についてはあまり知らないことを前提とします。
中核的な原則: 良い計画は実装を明白にします。誰かが推測しなければならない場合、その計画は不完全です。
完全な実装計画が役立つ場合
以下の前には常に使用:
- 複数ステップの機能の実装
- 複雑な要件の分解
- サブエージェント駆動開発によるサブエージェントへの委譲
以下の場合はスキップしない:
- 機能が単純に見える場合(前提がバグを引き起こす)
- 自分で実装する予定の場合(将来の自分がガイダンスを必要とする)
- 一人で作業している場合(ドキュメントは重要)
細分化されたタスクの粒度
各タスク = 2〜5分の集中作業。
すべてのステップは1つのアクションです:
- 「失敗するテストを書く」 — ステップ
- 「失敗することを確認するために実行する」 — ステップ
- 「テストが通る最小限のコードを実装する」 — ステップ
- 「テストを実行して通ることを確認する」 — ステップ
- 「コミットする」 — ステップ
大きすぎる例:
### タスク1: 認証システムを構築する
[5ファイルにわたる50行のコード]
適切なサイズ:
### タスク1: メールフィールドを持つUserモデルを作成する
[10行、1ファイル]
### タスク2: Userにパスワードハッシュフィールドを追加する
[8行、1ファイル]
### タスク3: パスワードハッシュユーティリティを作成する
[15行、1ファイル]
計画書の構造
ヘッダー(必須)
すべての計画は次で始まる必要があります:
# [機能名] 実装計画
> **Hermes向け:** サブエージェント駆動開発スキルを使用して、この計画をタスクごとに実装します。
**目標:** [これが何を構築するかを一文で説明]
**アーキテクチャ:** [アプローチについて2〜3文]
**技術スタック:** [主要な技術/ライブラリ]
---
タスク構造
各タスクは次の形式に従います:
### タスクN: [説明的な名前]
**目的:** このタスクが達成すること(一文)
**ファイル:**
- 新規作成: `exact/path/to/new_file.py`
- 変更: `exact/path/to/existing.py:45-67`(行番号がわかっている場合)
- テスト: `tests/path/to/test_file.py`
**ステップ1: 失敗するテストを書く**
```python
def test_specific_behavior():
result = function(input)
assert result == expected
```
**ステップ2: テストを実行して失敗を確認する**
実行: `pytest tests/path/test.py::test_specific_behavior -v`
期待結果: FAIL — "function not defined"
**ステップ3: 最小限の実装を書く**
```python
def function(input):
return expected
```
**ステップ4: テストを実行してパスを確認する**
実行: `pytest tests/path/test.py::test_specific_behavior -v`
期待結果: PASS
**ステップ5: コミットする**
```bash
git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"
```
作成プロセス
ステップ1: 要件を理解する
以下を読み、理解します:
- 機能要件
- 設計ドキュメントまたはユーザーの説明
- 受け入れ基準
- 制約条件
ステップ2: コードベースを探索する
Hermesツールを使用してプロジェクトを理解します:
# プロジェクト構造を理解する
search_files("*.py", target="files", path="src/")
# 類似機能を確認する
search_files("similar_pattern", path="src/", file_glob="*.py")
# 既存のテストを確認する
search_files("*.py", target="files", path="tests/")
# キーファイルを読む
read_file("src/app.py")
ステップ3: アプローチを設計する
以下を決定します:
- アーキテクチャパターン
- ファイル構成
- 必要な依存関係
- テスト戦略
ステップ4: タスクを書く
タスクを順序通りに作成します:
- セットアップ/インフラ
- コア機能(各TDD)
- エッジケース
- 統合
- クリーンアップ/ドキュメント
ステップ5: 完全な詳細を追加する
各タスクについて、以下を含めます:
- 正確なファイルパス(「設定ファイル」ではなく
src/config/settings.py) - 完全なコード例(「バリデーションを追加」ではなく実際のコード)
- 期待される出力を含む正確なコマンド
- タスクが機能することを証明する検証手順
ステップ6: 計画をレビューする
以下を確認:
- タスクが順序通りで論理的である
- 各タスクが細分化されている(2〜5分)
- ファイルパスが正確である
- コード例が完全である(コピーペースト可能)
- コマンドが正確で期待される出力がある
- 欠落しているコンテキストがない
- DRY、YAGNI、TDDの原則が適用されている
原則
DRY(Don't Repeat Yourself)
悪い例: 3箇所でバリデーションをコピーペースト 良い例: バリデーション関数を抽出し、あらゆる場所で使用
YAGNI(You Aren't Gonna Need It)
悪い例: 将来の要件のために「柔軟性」を追加 良い例: 今必要なものだけを実装
# 悪い例 — YAGNI違反
class User:
def __init__(self, name, email):
self.name = name
self.email = email
self.preferences = {} # まだ必要ない!
self.metadata = {} # まだ必要ない!
# 良い例 — YAGNI
class User:
def __init__(self, name, email):
self.name = name
self.email = email
TDD(Test-Driven Development)
コードを生成するすべてのタスクには、完全なTDDサイクルを含める必要があります:
- 失敗するテストを書く
- 実行して失敗を確認する
- 最小限のコードを書く
- 実行してパスを確認する
詳細は test-driven-development スキルを参照してください。
頻繁なコミット
すべてのタスク後にコミットします:
git add [files]
git commit -m "type: description"
よくある間違い
曖昧なタスク
悪い例: 「認証を追加」 良い例: 「emailとpassword_hashフィールドを持つUserモデルを作成」
不完全なコード
悪い例: 「ステップ1: バリデーション関数を追加」 良い例: 「ステップ1: バリデーション関数を追加」の後に完全な関数コード
検証の欠落
悪い例: 「ステップ3: 動作をテスト」
良い例: 「ステップ3: pytest tests/test_auth.py -v を実行、期待結果: 3 passed」
ファイルパスの欠落
悪い例: 「モデルファイルを作成」
良い例: 「新規作成: src/models/user.py」
実行の引き継ぎ
計画を保存した後、実行アプローチを提案します:
「計画が完了し、保存されました。サブエージェント駆動開発を使用して実行する準備ができています — タスクごとに新しいサブエージェントを投入し、2段階レビュー(仕様準拠確認→コード品質確認)を行います。続行しましょうか?」
実行時は、subagent-driven-development スキルを使用します:
- 各タスクに対して完全なコンテキストを持つ新しい
delegate_task - 各タスク後の仕様準拠レビュー
- 仕様合格後のコード品質レビュー
- 両方のレビューが承認された場合のみ続行
覚えておくこと
細分化されたタスク(各2〜5分)
正確なファイルパス
完全なコード(コピーペースト可能)
期待される出力を含む正確なコマンド
検証手順
DRY、YAGNI、TDD
頻繁なコミット
良い計画は実装を明白にします。