前言¶
线上事故、项目延期、实验没跑通——事后往往只有零散聊天记录和一句「下次注意」。要写成可归档、可分享的复盘，又要按时间线、根因和改进项展开，手工搭结构很费时间。下面介绍 SkillHub 社区技能「失败复盘总结工具」：在对话里交代失败背景与诉求，由 Agent 按技能指引做系统性复盘，并输出 Word 文档格式的复盘报告。
这是什么¶
「失败复盘总结工具」是 SkillHub 上的社区技能，坐标为 @user_aad6add3/failure-review，当前版本 1.0.0，分类为 knowledge-management，发布者为 user_aad6add3。页面标注 requires_api_key=false，不依赖额外 API Key。
它面向「从失败里找结果或方法」的场景：需要复盘、总结经验教训、明确改进方向，或希望在失败后做结构化分析时启用。技能说明中明确一点：最终交付物是 Word 文档格式 的复盘报告，便于存档与流转，而不是只在聊天窗口里给一段总结。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/user_aad6add3/failure-review
- API 坐标页：https://api.skillhub.cn/user_aad6add3/failure-review
核心功能¶
依据 SkillHub 与抓取资料，可核实的能力如下。
- 失败复盘导向：技能定位为「失败复盘技能」，在用户需要从失败中复盘、提炼教训、找改进方向或做系统性分析时触发使用。
- 结构化分析输出：通过 Agent 执行技能内的流程（基于通用 SKILL.md 格式），把零散叙述收敛为复盘报告，而不是单次问答式点评。
- Word 报告交付：结果以 Word 文档格式的复盘报告呈现，适合纳入知识库、项目归档或团队内传阅。
社区侧数据（以抓取资料为准）：评分 100000，下载 972，安装 8。具体数值会随 SkillHub 更新变化，以页面为准。
安装与启用¶
技能基于 SkillHub 生态分发。常见两种方式：对话安装（把官方提示发给 AI），或本机安装 SkillHub CLI 后命令行安装。
1. 安装 SkillHub CLI¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行（完整安装或仅 CLI）：
# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装说明亦见：https://skillhub.cn/install/skillhub.md
验证：
skillhub -h
2. 安装本技能¶
对话安装时，可向 AI 发送 SkillHub 页面给出的句式（与同类技能一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_aad6add3/failure-review`。
命令行安装时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录；否则默认落在 ./skills/，可能不会被识别。安装文档中的通用形式为：
skillhub install <技能名> --dir <skills 目录>
技能坐标为 user_aad6add3/failure-review，搜索时可先：
skillhub search failure-review
再按搜索结果中的名称安装，并指定目录。常用路径示例（来自官方安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
Cursor 示例（目录请按本机实际调整）：
skillhub install user_aad6add3/failure-review --dir ~/.cursor/skills/
若 CLI 仅接受短名，以 skillhub search 返回的标识为准。安装后按所用客户端要求刷新或重启 Agent，使技能被加载。
典型用法¶
官方简介未附带逐步截图或固定提示词模板，可复现的用法边界如下。
- 确认技能已安装到当前 Agent 的 skills 目录，且对话环境能加载该 Skill。
- 在对话中说明这是一次「失败复盘」需求，并补充失败事件的事实：发生了什么、目标是什么、实际结果、已知原因猜测、希望报告侧重（教训、流程、技术根因等）。这与技能描述的启用条件一致：复盘、总结经验、改进方向、系统性分析。
- 明确要求按技能产出 Word 格式的复盘报告；由 Agent 在技能指引下生成文档文件（具体文件名与生成路径取决于 Agent 与项目约定，以实际运行结果为准）。
没有公开固定样例文档时，不宜虚构「标准章节标题」或「必含五段式」；以技能执行后生成的 Word 内容为准。
适用场景与注意¶
适合谁
- 需要把一次失败整理成可留存文档的个人开发者或小团队。
- 已使用 Cursor、Claude Code、Codex 等支持 skills 目录的客户端，并愿意通过 SkillHub 管理技能。
限制与注意
- 输出格式承诺为 Word 复盘报告；若环境缺少生成或保存 docx 的能力，需自行确认 Agent 与插件是否支持。
- 技能来自 community 发布者
user_aad6add3，使用前可在 SkillHub 页面查看版本与说明更新。 - 复盘质量依赖你提供的上下文是否完整、客观；技能负责结构化与成稿，不能替代真实日志与数据核对。
- 安装路径错误是常见坑：务必使用
--dir指向当前客户端的 skills 目录，参见 https://skillhub.cn/install/skillhub.md 。
结尾¶
「失败复盘总结工具」把「失败后要做系统性复盘并落成 Word 报告」收敛成一条可重复启用的 Skill 路径，适合挂在 knowledge-management 类工作流里。详情与安装提示以 SkillHub 为准：https://www.skillhub.cn/skills/user_aad6add3/failure-review
