増えていく意図を整理する

文書が重複したり、関連する話題が離れたり、内容を統合したくなったらソースを整理を使います。Agent が全意図ドキュメントの整理案を作り、レビューしてから適用を決めます。

先に現在の編集を保存してください。承認するまで意図ドキュメントは変わりません。

整理を始める

サイドバーの意図見出しにポインターを重ね、整理ボタンをクリックして確認します。進行状況と実行トレースを示す整理チャットが開きます。

先に設定 → 現在のプロジェクト → 操作で、ソースを整理の Agent、モデル、推論の強度を選べます。

実行中はサイドバーに整理案が現れ、文書ツリーと変更マーカーを表示します。文書を開くと作成中の下書きをプレビューできます。進行に合わせて更新され、編集はできません。

全体の変更を確認する

完了するとカードに要約、変更統計、文字数比較、推奨事項が表示されます。本文を読む前に、対象ファイルと統合・移動した内容を確認します。

整理案欄には提案する階層と、追加、削除、名前変更、移動の印が出ます。項目をクリックしてレビューします。

整理後の下書きと現在の文書は別の表示なので、並べて比較できます。

削除案を確認する

整理レビューは提案文書全体を読み取り専用で表示します。削除対象はその位置に残り、薄赤の背景、取り消し線、理由が付きます。

削除案は承認時に既定で取り除きます。まだ必要な要件は保持を選びます。ファイル全体の削除ならファイル全体を保持を選べます。判断は保存され、再起動後も残ります。

下部ナビゲーションでファイルをまたいで削除案を確認できます。リスト項目や表の行は元の構造を保ち、文脈の中で判断できます。

現在の文書と比較する

原文と比較で現在の文書を反対側に開きます。複数ファイルを統合した下書きでは、比較する元文書を選びます。

特に次を確認します。

• 同じ連続期間で報酬は一回などの条件が統合・書き換えで失われていませんか。
• 異なる状況のルールが混ざり、適用範囲が曖昧になっていませんか。
• 有効な要件を削除していませんか。機能の完成は意図を消す理由にはなりません。
• 分かりやすい表現で、一度だけの作業指示を継続的な要件に変えていませんか。

整理は表現を改善するもので、要件をひそかに変えるものではありません。制約と機能の削除の違いは大切な意図を書くをご覧ください。

案全体を承認・却下する

確認後、承認します。保持する内容を選んだ場合は件数がボタンに表示されます。承認は文章と構造を含む案全体に適用されます。

却下すると案は適用しません。現在の文書を編集し、後から再整理できます。

文章を変更する整理案を承認すると、実装の説明が自動更新されます。ファイル名や構成だけなら説明を起動しません。この自動更新は「実装後に自動的に説明」の設定とは独立しています。設定はAgent、モデル、使用量をご覧ください。

古くなった整理案に対応する

作成後に現在の意図が変わると案が古くなり、承認が無効になってもう一度整理が表示されます。レビュー中に現在の文書を保存すると、無効になる可能性を警告します。

下書きをさらに書き直すには、却下して現在の文書を編集し、再整理します。通常の提案の新規文章とは異なり、整理レビューの文章は直接編集できません。

保留できる整理案は一つだけです。別の整理を始めると古い案を破棄することを確認します。

次に説明の更新が必要か確認しましょう。