知识复利沉淀

在开发周期完成后，提取本次开发中的模式、陷阱和关键决策，沉淀为可复用的结构化知识。

语言规则

• 支持中英文提问
• 统一中文回复
• 使用中文生成文档

定位

devdocs-sync：同步文档状态、追溯矩阵          → 文档层面的完成
devdocs-compound：提取经验、沉淀模式          → 知识层面的复利

互补关系：devdocs-sync 确保"这次做对了"，本 Skill 确保"下次也能做对"。

触发条件

• devdocs-sync 完成后（推荐）
• 一轮开发迭代结束后
• 用户主动要求提取经验教训
• 发现值得记录的模式或陷阱

运行模式

/devdocs-compound                    → 完整流程（提取 + 写入 + 更新）
/devdocs-compound --extract-only     → 仅提取，不写入文件（预览模式）
/devdocs-compound --check            → 系统学习检查（仅评估是否有未沉淀的经验）

工作流程

1. 回顾本次开发
   ├── 读取 verify-report.md（若存在）
   ├── 读取 04-dev-tasks*.md 了解完成的任务
   ├── 读取 git log 了解提交历史
   └── 回顾对话中的关键决策点
   │
   ▼
2. 提取候选模式
   ├── 有效的解决方案（正面模式）
   ├── 踩过的坑和修复方式（陷阱）
   ├── 关键技术决策及其理由（决策记录）
   └── 可复用的代码模式或架构模式
   │
   ▼
3. 去重检查
   ├── 扫描 docs/devdocs/patterns/ 已有模式
   └── 跳过已存在的相似模式，或标记为"更新"
   │
   ▼
4. 与用户确认
   ├── 展示提取的候选模式列表
   └── 用户选择：写入 / 跳过 / 修改
   │
   ▼
5. 写入模式文档
   ├── 新模式 → 创建 docs/devdocs/patterns/<pattern-name>.md
   └── 已有模式更新 → 编辑现有文件
   │
   ▼
6. 建议运行 `/agent-memory` 更新 AGENTS.md（可选）
   ├── 项目特定知识更新
   └── 仅当模式具有项目级影响时
   │
   ▼
7. 系统学习检查
   ├── 本次遇到的问题是否已沉淀为规则/模板/检查器？
   ├── 若没有，原因是什么？
   └── 输出检查结论

模式提取指南

什么值得提取

类型	信号	示例
正面模式	解决了反复出现的问题	"用 Strategy 模式解耦支付渠道"
陷阱	踩坑后修复，且可能再次遇到	"SQLite 在并发写入时需要 WAL 模式"
决策	有明确取舍，且理由非显而易见	"选择 SSR 而非 SPA 因为 SEO 需求"
工作流	发现了更高效的开发流程	"先写集成测试再拆单元测试更高效"

什么不值得提取

• 项目特有且不可复用的细节
• 显而易见的最佳实践（如"要写测试"）
• 临时性的 workaround（除非标记为临时）
• 已在 AGENTS.md 或 SKILL.md 中覆盖的规则

模式文档结构

每个模式文档遵循统一结构，详见 templates/pattern.md。

文件命名：docs/devdocs/patterns/<kebab-case-pattern-name>.md

系统学习检查

每次执行 /devdocs-compound 时，必须回答以下检查问题：

检查清单

1. 规则检查：本次遇到的问题，是否已沉淀为规则（约束/检查项）？

   • 若是 → 记录在哪个 SKILL.md 或 AGENTS.md 中
   • 若否 → 是否应该沉淀？理由？

2. 模板检查：本次的解决方案，是否应更新到某个模板中？

   • 若是 → 标记目标模板文件
   • 若否 → 理由？

3. 检查器检查：本次的验证逻辑，是否可自动化为检查步骤？

   • 若是 → 标记目标 Skill 的约束章节
   • 若否 → 理由？

检查输出格式

## 系统学习检查

| 维度 | 已沉淀？ | 目标位置 | 备注 |
|------|---------|----------|------|
| 规则 | ✅/❌ | <文件路径> | <说明> |
| 模板 | ✅/❌ | <文件路径> | <说明> |
| 检查器 | ✅/❌ | <文件路径> | <说明> |

**未沉淀原因**：<若有未沉淀项，说明原因>

输出文件

• 模式文档：docs/devdocs/patterns/<pattern-name>.md
• 系统学习检查结论：输出到对话（不单独生成文件）

约束

提取约束

• 必须回顾 verify-report 和任务文档
• 必须与用户确认后再写入（--extract-only 仅预览）
• 必须检查已有模式避免重复
• 模式文档遵循模板结构
• 文件名使用 kebab-case

质量约束

• 模式必须包含"问题背景"和"解决方式"（缺一不可）
• 必须包含"适用条件"和"禁忌条件"（防止误用）
• 模式描述具体、可操作，避免泛泛而谈
• 关联 Skill/模板字段帮助 Agent 发现和复用

系统学习约束

• 每次执行必须完成系统学习检查
• 检查结论必须回答三个维度（规则/模板/检查器）
• 未沉淀项必须说明原因

安全约束

• 不修改代码文件
• 不修改现有 DevDocs 文档（仅新建/更新 patterns/）
• 不直接修改 AGENTS.md，需更新时建议用户运行 /agent-memory

Skill 协作

场景	协作 Skill	说明
前置	/devdocs-sync	在 sync 完成后执行 compound
前置	/devdocs-verify	读取验证报告提取改进模式
前置	/devdocs-dev-workflow	在工作流末尾推荐执行（批量模式默认）
知识更新	/agent-memory	大范围知识更新时可配合使用

子 Agent 摘要格式

当本 Skill 作为子 Agent 运行时，返回以下结构化摘要：

skill: devdocs-compound
patterns_extracted: 2
patterns_updated: 1
patterns_skipped: 0  # 已存在的相似模式
system_learning:
  rules_gap: false
  template_gap: true
  checker_gap: false
status: completed
output_files:
  - docs/devdocs/patterns/strategy-payment-channels.md
  - docs/devdocs/patterns/sqlite-wal-concurrency.md

下一步

结果	建议下一步
提取了新模式	在下次相关开发中参考 docs/devdocs/patterns/
发现规则缺口	更新对应 SKILL.md 的约束章节
发现模板缺口	更新对应 templates/ 文件
无新知识	正常，不是每次迭代都有新模式