debrief

Debrief

現在のタスクから得られた証拠を、意見を反映したインタラクティブな HTML レポートとして保存します。--md を指定すると、簡潔な Markdown で保存します。

出力と権限

• デフォルト：インストール済みの playground スキルを使って ./.ai/debriefs/<slug>/index.html に保存します。
• --md：./.ai/debriefs/<slug>/index.md に保存します。playground への依存はありません。
• slug が省略された場合は、トピックに沿った短いケバブケースの slug を作成します。
• 選択したデブリーフィング用ディレクトリ内にのみ書き込みます。出力がすでに存在する場合は、上書きするか、新しい slug を選ぶかをユーザーに確認してから進めます。
• 現在のタスクに含まれる証拠のみを使用します。実際の調査結果、パス、確認済みの場所、指標、決定事項、未解決のリスクを使用し、内容を埋めるために情報を作り出さないでください。

ワークフロー

1. 対象リポジトリから同梱の準備スクリプトを実行します。

   bash <skill-dir>/scripts/prepare.sh [--md] <slug>
   

   出力された MODE、PLAYGROUND_DIR、DEBRIEF_PATH、EXISTS を使用します。依存関係または slug に関するエラーはそのまま伝え、処理を中止します。

2. HTML を作成する場合は、解決された playground の SKILL.md と、一致するテンプレートを1つだけ読み込みます。テンプレートは、差分レビュー、ドキュメント批評、コードマップ、コンセプトマップ、データエクスプローラー、デザインプレイグラウンドから選びます。証拠に合わせてインタラクションモデルを調整し、すべてのテンプレートを読み込まないでください。

3. 自己完結型のファイルを1つ作成します。

   • HTML では、playground のライブコントロール、実用的なプリセット、証拠ビュー、自然言語のプロンプト出力、コピー時のフィードバックを維持します。外部依存は使用しません。
   • Markdown では、要点を最初に示し、その後に重要度、証拠、提案を含む簡潔な調査結果と、実行可能な次のステップを記載します。正確なテキストが重要な場合のみ、スニペットを使います。

4. すべての主張がタスクの会話記録またはツールの証拠に基づいていること、出力にプレースホルダーが含まれていないこと、ファイルが開いて正しくレンダリングされることを確認します。その後、open "$DEBRIEF_PATH" を実行し、絶対パスを報告します。

完了には、選択したパスにプレースホルダーではないデブリーフィングが存在すること、内容が証拠に基づいていること、レンダリングとファイルの検査が正常に完了していること、上書きの扱いが明示されていることが必要です。