前言¶
在 Cursor、Claude Code 等 Agent 里做联调或改接口时，命令失败、用户纠正、外部 API 报错往往只留在当轮对话里，下一轮又要从头解释。若希望把这些经验沉淀成可检索、可晋升到项目记忆的 Markdown 记录，需要一套固定目录、条目格式和触发条件，而不是每次临时记笔记。
下面介绍 SkillHub 坐标为 @user_36090e04/apu-case-gen、展示名称为「API测试用例生成」的社区 Skill（版本 1.0.0，分类 dev-programming，requires_api_key=false）。安装后实际包内 SKILL.md 的 name 为 self-improvement，README 说明其源自 OpenClaw 方向的 self-improvement 能力改造；页面简介与包内文档一致，均描述「捕获学习、错误与纠正以支持持续改进」，与展示名称「API测试用例生成」并不对应。下文功能与用法均以 2026-10-22 通过 skillhub install 拉取的包内容为准。
这是什么¶
一句话定位：在项目或工作区根目录维护 .learnings/ 下的结构化 Markdown 日志，并在合适时机把条目晋升到 CLAUDE.md、AGENTS.md 等长期上下文。
出品与来源：SkillHub 社区发布者 user_36090e04；包内 README 标明改编自 pskoett/pskoett-ai-skills 的 self-improvement Skill。
解决的问题：把命令失败、用户纠正、能力缺口、集成错误等事件写成统一格式的待办式记录，便于复查、去重和升级为团队约定。
核心功能¶
以下能力均来自包内 SKILL.md，已核实。
日志分类与落盘位置¶
| 情况 | 写入文件 |
|---|---|
| 命令或操作失败 | .learnings/ERRORS.md |
| 用户纠正 Agent | .learnings/LEARNINGS.md（correction） |
| 用户提出当前不具备的能力 | .learnings/FEATURE_REQUESTS.md |
| 外部 API / 工具失败 | .learnings/ERRORS.md（含集成上下文） |
| 知识过时或错误 | .learnings/LEARNINGS.md（knowledge_gap） |
| 发现更好的重复任务做法 | .learnings/LEARNINGS.md（best_practice） |
首次使用前会初始化 .learnings/ 及三个 Markdown 文件；不得覆盖已有文件，且默认不记录密钥、令牌或完整敏感配置。
条目格式与 ID¶
学习、错误、功能请求分别使用 LRN-YYYYMMDD-XXX、ERR-YYYYMMDD-XXX、FEAT-YYYYMMDD-XXX 编号，字段包含 Priority、Status、Area（如 tests、backend）及 Metadata。错误与功能请求模板在 SKILL.md 中有完整示例。
晋升与复查¶
广泛适用的条目可晋升到 CLAUDE.md、AGENTS.md、.github/copilot-instructions.md；OpenClaw 工作区还可对应 SOUL.md、TOOLS.md。重大任务开始前、功能完成后或进入曾有记录的代码区域时，Skill 建议复查 .learnings/ 中的 pending 项。
可选自动化¶
包内提供 scripts/activator.sh、scripts/error-detector.sh，可通过 Claude Code / Codex 的 hooks 在 UserPromptSubmit 或 PostToolUse（Bash）时注入提醒或检测错误；OpenClaw 侧另有 hooks/openclaw/ 与 openclaw hooks enable 流程。默认以手动记录为主，hooks 为 opt-in。
技能抽取¶
对满足「可复现、已验证、跨项目适用」等条件的 learning，可用 scripts/extract-skill.sh 生成新 Skill 目录（需自行填写模板）。
安装与启用¶
SkillHub 页面给出的安装提示为：参照 skillhub.cn/install/skillhub.md，安装 @user_36090e04/apu-case-gen。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装脚本（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须使用 --dir 指向 Agent 识别的 skills 目录，否则默认落在 ./skills/ 且可能不被加载。
skillhub install apu-case-gen --namespace user_36090e04 --dir <skills 目录>
常见路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装成功后目录形如：.../apu-case-gen/SKILL.md（及 scripts/、assets/、references/ 等）。
3、在项目中初始化学习目录¶
Agent 按 Skill 指引在项目或工作区根目录创建日志，而非 skills 安装目录内：
mkdir -p .learnings
[ -f .learnings/LEARNINGS.md ] || printf "# Learnings\n\nCorrections, insights, and knowledge gaps captured during development.\n\n**Categories**: correction | insight | knowledge_gap | best_practice\n\n---\n" > .learnings/LEARNINGS.md
[ -f .learnings/ERRORS.md ] || printf "# Errors\n\nCommand failures and integration errors.\n\n---\n" > .learnings/ERRORS.md
[ -f .learnings/FEATURE_REQUESTS.md ] || printf "# Feature Requests\n\nCapabilities requested by the user.\n\n---\n" > .learnings/FEATURE_REQUESTS.md
也可将包内 assets/ 下同名文件复制到 .learnings/（仅在信任安装来源时使用）。
典型用法¶
对话中触发记录¶
Skill 定义的自动关注场景包括：命令非零退出、用户说「不对 / 其实应该…」、请求不存在的能力、外部工具失败、发现更优做法等。对应动作是向上述三个文件追加条目，而不是只写在聊天里。
接口联调失败时写 ERRORS（示例结构）¶
当某次 HTTP 或 CLI 调用失败，可按 SKILL.md 中的 Error Entry 模板追加，例如摘要一行、错误块、Context（命令与参数）、Suggested Fix。Area 可标为 tests 或 backend，便于日后 grep 过滤。
复查 pending¶
grep -h "Status\*\*: pending" .learnings/*.md | wc -l
grep -B5 "Priority\*\*: high" .learnings/*.md | grep "^## \["
grep -l "Area\*\*: tests" .learnings/*.md
修复后把条目的 Status 改为 resolved 或 promoted，并填写 Resolution / Promoted 字段。
Cursor / Copilot 无 hooks 时¶
可在 AGENTS.md 或 .github/copilot-instructions.md 中加入简短「Self-Improvement Workflow」提醒（SKILL.md 提供 Copilot 用文案），由 Agent 在会话中主动询问是否记录。
适用场景与注意¶
适合谁：希望跨会话积累工程教训、把重复踩坑写成可晋升约定的团队；使用 OpenClaw 工作区结构的用户可参考文档中的 AGENTS.md / TOOLS.md 晋升路径。
限制与坑：
- 名称与内容不一致：SkillHub 展示名「API测试用例生成」与包内
self-improvement能力不符；若目标是自动生成 OpenAPI/接口测试用例，应核对页面与包内SKILL.md后再决定是否安装。 - 统计口径：已抓取资料为评分 100000、下载 714、安装 0；与第三方摘要中的数字可能因抓取时间不同而不一致，以 SkillHub 页面为准。
- 隐私：默认避免写入密钥与完整敏感输出；若
.learnings/纳入版本库，需团队约定是否 gitignore（Skill 文档给出多种策略）。 - OpenClaw 专用路径：文档中
clawdhub install self-improving-agent、git clone 原仓库等属于 OpenClaw 生态说明；在 Cursor 上一般以 SkillHub 安装 + 项目级.learnings/为主。
结尾¶
@user_36090e04/apu-case-gen 在 SkillHub 上以「API测试用例生成」展示，实际提供的是基于 Markdown 的持续改进日志工作流：初始化 .learnings/、按场景写入 LEARNINGS / ERRORS / FEATURE_REQUESTS、复查并晋升到项目记忆。安装前建议打开包内 SKILL.md 确认是否符合预期。
官方页面：https://www.skillhub.cn/skills/user_36090e04/apu-case-gen
API 坐标页：https://api.skillhub.cn/user_36090e04/apu-case-gen
