# Summary Structuring

> 長文の技術ドキュメント・会話ログ・実装結果を、目的に応じた構造で要約する。情報の抜け漏れを防ぎつつ、読み手が必要な情報に即座にアクセスできる形式にする。長文を要約・構造化するときに使う。

- Skill: `thinkyou0714/summary-structuring` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thinkyou0714/summary-structuring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thinkyou0714/summary-structuring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thinkyou0714 (https://skillmd.com/u/thinkyou0714)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/thinkyou0714/summary-structuring

---


## Purpose

「長い出力を読んでも何が重要かわからない」を防ぐ。
技術的な詳細を保ちつつ、読み手の目的（判断 / 共有 / 記録 / 引き継ぎ）に合わせた構造で要約する。

## Use When

- AI の出力・会話ログを人間が確認・判断できる形に整理する場合
- 実装完了後に作業内容を記録・共有する場合
- 長いドキュメントから必要な部分を抽出して渡す場合
- セッション終了時のハンドオフサマリーを作成する場合

## Inputs

以下を準備すること。不足している場合は推測せず、不足を明示する。

- **原文**: 要約対象のテキスト（ログ / ドキュメント / 出力）
- **目的**: 要約の用途（判断用 / 共有用 / 記録用 / 引き継ぎ用）
- **読み手**: 誰が読むか（自分 / チーム / ステークホルダー / 次セッションのAI）
- **長さ制約**: 要約の目安の長さ（あれば）

## Output Contract

以下の順で出力すること。順序を変えない。

1. **論点**: この要約で最も重要な情報の核心
2. **根拠**: その論点をそう判断した理由
3. **構造化サマリー**: 目的に応じたフォーマットの要約
4. **含意**: 要約で省略した情報が後から問題になるリスク
5. **改善案**: 要約の構造・粒度を改善する案
6. **代替案**: 別の目的・読み手向けの要約バリエーション
7. **判断材料**: 「この要約で十分 / 詳細が必要 / 別の構造にする」を選ぶための情報

### 構造化サマリー フォーマット（目的別）

**判断用サマリー**:

- 状況: （1文）
- 判断が必要な点: （箇条書き）
- 推奨アクション: （箇条書き）
- 期限・リスク: （あれば）

**引き継ぎ用サマリー**:

- 完了したこと: （箇条書き）
- 未完了・未解決のこと: （箇条書き）
- 次のアクション: （箇条書き）
- 注意事項: （あれば）

**記録用サマリー**:

- 日時・対象:
- 変更内容: （箇条書き）
- 結果・状態:
- 参照ファイル・リンク:

## Review Lens

- **目的妥当性**: 要約フォーマットが読み手の目的に対して適切か
- **範囲の過不足**: 重要な情報が省略されていないか / 不要な詳細が含まれていないか
- **中長期リスク**: 要約の省略によって後工程で情報ロスが発生しないか
- **LAB全体との整合性**: 主力プロダクト（LMS）の文脈に沿った要約か
- **非エンジニア理解可能性**: 判断用サマリーは非技術者でも読めるか
- **他LLM移植耐性**: フォーマットが Claude 固有の出力スタイルに依存していないか

## Instructions

1. 原文の目的を「判断用 / 共有用 / 記録用 / 引き継ぎ用」のいずれかに分類する
2. 分類に対応するフォーマットを選択する（複数目的の場合は主目的に合わせる）
3. 原文から「事実 / 判断 / アクション / リスク」を抽出して分類する
4. 各フォーマット項目を簡潔に埋める（1項目あたり1〜3文が目安）
5. 省略した情報のうち後から重要になりうるものを「注意事項」として付記する
6. 読み手がサマリーだけで次の行動を決定できるかを確認する
7. 最終判断は人間に委ねる

## Guardrails

- 「詳細は原文を参照」のみで終わらせない（サマリーで最低限の判断ができること）
- 要約のために事実を改変・歪曲しない
- 元の技術的判断・意図を簡略化によって失わない
- 「重要そう」な情報を推測で追加しない（原文にある情報のみ使う）
- 省略が「読みやすさのため」であることを明示できない場合は省略しない

## LAB Cross-Check

| 観点 | 状態 | 備考 |
|---|---|---|
| 自動化フロー | — | 自動化の状態変化がサマリーに含まれているか |
| データ / 認証 / ログ | — | DB・認証関連の変更・状態がサマリーに含まれているか |
| 実装 / 運用フロー | — | 実装完了・未完了が明確に分類されているか |
| 非エンジニア理解可能性 | — | 判断用サマリーが非技術者に読めるか |
| 会員共有 / 再利用耐性 | — | サマリーフォーマットが他タスクにも転用できるか |
| 他LLM移植耐性 | — | フォーマットが Claude 固有に依存していないか |

状態は OK / 注意 / NG / 対象外 で記入すること。

## Handoff Notes

- **要件**: 構造化サマリー（目的別フォーマットで出力）
- **成功条件**: 読み手がサマリーだけで次の行動を決定できる
- **失敗条件**: サマリーが原文より長い / 読み手が原文確認を必要とする
- **実行範囲**: 原文の情報整理・構造化のみ（情報の追加・解釈は行わない）
- **影響範囲**: 読み手の判断・次工程への情報伝達
- **ロールバック方針**: 重要情報の省略が判明した場合は即座に補足を追記
- **コスト比較**: 要約構造化コスト vs 長文を全員が読んで情報ロスするコスト

## Further Reading

- `stakeholder-translation` skill — ステークホルダー向けの言語変換
- `reusable-doc-structure` skill — 再利用可能なドキュメント構造設計
- `onboarding-readability` skill — ドキュメントの読みやすさチェック
- [docs/TASKS.md](../../../docs/TASKS.md) — 引き継ぎ用サマリーの参照例