compound-docs 是一个流程型技能,用途是在问题解决后自动或手动把解决过程记录下来,形成团队可复用的知识。它适用于记录已解决的问题、整理经验教训,并为 /workflows:compound 工作流提供过程知识。
主要能力包括:检测确认信号(如“that worked”“it's fixed”等)后自动触发,跳过琐碎修复;收集上下文,提取模块、症状、调查尝试、根因、解决方案和预防措施,关键信息缺失时会阻止继续;检查 docs/solutions/ 中是否存在相似问题,若存在则提供新建并交叉引用、更新已有文档或其他选项;生成文件名,格式为 [sanitized-symptom]-[module]-[YYYYMMDD].md;对文件运行 validate-frontmatter.sh 校验 YAML frontmatter,不通过则修复并重跑,直到通过;使用 resolution-template.md 将文档写入 docs/solutions/[category]/[filename].md;最后进行交叉引用,并识别临界模式(3 个以上相似问题)。
采用单文件架构:每个问题一个 Markdown 文件,放在症状分类目录中,并带 YAML frontmatter。文档完成后会展示决策菜单并等待用户响应,选项包括继续工作流、加入必读、关联相关问题、加入已有技能、创建新技能、查看文档或其他。
成功标准包括:YAML frontmatter 通过校验,字段与枚举值符合 schema;文件创建在 docs/solutions/[category]/[filename].md;解决方案部分包含代码示例;如发现相关问题则添加交叉引用;展示决策菜单并确认操作。相关参考文件有 documentation-process.md、yaml-schema.md、quality-guidelines.md、example-scenario.md、resolution-template.md、critical-pattern-template.md、validate-frontmatter.sh。集成方面,/compound-refresh 命令会审查 docs/solutions/ 中是否有过时学习内容。限制方面,资料未提供具体平台、收费、价格、性能效果等信息。