ベストプラクティス — 10のヒント | Easy Understand Hermes Agent

ベストプラクティス — 10のヒント

Hermes Agentを、忙しい厨房のシェフのように考えてみてください。すべての料理人に同じまな板で野菜を切りながら、同時にデザートの盛り付けをさせるようなことはしませんよね？それぞれに自分の作業スペースを与えるはずです。コードベースにも同じロジックが当てはまります。

1. 実験ごとに1つのワークツリーを使う

家のペンキ塗りを想像してみてください。リビングとバスルームを同じ刷毛で同時に塗ることはないでしょう？両方台無しにしてしまいますからね。Gitワークツリーを使えば、各Hermesタスクに専用の「部屋」を与えることができます。

Hermesがメインのプロジェクトフォルダ内のファイルを直接編集するのではなく、実験ごとに独立したワークスペースを作成しましょう。これにより、メインのコードを安全に保ち、変更内容も整理された状態を維持できます。

2. ブランチ名は実験内容に合わせて付ける

ブランチには明確で説明的な名前を付けましょう。そうすれば、あなた自身（そして未来のあなた）が、それぞれのブランチが何のためのものかすぐにわかります：

git checkout -b feature/hermes-checkpoints-docs

branch-1 や test-fix のような名前はやめましょう。具体的に！後であなた自身が感謝すること間違いなしです。

3. 頻繁にコミットする

コミットは、ビデオゲームでのセーブポイントのようなものだと考えてください。3時間プレイして、セーブしていなかったために全てを失うなんて嫌ですよね。

重要なマイルストーンでコミットしましょう：

git add .
git commit -m "Add checkpoint documentation"

その間にある、ツールによる細かな編集については、Hermesのチェックポイントと /rollback を安全網として使いましょう。

4. ベアリポジトリのルートから実行しない

ワークツリーを使用する場合、元のリポジトリフォルダからHermesを実行しないでください。代わりに、ワークツリーのディレクトリに cd しましょう。これにより、各エージェントの作業範囲が明確になり、意図しない相互汚染を防げます。

5. 自動ワークツリーには `hermes -w` を使う

ワークツリーを手動で設定したくないですか？Hermesには組み込みのショートカットがあります：

cd /path/to/your/repo
hermes -w

これにより、専用ブランチを持つ使い捨てのワークツリーが自動的に作成されます。単一のクエリと組み合わせることも可能です：

hermes -w -z "Fix issue #123"

6. 並行エージェントを安全に実行する

複数のHermesエージェントを同時に動かしたいですか？ターミナルをいくつか開いて、それぞれで hermes -w を実行するだけです。各セッションには、自動的に独立したワークツリーとブランチが割り当てられます。もうエージェント同士が干渉し合う心配はありません。

7. チェックポイントと `/rollback` を使う

ミスは起こります。それでいいんです。Hermesを使えば、セッション中にチェックポイントを作成し、何か問題が発生した場合にはそこにロールバックできます。まるでエージェントの操作に対する「元に戻す」ボタンのようなものです。

8. ワークツリー、ブランチ、チェックポイントを組み合わせる

これが勝利の方程式です：

ワークツリー = 各セッションのためのクリーンなチェックアウト
ブランチ = 実験の大まかな履歴
チェックポイント + /rollback = ミスからの迅速な回復

これらを組み合わせることで、高速なイテレーション、簡単なリカバリ、そしてクリーンなプルリクエストを実現できます。

9. UI開発をスマートに処理する

複数のワークツリーでTUIやデスクトップアプリを開発している場合、それぞれに node_modules が必要になります。これは多くの重複ファイルを生み出します。シンボリックリンクで1つのインストールを共有する htui / hgui ヘルパーをチェックしてみてください。ディスク容量とセットアップ時間を節約できます。

10. メインブランチをクリーンに保つ

これらのプラクティスの要点は、メインブランチを安定した本番稼働可能な状態に保つことです。ワークツリーのブランチは、テストが完了し、完成した場合にのみマージしましょう。

まとめ

ワークツリーを、オフィスにある独立したデスクだと考えてみてください。各Hermesエージェントは、自分のツールを備えた自分のデスクを持つので、誰かの作業を台無しにすることはありません。ブランチはファイリングシステム、チェックポイントは「ここまでやった」という付箋紙のようなものです。

実用的なヒント： 次のタスクでは、まず hermes -w を使ってみましょう。手動設定なしで分離環境を得る最も簡単な方法です。慣れてきたら、チェックポイントとロールバックをワークフローに追加してみてください。それなしではどうやって作業していたのか、不思議に思うはずです。