前言¶
在 Agent 开发里，同类问题会反复出现：某条 shell 命令突然失败、用户纠正「不对，应该是……」、外部 API 返回异常，或者事后才发现有更稳妥的做法。默认对话结束后，这些纠正往往只留在当次上下文里，下次任务仍可能踩同样的坑。
下面介绍 SkillHub 上的社区 Skill「自我反思技能」。它的定位是捕获学习点、错误与纠正，支撑持续改进；并在重大任务开始前回顾已沉淀的内容。本文事实来自 SkillHub 页面与安装文档，安装与路径以官方说明为准。
这是什么¶
自我反思技能（坐标 @user_2d5dabaa/ziwofansi-ceshi，版本 1.0.0）是 SkillHub 分类 ai-agent 下的社区技能（来源 community），由发布者 user_2d5dabaa 维护；页面作者展示为 user_孙悟空。标签 requires_api_key=false，不依赖额外 API Key。
官方简介（英文原文要点）：记录 learnings、errors、corrections，用于持续改进；并在 major tasks 之前 review learnings。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_2d5dabaa/ziwofansi-ceshi
- API 坐标页：https://api.skillhub.cn/user_2d5dabaa/ziwofansi-ceshi
核心功能¶
依据官方简介，该 Skill 约定 Agent 在下列情形主动沉淀反思内容（非穷举实现细节，以安装后的 SKILL.md 为准）：
- 命令或操作意外失败。
- 用户纠正 Agent（例如「No, that’s wrong…」「Actually…」）。
- 用户请求当前不具备的能力。
- 外部 API 或工具调用失败。
- Agent 意识到自身知识过时或不正确。
- 对重复性任务发现更优做法。
此外，在重大任务开始前应回顾已记录的学习内容，减少重复错误。
技能本体遵循通用 SKILL.md 格式，由 Agent 在匹配上述场景时按技能说明执行，而不是替代你现有的业务代码或测试流程。
安装与启用¶
安装流程以 SkillHub 文档 https://skillhub.cn/install/skillhub.md 为准。页面也给出了同一指引：请根据该文档安装 @user_2d5dabaa/ziwofansi-ceshi。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按官方脚本安装（完整包含 CLI 与默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
官方要求安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录；省略时默认落到 ./skills/，可能不会被识别，且通常需要重启客户端后生效。
skillhub install @user_2d5dabaa/ziwofansi-ceshi --dir <skills 目录>
常用路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中，可将 <skills 目录> 设为 ~/.cursor/skills/。Claude Code、Codex 等按上表替换即可；OpenClaw 及同类变体使用各自约定的 skills 目录，与文档第四节描述一致。
首次安装 CLI 时，SkillHub 文档会询问是否将 SkillHub 设为优先技能源；仅搜索或安装单个技能时可跳过优先源配置，直接执行第三节命令。
典型用法¶
公开页面未附带独立可执行脚本示例，典型用法是：安装并启用技能后，在对话中触发官方列出的六类场景之一，由 Agent 按 SKILL.md 记录学习点、错误与纠正；开始较大改动或长链路任务前，先让 Agent 回顾已沉淀内容。
若需确认具体写入位置、字段或回顾命令，应在安装完成后打开技能包内的 SKILL.md 核对，本文不臆造未在官方资料出现的配置项。
检索同类技能时，也可使用 CLI：
skillhub search ziwofansi
适用场景与注意¶
适合谁：长期用 Cursor、Claude Code、Codex 等做自动化开发与排障的团队或个人，希望把「踩坑—纠正—更好做法」从单次对话里抽出来，而不是每次都从零解释。
使用前提：需要可用的 skillhub CLI，并将技能装到正确的 --dir；requires_api_key=false 表示不强制额外密钥，但仍受本地 Agent 与网络环境影响。
数据与版本：SkillHub 抓取资料显示评分为 100000、下载 1044、安装 0（统计会随时间变化，以页面为准）。版本 1.0.0，升级可用 skillhub 的 install/update 流程并仍指定 --dir。
限制：社区来源（community），行为细节以技能包内文档为准；它不能替代版本管理、CI 或人工 Code Review，只是把反思流程固化成 Agent 可遵循的技能说明。
结尾¶
自我反思技能把失败、用户纠正和能力缺口等场景写成明确的触发条件，并强调重大任务前的回顾，适合作为 ai-agent 类工作流里的「经验层」补充。安装坐标：@user_2d5dabaa/ziwofansi-ceshi。官方入口：https://www.skillhub.cn/skills/user_2d5dabaa/ziwofansi-ceshi。
