🚀 快速开始

最常用调用方式

支持自动触发（自然语言识别）、手动触发（/summary 命令）、参数化调用三种模式。详见 ⚡ 触发条件与使用方式。

• 最快生成（仅提供 task_name）→ 标准版 10 章报告 (~3分钟)
• 完整配置选项 → 见 api-reference.md
• 错误排查指南 → 见 error-codes.md
• 内部原理详解 → 见 execution-flow.md

🎯 技能概述

本技能是任务执行总结报告生成器，旨在为用户提供系统化、结构化的任务执行经验总结能力。通过智能化的信息收集、深度分析和规范化报告生成，帮助用户从已完成任务中提炼有价值的经验教训，形成可复用的方法论，持续提升个人和团队的执行效能。

核心价值

• 经验沉淀：把做事经验变成可复用的文档，避免知识流失
• 模式识别：自动发现反复出现的问题模式，提炼可复用的方法
• 决策支持：给类似任务提供参考和风险提醒，减少重复踩坑
• 能力提升：通过复盘持续改进，让每次执行都比上次更好

适用场景

四大核心引擎

1. 信息收集引擎：多源采集对话历史、代码文件、日志等，智能识别目标/时间/决策/问题等要素
2. 分析处理引擎：五维深度分析（目标达成度/时间效能/资源利用/问题模式/协作效果）
3. 报告生成引擎：基于标准化10章模板动态填充内容，确保结构完整性
4. 智能推荐引擎：提炼方法论 + 生成改进建议 + 风险预警，提供可操作的行动指导

⚡ 触发条件与使用方式

三种触发模式

1️⃣ 自动触发（推荐）

当满足以下任一条件时自动激活：

显式关键词匹配：

• 包含"总结"、"复盘"、"回顾"、"报告"、"经验"、"教训"、"postmortem"等词汇
• 明确要求生成文档或记录

隐式意图识别：

• 用户表现出回顾已执行任务的意图
• 询问"做得怎么样"、"有什么收获"、"下次怎么做"
• 要求保存或导出执行过程的信息

场景推断：

• 任务明显已经完成或进入收尾阶段
• 连续多个操作后出现停顿或思考状态
• 用户切换话题前表现出总结倾向

2️⃣ 手动触发

用户可通过以下方式明确激活：

• 直接说："请生成任务执行总结"
• 使用快捷命令：/summary 或 /report
• 在对话结束时明确要求："帮我做个总结"

3️⃣ 命令式调用

支持参数化调用以定制输出（详见 api-reference.md）：

# 基础调用
请生成任务总结：[task_name]

# 指定详细程度
请生成摘要版/标准版/详细版任务总结：[task_name]

# 定制章节
请生成任务总结（仅包含第1,5,9,10章）：[task_name]

触发确认策略

在不确定是否应该触发时，采取以下策略：

• 如果任务复杂度 > 中等（超过5个步骤），倾向于触发
• 如果涉及重要决策或问题解决，倾向于触发
• 如果是重复性或简单操作，可以询问用户确认

🔄 执行流程

本技能遵循 7 步标准执行流程（详见 execution-flow.md）：

流程概览

用户请求 → 参数解析 → 信息收集 → 多维分析 → 报告生成 → 智能推荐 → 质量输出
   ↓         ↓          ↓          ↓          ↓          ↓          ↓
 意图识别  校验输入    提取6类信息  五维分析    10章模板    方法论+建议  完整性检查

七步详解

各步骤的详细说明、输入输出规范、错误处理、降级机制见 execution-flow.md，速查版见 execution-flow-quick.md

📤 输出报告结构

标准 10 章报告

各章节详细说明见 templates.md，速查版见 templates-quick.md

定制选项

详细程度

模板变体

• standard：通用标准模板（推荐默认）
• learning：学习专用模板（培训、技能提升）

语言风格

• professional：专业书面语，适用于正式报告、项目归档
• casual：轻松易读，适用于个人笔记、非正式场合

输出格式

• 主格式：Markdown (.md)，命名：task-summary-[任务名称简写]-YYYYMMDD.md
• 辅助转换：PDF、HTML、Word（pandoc input.md -o output.docx）

⚠️ 错误处理

错误分级体系

完整的15个错误码定义及降级规则详见 error-codes.md，速查版见 error-codes-quick.md

📚 参考文档索引

本技能采用 Progressive Disclosure 架构，详细信息分散在 references/ 目录下的专门文档中：

⛔ 强制加载规则

1. 默认仅加载 SKILL.md，不得预加载任何 references/ 下的文档
2. P0 快速参考（4个 quick 文件）：仅在用户意图明确涉及对应主题时加载
3. P1 完整参考（api-reference.md、error-codes.md、execution-flow.md、templates.md、examples-v2.md）：仅在用户明确需要深度信息且 quick 版不足时加载
4. P3 扩展文档（terminology.md、v3-planning/ 目录）：禁止默认加载，仅在用户明确提及术语查询或 V3 规划时加载

日常使用请优先查阅「快速参考」版本，仅在需要详细信息时加载完整参考文档。V3 规划文档仅供了解未来方向时参考。

场景化加载推荐

快速参考（日常优先加载）

完整参考（深度查阅）

