知识复利沉淀

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

语言规则

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

定位

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 时，必须回答以下检查问题：

检查清单

规则检查：本次遇到的问题，是否已沉淀为规则（约束/检查项）？
- 若是 → 记录在哪个 SKILL.md 或 AGENTS.md 中
- 若否 → 是否应该沉淀？理由？
模板检查：本次的解决方案，是否应更新到某个模板中？
- 若是 → 标记目标模板文件
- 若否 → 理由？
检查器检查：本次的验证逻辑，是否可自动化为检查步骤？
- 若是 → 标记目标 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/ 文件
无新知识	正常，不是每次迭代都有新模式