前言¶
长任务里，命令失败、工具报错、用户当场改结论，都很常见。若每次只改当前一步、不把教训写进可复用的记忆，同类错误会在后续对话里反复出现。下面介绍社区 Skill Self-reflection（坐标 @user_416e33b9/reflection-v2）：在官方说明中，它把自我反思、自我批评、自我学习与自组织记忆组合在一起，让 Agent 评估自身产出、发现错误，并尝试形成更持久的改进，而不是单次对话内「修完就忘」。
这是什么¶
Self-reflection 是 SkillHub 上分类为 ai-agent 的社区 Skill，当前版本 1.0.0，发布者为 user_416e33b9（SkillHub 页面展示作者为「一路向西」）。标签 requires_api_key=false，表示按页面信息安装使用该 Skill 不依赖额外 API Key。
官方简介概括为四类能力：Self-reflection、Self-criticism、Self-learning、Self-organizing memory——Agent 评估自己的工作、抓住错误，并朝「永久改进」方向组织记忆与行为（表述来自 SkillHub 页面与抓取元数据，非独立测评结论）。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_416e33b9/reflection-v2
- 坐标：
@user_416e33b9/reflection-v2
核心功能（据官方说明）¶
以下能力点均来自 SkillHub 简介与元数据，不展开未公开的 SKILL.md 内部步骤。
- 自我评估与纠错：在任务执行后审视结果，识别错误或与预期不符之处。
- 自我批评：在用户否定或纠正时，把纠偏信息纳入后续判断，而非仅替换当轮回复。
- 自我学习：在发现知识过时、做法更优时，更新可沿用的经验表述。
- 自组织记忆：将上述过程沉淀为可检索、可复用的记忆结构，减轻重复踩坑。
官方给出的建议启用时机（原文五条，略作归纳）：
- 某条命令、工具、API 或操作失败；
- 用户纠正你或拒绝你的产出；
- 你意识到自身知识过时或不正确；
- 你发现更好的做法；
- 用户明确为当前任务安装或引用该 Skill。
安装与启用¶
SkillHub 提供两种常见路径：用 SkillHub CLI 装到当前 Agent 的 skills 目录，或把安装提示交给支持 Skill 的 AI 客户端执行。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（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
2. 安装 Self-reflection¶
安装任意 Skill 时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录；否则默认落在 ./skills/，可能不会被识别。
skillhub install user_416e33b9/reflection-v2 --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
将 <skills 目录> 换成你当前环境对应路径即可。文档还提到部分 OpenClaw 变体等产品也有类似 skills 目录，需按你所用 Agent 自行确认。
3. 通过对话让 AI 安装¶
SkillHub 技能页提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_416e33b9/reflection-v2`。
把上述内容发给已接入 Skill 能力的 Agent，由其按 skillhub.md 完成 search/install 与目录校验。
典型用法¶
公开资料未附带可复制的端到端对话脚本；用法边界以官方「何时使用」为准。实践中可按下面节奏落地（与简介一致，不臆造内部协议）：
- 失败即触发：工具或命令失败后，不要只重试同一参数；在启用该 Skill 的会话中，让 Agent 说明失败原因、假设与下一步验证方式，并写入其自组织记忆（具体字段以安装后的 SKILL 指令为准）。
- 用户纠偏：用户指出错误或更换方案时，显式引用本 Skill 或保持其处于启用状态，便于把纠偏当作学习事件而非单轮补丁。
- 认知更新：当你或 Agent 发现文档/API 与旧认知不一致时，按 Skill 要求做一次反思性更新，避免旧结论继续污染后续步骤。
- 显式引用：对长周期任务，可在任务开头说明「本任务启用
@user_416e33b9/reflection-v2」，对应官方第五条场景。
适用场景与注意¶
适合谁
- 需要 Agent 在多步工程任务中减少重复错误、保留纠偏经验的开发者；
- 经常在 Cursor、Claude Code、Codex 等支持 skills 目录的客户端里做自动化操作的用户。
限制与注意
- 能力描述来自 SkillHub 简介，具体反思流程、记忆格式以安装后的 Skill 文件为准；本文未读取仓库内 SKILL.md 全文，不列举未核实的配置项。
- 社区来源（
community），维护节奏与兼容性需自行关注版本 1.0.0 的更新。 - SkillHub 页面元数据（抓取时）：评分约 100000、下载 1023、安装 14——仅作热度参考，不代表效果保证。
- 自组织记忆会改变 Agent 后续行为，敏感项目请注意记忆内容与合规边界。
结尾¶
Self-reflection 把「失败后重试」扩展为「失败后反思、被纠正后学习、经验可沉淀」的 Agent 工作方式；不依赖 API Key，通过 SkillHub 坐标 @user_416e33b9/reflection-v2 安装即可。官方入口：https://www.skillhub.cn/skills/user_416e33b9/reflection-v2；安装说明：https://skillhub.cn/install/skillhub.md。
