summarization

总结

此技能可帮助 AI Agent 将长篇文本精简为清晰、准确的摘要。Agent 支持多种总结策略——抽取式（逐字选取关键句）、抽象式（用新措辞改写）、层次式（按不同详细程度分层总结）和多文档式（综合多个来源）。此技能适用于技术文档、会议记录、研究论文、文章，以及任何读者需要了解核心信息而无需通读全文的文本。

工作流

1. 分析输入： 确定源材料的类型、长度和结构。判断它是单篇文档还是多篇文档，是否包含清晰的章节（标题、章节）或属于非结构化散文，以及所属领域。这将决定采用哪种总结策略。

2. 选择总结策略： 选择最适合输入内容和用户需求的方法。对于措辞准确性至关重要的事实类或法律类文本，使用抽取式总结。对于可读性和简洁性优先的一般内容，使用抽象式总结。当用户既需要一句话的 TLDR，又需要详细梳理时，使用层次式总结。综合多个输入时，使用多文档式总结。

3. 识别关键信息： 无论采用哪种策略，都要找出源文本中的核心主张、发现、决策、行动事项和佐证数据。结合以下信号，按重要性为信息排序：在文档中的位置（引言和结论权重较高）、提及频率、明确标记（如“重要的是”“总而言之”），以及与用户所述目的的相关性。

4. 生成摘要： 按要求的长度和详细程度生成摘要。确保事实准确，绝不引入源文本中没有的信息。保持源文本的逻辑结构。对于层次式总结，生成三个层级：一句话 TLDR、一个简短段落（3-5 句话），以及按章节详细梳理的内容。

5. 核实忠实度： 将摘要与源文本进行对照，确保事实没有失真、没有遗漏关键信息，也没有引入幻觉内容。检查数值数据、专有名词和因果关系是否准确。

用法

向 Agent 提供需要总结的文本，并可选地指定：所需长度（一句话、简短、中等、详细）、策略（抽取式、抽象式、层次式）或特定关注领域。

Summarize the following technical RFC into a short paragraph and a detailed
section-by-section breakdown. Focus on the proposed changes and their
backward-compatibility impact.

[paste RFC text here]

示例

示例 1：技术文档的分层摘要

用户请求：

从三个详细程度层级总结这份文档。

源文档（节选）：

Kubernetes Gateway API 是一组用于对 Kubernetes 中的服务网络进行建模的资源。它是 Ingress API 的继任者，提供了表达能力更强、可扩展性更高且面向角色的接口。该 API 引入了三种主要资源类型：GatewayClass（定义一组具有通用配置的 Gateway）、Gateway（请求一个可将流量转换为集群内 Service 的入口点）和 HTTPRoute（定义特定于 HTTP 的路由规则）。与 Ingress 不同，Gateway API 原生支持流量拆分、标头修改和跨命名空间路由。该 API 于 2023 年 10 月发布 v1.0.0，达到 GA 状态；Istio、Envoy Gateway、Cilium 和 Traefik 均提供了相应实现。可使用 ingress2gateway 工具从 Ingress 迁移，但建议对复杂配置进行人工审查。主要限制包括核心规范尚不支持 TCP/UDP 路由（实验频道中的 TCPRoute 和 UDPRoute 已解决此问题），以及不同实现的成熟度参差不齐。

输出：

一句话摘要： Kubernetes Gateway API 是 Ingress 的 GA 继任者，引入了 GatewayClass、Gateway 和 HTTPRoute 资源，通过原生流量拆分和跨命名空间路由，提供表达能力更强的服务网络功能。

简短摘要（1 段）： Kubernetes Gateway API 于 2023 年 10 月达到 GA，取代了 Ingress API，采用更具表达力且可扩展的服务网络方案。它引入了三种核心资源——GatewayClass、Gateway 和 HTTPRoute——按角色（基础设施提供方、集群运维人员、应用开发者）划分职责。该 API 原生支持流量拆分、标头修改和跨命名空间路由；在 Ingress 中，这些功能需要借助注解或自定义资源实现。Istio、Envoy Gateway、Cilium 和 Traefik 均提供了相应实现。可使用 ingress2gateway 工具从 Ingress 迁移，但 TCP/UDP 路由仍处于实验阶段，且不同实现的成熟度参差不齐。

详细拆解：

