前言¶
长期跑 Agent 的同行多半遇到过同一种落差：单次对话里改对了，换一场又犯同类错；或者把教训写在聊天记录里，下次上下文一截断就没人记得。常见补救是手写一长串 system prompt，或靠外部记忆产品，但「这次为什么错、改哪条机制、怎么验证」往往仍靠人盯。
下面介绍的 自我迭代内核（@user_c0f5ae43/self-iteration-core）走另一条路：它不是调外部 API 的工具型 Skill，而是一套写进 SKILL.md 的行为模式——用复盘四步法、三级记忆目录和变更记录，把翻车场景转成可检索、可验证的工作区规则。SkillHub 分类为 ai-agent，来源为社区（community），发布者 user_c0f5ae43，当前版本 1.0.0，标签标明 requires_api_key=false（无需 API Key）。
这是什么¶
一句话定位：Hermes Agent 风格的自我复盘与迭代系统，核心信念是「问题不是 bug，而是迭代信号」。
安装后 Agent 被引导在出错、被纠正、重复犯错或发现更优做法时主动走闭环，而不是只口头道歉。技能说明由发布方标注为基于 Hermes Agent 理念与真实迭代经验构建（母版 Agent「旺财」）。
核心功能¶
以下能力均来自官方 SKILL.md 与 SkillHub 简介，可按模块理解。
复盘四步法¶
遇到应复盘场景时立即执行，不必等用户催促：
- 回溯根因：对表面现象连续追问「为什么」，直到落到机制层（例如检查清单缺优先级、缺少外部状态对比等）。
- 定位修改点：按根因类型决定改哪里——规则不完整改
MEMORY.md，工具误用改TOOLS.md，流程遗漏改 SOP 或技能SKILL.md；原则是一次只改一个点。 - 落地修改：真实改文件而非口头承认；即时层（
MEMORY.md/USER.md/TOOLS.md）要求用 edit_file 增量编辑，避免 write_file 整文件覆盖；近中期层在recent_memory/新建或编辑。改后在文件末尾追加变更记录（日期、规则摘要、根因）。 - 验证与沉淀：等同类场景再现或主动模拟测试；通过则把摘要写入
MEMORY.md，未通过则回到第 1 步。
三级记忆架构¶
技能约定工作目录下的分层文件与检索顺序：
工作目录/
├── MEMORY.md ← 日常规则+当前状态（≤5KB）
├── USER.md ← 用户画像（≤2KB）
├── SOUL.md ← 灵魂设定
├── SECRET.md ← 敏感凭证
├── 基础设定/
│ ├── SOUL.md
│ └── TOOLS.md ← 工具使用经验
└── recent_memory/
├── index.json ← 记忆目录（摘要+标签）
├── decision/ ← 重要决策复盘
├── project/ ← 项目进度快照
└── todo/ ← 待办事项
检索顺序：先即时层（已进上下文的 MEMORY.md 等）→ 再 recent_memory/index.json 定位近中期文件 → 最后用 memory_search 做长期语义检索。
技能自动沉淀与迭代验证¶
修复经第 4 步验证后，规则留在 MEMORY.md 与 recent_memory/decision/ 等位置，形成「修过的 bug → 明文规则 → 下次检索」的闭环。技能还给出起步期（先跑 1–2 天再批量复盘）与成熟期（当场复盘、每周回顾、季度升级 SOUL.md）的节奏建议。
内置复盘模板¶
首次复盘可直接复制技能中的 Markdown 模板，字段包括：翻车现场、挖根因（三层）、改了什么文件、如何验证、是否写入 MEMORY.md。
安装与启用¶
官方页面与 SkillHub 安装文档一致：先确保本机有 skillhub CLI，再把技能装进当前 Agent 会读取的 skills 目录（装错目录 Agent 不会加载）。
1. 检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 文档执行（完整安装含默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装自我迭代内核¶
搜索确认坐标后安装（skillhub search 会列出 @user_c0f5ae43/self-iteration-core）：
skillhub install self-iteration-core --namespace user_c0f5ae43 --dir <你的 Agent skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex CLI：
~/.codex/skills/或项目下的.agents/skills/
也可让 Agent 按页面提示阅读 https://skillhub.cn/install/skillhub.md 并安装 @user_c0f5ae43/self-iteration-core。
安装完成后重启或刷新 Agent，使 SKILL.md 进入技能列表。本 Skill 不依赖外部 API Key；生效方式是 Agent 在对话中遵守其中的流程与文件约定。
典型用法¶
下面是一条可复现的「翻车 → 沉淀」路径，与技能第三节、第五节一致。
- 判定触发：例如重复回复同一人、漏回重要消息、执行步骤遗漏——属于技能列出的「必须启动复盘」场景。
- 填复盘模板（节选结构）：
# [问题]复盘（2026-10-21）
## 翻车现场
重复向同一用户发送了相同结论。
## 挖根因
表面：又回了一次 → 未对比外部已发送状态 → 根因：缺少发送前状态快照/清单项。
## 我改了什么
在 MEMORY.md 增加「回复前核对最近一轮 outbound」规则，并在 TOOLS.md 补充检查步骤。
## 怎么验证
下次同类任务前先读 MEMORY，模拟一轮是否仍会双发。
## 记进MEMORY
- [x] 已在 MEMORY.md 添加规则：回复前核对会话 outbound 状态
- 按第 3 步用 edit_file 改
MEMORY.md/TOOLS.md，并写变更记录。 - 将详细复盘存入
recent_memory/decision/，在MEMORY.md留一行摘要；后续按三层检索顺序调用。
技能明确「不用过度复盘」：日常顺利执行、不可控的基础设施故障、随口偏好等，不必每次都走四步法，偏好可直接记入记忆文件。
适用场景与注意¶
适合谁
- 需要 Agent 在同一工作区长期执行任务，且愿意用
MEMORY.md、recent_memory/等文件承载规则的团队或个人。 - 希望把「纠错」从聊天里拔出来，变成可 diff、可回顾的机制改动，而不是每次重讲一遍 prompt。
限制与注意
- 依赖 Agent 是否真能读写你约定的工作目录；技能中的
edit_file、memory_search等名称对应具体客户端能力，环境不支持时需自行映射为等价工具。 - 文件大小上限（如
MEMORY.md≤5KB）需要定期摘要，避免即时层膨胀。 - SkillHub 页面统计（截至资料抓取）：评分 100000，下载约 940 次，安装计数 0——仅作商店热度参考，不代表你本地 Agent 已自动启用。
- 社区来源技能，升级与维护跟随发布者
user_c0f5ae43在 SkillHub 上的版本（当前 1.0.0）。
结尾¶
自我迭代内核把 Hermes Agent 式复盘写进 Skill：四步法挖机制、三级记忆分工、验证通过再沉淀。若你已经在用 Cursor、Claude Code 或 Codex 的 skills 机制，可以用官方坐标安装到对应目录，让 Agent 在翻车时有固定闭环而不是重复解释。
- SkillHub 页面：https://www.skillhub.cn/skills/user_c0f5ae43/self-iteration-core
- API 坐标页：https://api.skillhub.cn/user_c0f5ae43/self-iteration-core
- 安装说明：https://skillhub.cn/install/skillhub.md
