定位
devdocs-compound 是一个知识复利沉淀技能，用于在开发周期完成后，提取本次开发中的模式、陷阱和关键决策，沉淀为可复用的结构化知识。
它与 devdocs-sync 互补：devdocs-sync 同步文档状态、追溯矩阵，实现文档层面的完成；devdocs-compound 提取经验、沉淀模式，实现知识层面的复利。devdocs-sync 确保「这次做对了」，本 Skill 确保「下次也能做对」。
触发条件
- devdocs-sync 完成后（推荐）
- 一轮开发迭代结束后
- 用户主动要求提取经验教训
- 发现值得记录的模式或陷阱
运行模式
/devdocs-compound：完整流程（提取 + 写入 + 更新）/devdocs-compound --extract-only：仅提取，不写入文件（预览模式）/devdocs-compound --check：系统学习检查（仅评估是否有未沉淀的经验）
工作流程
- 回顾本次开发：读取 verify-report.md（若存在）、04-dev-tasks*.md、git log，并回顾对话中的关键决策点。
- 提取候选模式：有效解决方案（正面模式）、踩过的坑和修复方式（陷阱）、关键技术决策及理由（决策记录）、可复用的代码或架构模式。
- 去重检查：扫描 docs/devdocs/patterns/ 已有模式，跳过相似模式或标记为「更新」。
- 与用户确认：展示候选模式列表，用户选择写入 / 跳过 / 修改。
- 写入模式文档：新模式创建 docs/devdocs/patterns/<pattern-name>.md，已有模式则编辑现有文件。
- 建议运行
/agent-memory更新 AGENTS.md（可选，仅当模式具有项目级影响时）。 - 系统学习检查。
模式提取指南
值得提取的类型：
- 正面模式：解决了反复出现的问题
- 陷阱：踩坑后修复，且可能再次遇到
- 决策：有明确取舍，且理由非显而易见
- 工作流：发现了更高效的开发流程
不值得提取：项目特有且不可复用的细节、显而易见的最佳实践、临时性 workaround（除非标记为临时）、已在 AGENTS.md 或 SKILL.md 中覆盖的规则。
模式文档结构统一，详见 templates/pattern.md。文件命名采用 kebab-case：docs/devdocs/patterns/<kebab-case-pattern-name>.md。
系统学习检查
每次执行 /devdocs-compound 时，必须回答三个维度：
- 规则检查：本次遇到的问题，是否已沉淀为规则（约束/检查项）？
- 模板检查：本次的解决方案，是否应更新到某个模板中？
- 检查器检查：本次的验证逻辑，是否可自动化为检查步骤？
检查输出格式以表格呈现规则/模板/检查器三个维度，并说明未沉淀原因。
输出文件
- 模式文档：docs/devdocs/patterns/<pattern-name>.md
- 系统学习检查结论：输出到对话（不单独生成文件）
约束
提取约束：必须回顾 verify-report 和任务文档；必须与用户确认后再写入（--extract-only 仅预览）；必须检查已有模式避免重复；模式文档遵循模板结构；文件名使用 kebab-case。
质量约束：模式必须包含「问题背景」和「解决方式」；必须包含「适用条件」和「禁忌条件」；描述具体可操作；关联 Skill/模板字段帮助 Agent 发现和复用。
系统学习约束：每次执行必须完成系统学习检查；结论必须回答三个维度；未沉淀项必须说明原因。
安全约束：不修改代码文件；不修改现有 DevDocs 文档（仅新建/更新 patterns/）；不直接修改 AGENTS.md，需更新时建议用户运行 /agent-memory。
Skill 协作
- 前置 /devdocs-sync：在 sync 完成后执行 compound
- 前置 /devdocs-verify：读取验证报告提取改进模式
- 前置 /devdocs-dev-workflow：在工作流末尾推荐执行
- 知识更新 /agent-memory：大范围知识更新时可配合使用
子 Agent 摘要格式
当本 Skill 作为子 Agent 运行时，返回结构化摘要，包含 skill、patterns_extracted、patterns_updated、patterns_skipped、system_learning（rules_gap/template_gap/checker_gap）、status 和 output_files 字段。
语言规则
支持中英文提问，统一中文回复，使用中文生成文档。