知识沉淀 Skill
在任务完成后回顾本轮工作,判断哪些内容应沉淀到 AGENTS.md、skills、memory、知识体系文档,输出具体的更新建议和补丁。
何时使用
- 任务完成、会话即将结束时
- 刚解决了一个复杂 bug 或完成了一个重要功能
- 发现了新的项目约束、团队规范、架构决策
- 用户主动要求"总结一下这次工作"或"把这些记下来"
不适用:纯对话问答、未完成的任务、临时性探索。
输入
- 本轮对话的完整上下文
- 项目中已有的 AGENTS.md(若存在)
- 项目中已有的 memory 文件(若存在)
- 用户明确要求沉淀的目标文件(可选)
输出
一份结构化的沉淀报告,包含:
- 沉淀候选项列表 — 每项标注来源、类型、推荐落点
- 推荐落点判断 — AGENTS.md / memory / skill / 项目文档 / 不沉淀
- 具体改动内容 — 每个落点的具体新增/修改文本
- 优先级排序 — 高(长期复用价值)/ 中(可能复用)/ 低(仅供参考)
- 最终补丁 — 可直接应用的 diff 或完整文本块
执行步骤
1. 回顾本轮工作
- 梳理本轮对话中完成的所有任务
- 识别关键决策、踩过的坑、发现的约束、验证过的假设
- 标记哪些是事实(已验证)、哪些是推测(未验证)
2. 判断沉淀价值
对每个候选知识点,依次判断:
| 判断维度 | 问题 |
|---|---|
| 复用性 | 未来还会遇到吗? |
| 稳定性 | 这个结论会很快过时吗? |
| 通用性 | 只对当前项目有效,还是跨项目有效? |
| 验证度 | 已验证还是推测? |
| 唯一性 | 已有知识体系中是否已覆盖? |
3. 确定落点
IF 跨项目通用 AND 稳定 → 写入用户的 memory 或全局 AGENTS.md
IF 项目级规则 AND 稳定 → 写入项目 AGENTS.md
IF 与特定能力相关 AND 可复用 → 提炼为 skill 的一部分
IF 与项目文档体系相关 → 写入对应项目文档
IF 一次性结论 OR 未验证 OR 短期有效 → 不沉淀,仅在对话中说明
4. 生成具体改动
- 对每个推荐沉淀项,给出目标文件路径
- 给出要插入/修改的具体文本
- 标注插入位置(文件末尾、特定章节之后等)
- 若有冲突与已有内容,明确说明如何合并
5. 输出沉淀报告
格式示例:
## 沉淀报告
### 候选项 1: [标题]
- 来源: 本轮调试 X 问题时的发现
- 类型: 项目约束
- 落点: AGENTS.md → 构建约束章节
- 优先级: 高
- 改动:
文件: AGENTS.md
位置: "构建约束" 章节末尾
内容: |
- 生产环境构建必须使用 Node 18+,低于此版本会出现 Buffer.alloc 不可用错误
### 候选项 2: ...
边界与非目标
- 不做自动写入 — 只提供建议和补丁,由用户确认后执行
- 不做文档体系治理 — 这是 project-doc-generator 的职责
- 不做memory 治理(去重、过期清理)— 这是 memory-governance 的职责
- 不做AGENTS.md 结构维护 — 这是 agents-md-maintainer 的职责
- 只关注"本轮工作产出了什么值得沉淀的内容",不负责历史知识审计
验收标准
- 沉淀报告中每一项都有明确的落点和具体改动文本
- 没有将临时性、未验证内容标记为"高优先级沉淀"
- 至少识别出 1 个值得沉淀的知识点(如果本轮工作有实质内容)
- 生成的补丁文本可以直接复制到目标文件中生效