iCode Agent · ガイド · ワークフロー

モジュールをリファクタリングする。

リファクタリングの大半は理解です。何がこれを呼び、これが何を呼び、形を変えても何が成り立ち続ける必要があるのか。iCode Agent は何かを編集する前に、実際のコードに対してその対応関係を洗い出します。

タスク

モジュールと望む変更を伝え、まず影響範囲を洗い出させます。

Refactor src/report/builder.ts. Extract the formatting into a
separate module, update all callers, and make sure the tests still pass.

ファイルを指定すると作業範囲が定まります。変更箇所がわからない場合は、ゴールを伝えてエージェントに境界を見つけさせても構いません。ただし対象を指定したほうが変更は焦点を保てます。

何が起こるか

  1. 全体像をつかむ。grep と find でモジュールの呼び出し元を特定し、read で行番号付きのコードを表示するため、エージェントは構造を推測せずに把握できます。
  2. 変更を計画する。何を移し、何を残し、どの呼び出し元を更新すべきかを特定します。
  3. 小さなステップで編集。edit は一度に 1 つの正確な範囲だけを置き換えて diff を表示するので、レビューでは書き換えられたファイルではなく変更そのものを確認できます。
  4. テストを緑に保つ。テストスイートを実行します。これがリファクタリングを危険なものではなく安全なものにするセーフティネットです。

全体が書き換えられることはありません。edit は対象の範囲を変更し、write は本当に新しいファイルにのみ使われます。承認する前に diff は常に表示されます。

diff をレビューする

ここが価値を生む場面です。エージェントが提案し、あなたが決めます。優れたリファクタリングのプロンプトは、結果だけでなく検証できる根拠を求めます。

Refactor the auth module. Show me the callers you found first,
then make the smallest change that removes the duplication.
Run the tests after each file you touch.

変更が誤っている場合は、後から戻すのではなくタスクの途中で方向を指示してください。エージェントはまだ何もコミットしていないため、軌道修正は低コストです。

このワークフローに適したプロンプト

Find every caller of parseConfig() before changing its signature.
Extract the duplicated retry logic into one helper and update both call sites.
Explain what this module does, then suggest a refactor — but make no edits yet.

最後のプロンプトは意図的に読み取り専用です。分析を依頼し、それを読んでから変更を依頼します。大規模なリファクタリングでは、多くの場合こちらの形が適しています。