SkillMemory

给任意 Skill 注入记忆能力，让它越用越好用

English | 中文

---

你是否遇到过这些问题？

痛点	场景
修正反复丢失	你告诉 Skill "PRD 开头先量化问题"，下次对话又忘了
关闭就丢进度	写到一半关闭对话，下次得从头解释背景
决策悄悄跑偏	上次否决了方案 A，新对话又重新提议
Skill 永不进化	用了 50 次，还是犯第 1 次的错
经验越积越乱	没有清理机制，信息越来越多但没法用

SkillMemory 就是为解决这些问题而生的。

核心价值

改造前:  用户修正 → 丢失 → 重复修正 → 沮丧
改造后:  用户修正 → 自动记录 → 下次应用 → 越来越好

1. 修正不再丢失

用户修正自动记录为经验。下次对话启动时自动读取并应用。

第 1 次:  "标题别超过 20 字"     → 写入经验记录
第 2 次:  自动遵守，不再超长       → 用户满意
第 50 次: 所有偏好都已内置         → 感觉像专属助手

2. 经验自动进化

同类经验重复 3 次后，自动建议提炼为核心规则。Skill 会越用越准。

经验记录（临时） ──≥3次──→ 核心规则（永久）
    ↑                          │
    └──── 持续积累 ←────────────┘

3. 关闭不丢进度

独立任务文档锚定工作状态。关闭对话后下次无缝续接。

• 任务目标、当前进展、已做决策（含理由和排除方案）
• 启动时自动核对：任务文档 x git log x 文件状态
• 不一致时主动提示，防止跑偏

4. 决策不再重复

每次决策强制记录"选了什么 + 为什么 + 排除了什么"。杜绝重复提议已否决方案。

5. 自动健康巡检

每周巡检知识库，超阈值提醒整理。经验有进有出，不会越积越乱。

改造前后对比

改造前

my-skill/
├── SKILL.md          # 只有业务逻辑，无记忆能力

每次对话结束后，一切归零。

改造后（5 分钟）

my-skill/
├── SKILL.md                        # 业务逻辑（不变）
├── my-skill-know-how.md             # 新增：知识库（核心规则 + 经验 + 任务索引）
├── .claude/
│   └── rules/
│       └── memory-guard.md          # 新增：记忆守卫（自动注入每个对话）
├── docs/
│   └── tasks/                       # 新增：跨会话任务文档
│       └── done/                    # 已完成任务归档

改造后效果：

对话	行为
第 1 次	用户说"章节按读者角色划分" → 写入经验
第 2 次	自动应用，直接按角色划分 → 用户满意
第 3 次	同类经验 ≥3 → 建议提炼为核心规则
中断后恢复	自动读取任务文档 + 核对 git 状态 → 无缝续接

5 分钟完成改造

步骤	耗时	你需要做的
生成知识库	2 分钟	填写 3-5 条核心规则（"正确做法"和"质量底线"）
部署守卫规则	1 分钟	自动复制到项目 .claude/rules/
创建任务目录	10 秒	自动创建
配置巡检	1 分钟	自动创建每周巡检
合计	~5 分钟	改造完成，记忆能力自动生效

工作原理

SkillMemory 通过注入 3 个组件为现有 Skill 添加记忆能力，不修改原 Skill 逻辑：

┌─────────────────────────────┐
│        目标 SKILL.md         │  （业务逻辑，原封不动）
├─────────────────────────────┤
│  memory-guard.md（守卫规则） │  （自动注入，强制执行记忆规则）
├─────────────────────────────┤
│  *-know-how.md（知识库）     │  （核心规则 + 经验 + 任务索引）
├─────────────────────────────┤
│  docs/tasks/*.md（任务文档） │  （跨会话任务续接）
└─────────────────────────────┘

三种记忆类型

类型	内容	生命周期	维护者
核心规则	定义、标准	永久	开发者
经验记录	用户修正、偏好	持续积累，可晋升/归档	守卫自动维护
任务记忆	目标、决策、进展	任务期间	守卫自动维护

使用方式

安装

将 SkillMemory/ 目录放入 CodeBuddy 的 skills 目录即可。

改造现有 Skill

对 CodeBuddy 说：

给 Skill 加记忆，目标路径：/path/to/your-skill

SkillMemory 会自动完成全部改造步骤。

维护知识库

命令	行为
整理 KB <名称>	扫描知识库，晋升高频经验为核心规则，归档旧记录
检查 KB 健康	输出健康报告

技术亮点

• 零侵入：不修改目标 Skill 代码，通过规则注入和知识库文件添加记忆能力
• 自动过滤：跳过一次性错误、重复修正、纯格式调整，只记录有价值的经验
• 渐进式学习：经验积累 → 频率检测 → 晋升建议，形成完整学习闭环
• 一致性校验：任务文档 x git log x 文件状态三维核对，防止状态不一致
• 自动巡检：基于 CodeBuddy automation 的每周健康检查，超阈值自动提醒

适用场景

• 文档协作类 Skill（doc-coauthoring、技术方案撰写等）
• 代码生成类 Skill（有编码风格和架构偏好）
• 任何需要"越用越懂你"的 Skill

License

MIT