文档版本对照表

Token 预算与上下文感知加载

Token 预算参考

禁止预加载规则

• 不要预加载 examples-v2.md，除非用户明确需要完整请求/响应示例
• 不要预加载完整版文档（api-reference.md 等），quick 版能满足时优先使用 quick 版
• 不要加载 V3 规划文档（v3-planning/ 目录），除非用户明确提及 V3、规划、路线图
• 不要加载 terminology.md，除非用户查询特定术语定义

Quick/完整版互斥规则

• ❌ 禁止同时加载同一主题的 quick 版和完整版
• ✅ 先加载 quick 版，用户需要更多细节时再替换为完整版
• 示例：先加载 error-codes-quick.md（~600 tokens），不足时替换为 error-codes.md（~2,660 tokens）

💡 最佳实践与常见问题

最佳实践

✅ 什么时候使用此技能

1. 完成任务后立即使用：记忆最鲜活时生成报告，信息准确度最高（建议24-48小时内）
2. 中等复杂度以上任务：超过5个步骤的任务值得总结，简单操作价值有限
3. 遇到重要问题后：棘手难题的解决过程是宝贵的学习素材
4. 里程碑节点：Sprint结束、版本发布、阶段性成果都是好的总结时机

✅ 如何获得更高质量的报告

1. 任务开始前：明确表达目标和期望，提供充足背景信息
2. 执行过程中：保持对话连贯性，重要决策时说明考虑因素
3. 请求生成时：明确说明详细程度需求，指出最关心的方面，补充遗漏信息

💡 对话质量与报告质量：包含明确决策、问题描述和成果确认的 30 轮对话，比闲聊式的 100 轮对话能生成更高质量的报告。详见 execution-flow.md 的性能优化策略。

✅ 报告的使用和维护

• 即时使用：作为交付文档、会议分享材料、下一个任务的参考
• 长期价值：存入知识库供团队查阅，定期回顾识别模式，制定培训材料
• 持续改进：根据反馈优化模板，将有效建议落实到流程，跟踪落实情况

注意事项

⚠️ 信息安全：报告可能包含敏感信息（密钥、密码、内部地址），请注意脱敏和传播范围控制 ⚠️ 客观性原则：对事不对人，聚焦改进而非指责，成绩和问题都应有据可查 ⚠️ 时效性：越早生成越准确，但也要确保关键信息收集完整 ⚠️ 定制化灵活：标准模板可根据实际需求调整，不同任务可有不同侧重点

FAQ

Q1: 生成一份报告需要多长时间？ A: 摘要版1-2分钟，标准版3-5分钟，详细版8-15分钟（取决于任务复杂度和数据量）

Q2: 对话历史很长怎么办？ A: 技能会智能提取关键信息，不会逐字分析全部内容。特别长的对话（>100轮）建议先生成摘要版

Q3: 报告中的数据准确吗？ A: 严格基于对话历史和实际操作记录，力求准确。时间统计基于对话时间戳可能与实际wall clock time有差异

Q4: 可以自定义报告模板吗？ A: 目前使用标准模板，可在请求时说明特殊需求。未来计划支持用户自定义模板功能

Q5: 生成的报告如何保存和使用？ A: 默认以 Markdown 格式保存在当前工作目录，可直接用编辑器打开、Git管理、转换为 PDF/Word、上传到 Wiki

Q6: 数据不足时报告质量如何保证？ A: 覆盖率低于 90% 时发出 E010 警告并降级生成，低于 70% 时提供继续/补充/终止选项。详见 error-codes.md。

Q7: 超长对话会影响生成速度吗？ A: 会。20轮内约1-2分钟，20-50轮约3-5分钟，超过50轮约6-10分钟。系统会启用智能采样策略。详见 execution-flow.md。

Q8: 是否支持多语言输出？ A: 当前版本（v2.x）主要支持中文输出，对中英混合输入有良好的处理能力。多语言支持已列入规划阶段，当前版本不包含此功能。

Q9: 如何自定义报告模板？ A: 当前提供四种模板变体（summary/standard/detailed/learning），可通过 detail_level 和 template_variant 参数选择。完全自定义功能已列入规划阶段，当前版本不包含此功能。

Q10: 生成的报告可以导出到外部工具吗？ A: 当前输出 Markdown 格式，可手动导入 Confluence、Notion、飞书等平台。外部工具自动化集成已列入规划阶段，当前版本不包含此功能。

文档版本：v2.5 (P3优化版) 最后更新：2026-04-15 维护者：Task Execution Summary Generator Team 变更记录：v2.0→v2.1 - Description 触发能力优化（基于 20 个 eval 查询分析，覆盖率 60%→100%） 变更记录：v2.1→v2.2 - 强化分层加载规则，更新Token预算（P1层优化后从50.8K降至44.4K） 变更记录：v2.2→v2.3 - P2优化：场景化加载规则、Token预算校准、Quick/完整版互斥规则、冗余精简 变更记录：v2.3→v2.4 - 技能规范修复：description压缩、IDE依赖移除、V3承诺隔离、版本号统一 变更记录：v2.4→v2.5 - P3优化：术语表精简(932→340行)与V3文档摘要化，Token预算校准(基于实际文件大小重新计算)