structured-output

構造化された出力

使用する場面

• レビューや分析をまとめるとき。
• 具体的な次のステップを明示し、調査結果を一貫した形式でまとめるとき。
• 関係者に結果を提示する前、またはドキュメントに反映する前。

使用しない場面

• 分析中に証拠を記録するときは、proof-of-work を使用します。
• 変更をレビューするときは、まず diff-analysis または review-core を使用します。

有効化のパターン

トリガーキーワード：format、structure、deliverable、report、organize、present、consistent
文脈上の手がかり：

• 「これをレポートとして整形する」または「出力を構成する」
• 「成果物を作成する」または「調査結果を提示する」
• 「一貫性のある形で整理する」または「形式を標準化する」
• 「実行可能な内容にする」または「関係者向けに準備する」

自動的に読み込む場合：分析の成果物をまとめるとき、または一貫した形式が求められるとき。

必須の TodoWrite 項目

1. structured-output:template-selected
2. structured-output:findings-formatted
3. structured-output:actions-assigned
4. structured-output:appendix-attached

対応する手順が完了したら、各項目を完了済みにします。

手順 1：テンプレートを選択する（structured-output:template-selected）

• 成果物の種類に応じて出力形式を選択します。
  • レビュー報告書：概要、調査結果、推奨事項、証拠。
  • PR の説明：概要、変更内容、テスト計画、注記。
  • リリースノート：主な内容、破壊的変更、修正、謝辞。
  • インシデント報告書：タイムライン、影響、根本原因、是正措置。
• 対象読者と必要な詳細レベルを確認します。

手順 2：調査結果を整形する（structured-output:findings-formatted）

• 一貫した調査結果の形式を使用します。

  ### [SEVERITY] Finding Title
  **Location**: file.rs:123
  **Anchor**: `verbatim source text copied from line 123`
  **Category**: Security | Performance | Correctness | Style
  **Description**: Brief explanation of the issue.
  **Evidence**: [E1, E2] - Reference to evidence log.
  **Recommendation**: Specific remediation steps.
  

  検証： --help フラグを付けてコマンドを実行し、利用可能であることを確認します。
• 重大度レベル：CRITICAL、HIGH、MEDIUM、LOW、INFO。
• 重大度の高い順に並べ、同じ重大度ではファイル内の位置順にします。
• アンカーは必須であり、調査結果の根拠となります。 Location にあるソーステキストを正確にコピーします（言い換えは不可）。2 回目の確認で調査結果が実在するかを検証するために、再読されるテキストです。引用された行にアンカーが見つからない場合、その調査結果は幻覚として扱われ、除外されます。確認は機械的に行われます。imbue:review-core の手順 5 では、調査結果に対して plugins/imbue/scripts/citation_verifier.py を実行します。

手順 3：アクションを割り当てる（structured-output:actions-assigned）

• 担当者と優先度を付けて、調査結果をアクション項目に変換します。

  ## Action Items
  - [ ] [HIGH] Fix SQL injection in auth.py:45 (@security-team, P1)
  - [ ] [MEDIUM] Add input validation to API endpoint (@backend, P2)
  - [ ] [LOW] Update deprecated dependency (@devops, P3)
  

  検証： --help フラグを付けてコマンドを実行し、利用可能であることを確認します。
• 判明している場合は、担当者を明記します。
• トリアージ用に優先度の指標（P1/P2/P3）を追加します。
• アクション間の依存関係を記載します。

手順 4：付録を添付する（structured-output:appendix-attached）

• 補足資料をまとめます。

  ## Appendix
  ### A. Commands Run
  [Full evidence log from imbue:proof-of-work]
  
  ### B. External References
  [Citations and documentation links]
  
  ### C. Raw Data
  [Large outputs, full diffs, or data exports]
  

  検証： --help フラグを付けてコマンドを実行し、利用可能であることを確認します。
• 本文は簡潔にし、詳細は付録に記載します。
• 明確なセクション見出しを設け、付録内を移動しやすいことを確認します。

出力品質チェックリスト

最終化する前に、次の項目を確認します。

• すべての調査結果に、引用検証ツールで解決された逐語的な Anchor がある（未検証の調査結果を提出しない）。
• すべての調査結果に証拠への参照がある。
• 重大度レベルに妥当な根拠がある。
• 推奨事項が具体的で、次のステップを明示している。
• 孤立したセクションやプレースホルダーテキストがない。
• 対象の媒体（GitHub、Confluence など）で正しく表示される。

完了条件

• 整形された成果物を作成し、すべての Todo を完了している。
• 出力が選択したテンプレートの構成に従っている。
• 関係者が確認を求めずに調査結果に対応できる。