プロジェクトハンドオフ は何をしますか？
新しいエージェントが会話を引き継ぐことなく作業を続行できるように、現在のスナップショットを作成します。自分で会話をクリアしないでください。
1. 宛先を解決する
ハンドオフ先のターゲットを作成前に決定します:
- 呼び出し時に指定された明示的なディレクトリを優先します。正規化して、存在することを確認します。
- それ以外の場合は、このセッションで実際に議論、読み取り、作成、編集されたディレクトリとファイルから候補を推測します。
- 現在の作業ディレクトリ、Codexワークスペースルート、バージョン管理ルート、および
README.md、AGENTS.md、package.json、pyproject.tomlなどのプロジェクトマーカーはシグナルとしてのみ扱います。いずれも単独では信頼できず、プロジェクトがGitを使用する必要はありません。 - セッションの証拠が明確に1つの候補を裏付けている場合にのみ、質問せずに進みます。
- 宛先がないか曖昧な場合は、可能性のある候補を示し、1つの簡潔な質問をします:
HANDOFF.md 要写到哪个目录？推測しないでください。
複数の独立したプロジェクトが変更された場合は、それぞれに個別の HANDOFF.md を作成し、書き込み前にその宛先を確認することを推奨します。
2. 実際の状態を検査する
各ターゲットディレクトリを解決した後:
- 関連するセッション作業を確認し、ターゲットの構造、指示、主要なドキュメント、実装ファイル、出力を検査します。
- バージョン管理が存在する場合は、そのステータスと関連する変更を検査します。存在しない場合は、エラーとして扱わずに続行します。
- 既存のテストまたは検証の証拠を使用します。有用な場合にのみ、軽量で安全なチェックを実行します。依存関係をインストールしたり、無関係なプロジェクト変更を行ったりしないでください。
- 既存の
HANDOFF.mdを更新する前に読み取ります。まだ有効な情報は保持し、古いステータスは置き換え、新たに完了した作業は残作業セクションから移動します。
ファイルシステムの証拠が利用可能な場合は、会話の記憶だけに依存しないでください。
3. HANDOFF.md を書く
以下のセクションを含む簡潔な現在状態ドキュメントとして、<confirmed-target>/HANDOFF.md を作成または更新します:
# プロジェクトハンドオフ
> 更新日: YYYY-MM-DD
> ターゲット: /absolute/confirmed/path
## 現在の状態と構造
## 完了したケース
## 決定事項と規約
## 残作業と正確な次のステップ
## 落とし穴と行き詰まり
## 検証、リスク、未解決の質問
以下のルールを適用します:
- 完了したケースには、具体的な成果とプロジェクト相対のファイルまたはディレクトリパスを示します。
- 決定事項、技術的選択、スタイルや命名規則、およびその理由を記録します。必要に応じて証拠の場所を含めます。
- 残作業は実行可能にします: 優先順位、正確な開始ファイルまたはコマンド、ブロッカー、完了条件。
- 失敗したアプローチとその理由を記録し、次のエージェントが繰り返さないようにします。
- 実行したテストやチェックとその結果を記述します。検証されなかったことを明示的に述べます。
- 観察された事実とセッションの主張や推測を区別します。不確実性は
待確認とマークします。完了、決定、テスト結果を決して捏造しないでください。 - 絶対日付、簡潔な散文、パスを使用し、トランスクリプト形式のナレーションは避けます。
- 資格情報、トークン、個人情報、環境ファイルの内容、大きな生ログを決して含めないでください。
- ファイルを追記専用の履歴ではなく、最新のハンドオフスナップショットとして維持します。
ユーザーが明示的に他の変更を要求しない限り、目的の HANDOFF.md のみを変更します。
4. 確認して報告する
完了したファイルを再読み込みし、以下を確認します:
- 確認されたディレクトリにあること。
- 必要なセクションがすべて存在すること。
- 次のアクションが新しいエージェントがすぐに開始できるほど具体的であること。
- 主張、パス、日付、検証ステータスが利用可能な証拠と一致していること。
- 機密情報がドキュメントにコピーされていないこと。
書き込まれたパス、簡単な要約、および未解決の不確実性を報告します。ユーザーが手動で /clear を実行する前にハンドオフを確認できるように、そこで停止します。