Document Summary

核心用法

document-summary 是一款专注于技术文档智能摘要的技能，旨在将冗长的技术文档转化为结构清晰的 Markdown 格式输出。用户只需提供文档内容，技能即可自动识别用户意图（如"summarize"、"analyze document"等关键词）并激活。

输出采用三栏式结构：

• Summary：最多 5 行的精简概述，快速传达文档主旨
• Key Points：要点子弹列表，结构化呈现核心信息
• Risks：潜在风险或关注事项，辅助决策评估

显著优点

1. 格式标准化：强制 Markdown 输出，便于后续编辑、存储与版本管理
2. 结构清晰：三模块设计覆盖"是什么-关键点-注意什么"完整认知链路
3. 技术场景适配：针对技术文档优化，区别于通用摘要工具
4. 轻量易用：单输入字段（content），无复杂配置门槛

潜在缺点与局限性

• 输入依赖：仅支持文本输入，无法直接处理 PDF/Word 等富格式文档
• 长度未限定：未明确说明单次处理内容上限，超长文档可能截断或超时
• 无交互澄清：一次性输出，不支持针对特定章节深入追问
• 领域限定：虽称"technical"，但未细化具体技术领域（如法律、医学技术文档可能效果参差）

适合人群

• 技术团队负责人：快速预审技术方案文档
• 开发者与架构师：高效浏览 API 文档、技术规范
• 项目经理：提炼需求文档核心交付点
• 知识管理从业者：构建技术知识库的标准化摘要

常规风险

• 信息压缩损失：长文档强制压缩至 5 行摘要可能导致关键细节遗漏
• 风险识别偏差：AI 判定的"Risks"可能遗漏业务上下文特定的隐患
• Markdown 渲染差异：复杂表格、代码块在转换过程中格式可能异常
• 未经验证来源：输入文档若含错误或偏见，摘要将继承传播

核心用法

document-summary 是一个轻量级文档摘要 Skill，通过自然语言指令激活。用户只需提供技术文档文本，即可获得结构化输出：

用户输入 → summarize this document: [粘贴文档]
输出 → ## Summary（5行内概述）
       ## Key Points（要点列表）
       ## Risks（潜在风险识别）

激活关键词包括：summarize、summary、analyze document、extract key points

---

显著优点

1. 极致轻量
纯 Markdown 实现，无脚本代码、无可执行逻辑，仅通过自然语言描述行为，从根本上杜绝代码注入风险。

2. 零依赖架构
无 package.json、requirements.txt 等依赖文件，供应链攻击面为零。六维雷达图中「依赖审计」维度获满分 100。

3. 完全离线
无 HTTP/HTTPS 请求、无 fetch/curl 等网络调用，数据不出本地，网络分析维度同样满分。

4. 隐私友好
仅处理用户主动输入的文档内容，不收集系统信息、环境变量或敏感数据，通过 GDPR/CCPA 合规检查。

5. 输出结构化
强制三段式 Markdown 格式，便于下游自动化处理或人工快速浏览。

---

潜在缺点与局限性

| 局限 | 说明 |

|------|------|

| 无深度分析能力 | 仅基于 LLM 的文本理解，无法进行代码执行验证或外部数据交叉核对 |

| 输出长度受限 | Summary 强制≤5行，复杂文档可能损失细节 |

| 无持久化存储 | 每次调用独立，无文档历史或会话记忆 |

| 依赖模型能力 | 摘要质量完全取决于底层 LLM 对技术文档的理解水平 |

| 来源可信度一般 | 维护者为个人开发者（T3），无企业背书 |

---

适合人群

• 技术写作者：快速生成文档摘要、更新日志或 README 概览
• 开发者：阅读开源项目文档、API 文档时提取关键信息
• 项目经理：批量处理技术方案文档，识别潜在风险点
• 安全审查者：需要零依赖、零网络的极简工具处理敏感文档

---

常规风险

低优先级关注项：
1. 许可证未明确：当前无 LICENSE 文件，使用条款模糊
2. 版本漂移：后续若引入可执行代码或依赖，需重新评估
3. 模型幻觉风险：LLM 生成的「Risks」章节可能存在误报或漏报，需人工复核

当前版本实际风险：经 CLS-Certify 六维检测，未发现安全威胁。