• 定义： 一组 Kubernetes 原生资源，用于对服务网络进行建模，旨在成为 Ingress API 的继任者。
• 核心资源： GatewayClass（共享的 Gateway 配置）、Gateway（流量入口点）、HTTPRoute（HTTP 路由规则）。
• 相较于 Ingress 的主要改进： 原生支持流量拆分、标头修改和跨命名空间路由，并按角色划分资源职责——无需再使用供应商特定的注解。
• 当前状态： 自 v1.0.0（2023 年 10 月）起达到 GA。Istio、Envoy Gateway、Cilium 和 Traefik 均提供支持。
• 迁移路径： ingress2gateway 工具可自动转换，但复杂配置需要人工审查。
• 限制： TCP/UDP 路由仍处于实验阶段。不同提供方的实现成熟度参差不齐。

---

示例 2：多文档会议记录摘要

用户请求：

将这三份会议记录综合成一份每周摘要。

源文档：

周一站会（Alpha 团队）：

讨论了 v2.1 发布的阻碍因素——支付处理超时问题。Sarah 正在调查 Stripe webhook 处理程序中的根本原因。预计周三修复。Jake 完成了新的入职流程 UI，目前正在进行代码审查。Maria 提醒大家，暂存环境的 SSL 证书将于周五到期。

周三冲刺评审：

Sarah 解决了支付超时问题——根本原因是 webhook 处理程序缺少重试配置。修复已部署到暂存环境。QA 验证通过。Jake 的入职流程 PR 收到无障碍功能方面的反馈，他正在处理。新增事项：产品团队希望在 v2.2 中加入深色模式切换开关。预计需要 3 个故事点。

周五回顾会议：

团队一致认为本周富有成效。支付修复按时发布。入职流程在完成无障碍功能方面的修复后合并。Maria 于周四续订了 SSL 证书。回顾反馈：需要改进证书到期提醒。待办事项：Maria 负责设置自动证书续订监控。展望未来：深色模式切换开关的设计将于周一开始。

综合每周摘要：

2 月 10 日至 14 日当周——Alpha 团队摘要

已发布：

• 支付处理超时修复——根本原因是 Stripe webhook 处理程序缺少重试配置（Sarah）。周三部署到暂存环境，并通过 QA 验证。
• 新入职流程 UI——Jake 完成后根据无障碍功能反馈进行了更新，并于周五合并。
• 已续订暂存环境的 SSL 证书（Maria，周四）。

进行中：

• 深色模式切换开关已加入 v2.2 路线图（3 个故事点）。设计将于下周一开始。

待办事项：

• Maria：设置自动证书续订监控，避免今后再次险些错过续订。

**回顾要点：**团队发现证书到期提醒存在流程缺口，并正主动采取措施加以解决。

最佳实践

• 绝不添加源文档中没有的信息。 摘要必须忠实于原文。如果不确定某个细节，就省略它，不要猜测。
• 保留数值的精确度。 如果源文写的是“增长 37.5%”，摘要就应写“增长 37.5%”，而不是“增长近 40%”。
• 调整语气以符合源文。 法律合同的摘要应准确、正式。团队聊天消息的摘要则可以简洁、随意。
• 优先呈现最重要的信息。 阅读摘要的人通常会快速浏览。先在第一句话中点明关键信息，再补充支持性细节。
• 对于长度要求不明确的情况，采用分层方式。 用户未指定长度时，提供一段 TLDR，再附上一段长度的摘要，让用户可以选择合适的详略程度。
• 按主题综合多份文档。 不要分别总结每份文档后再拼接起来。应找出贯穿各份文档的主题，并围绕这些主题组织综合内容。

边缘情况

• **源文本非常短：**如果输入内容已经很简洁（少于 100 个词），请告知用户，进一步概括可能会丢失重要细节，并提出可以改为突出关键句。
• **源文本存在矛盾：**如果文档中包含相互矛盾的陈述，请在摘要中指出矛盾，而不是默默选择其中一种说法。
• **高度技术化或充满行话的文本：**如果面向非专业读者进行摘要，请在首次出现时解释关键术语。如果面向专家，请保留技术术语，不要过度简化。
• **文档不完整或被截断：**如果源文本似乎被截断（在句子中途结束，或提及未提供的章节），请指出这一点，并仅概括已有内容，同时说明摘要可能不完整。
• **多份文档内容重叠：**对多份文档进行摘要时，请去重重叠信息，避免重复。指出各来源一致之处和存在分歧之处。