workflows-compound

用途

workflows-compound 用于在问题刚解决、上下文还新鲜时，把解决方案记录成结构化文档，沉淀到 docs/solutions/ 目录，供未来搜索和参考。它强调“复利”理念：第一次解决某个问题需要研究，把方案记录下来，下次再遇到类似问题只需快速查阅，团队知识因此不断累积。

主要能力

该工作流采用两阶段编排（外加可选的第三阶段增强）：

阶段一：并行研究 并行启动多个子代理，各自返回文本数据给编排器，不写任何文件：

Context Analyzer：提取对话历史，识别问题类型、组件、症状，校验 schema，返回 YAML frontmatter 骨架。
Solution Extractor：分析所有排查步骤，识别根因，提取带代码示例的可用解决方案，返回解决方案内容块。
Related Docs Finder：在 docs/solutions/ 中搜索相关文档，识别交叉引用和链接，查找相关 GitHub issue，返回链接与关系。
Prevention Strategist：制定预防策略，生成最佳实践指引，必要时生成测试用例，返回预防/测试内容。
Category Classifier：确定最优的 docs/solutions/ 分类，校验分类是否符合 schema，根据 slug 建议文件名，返回最终路径和文件名。

阶段二：组装与写入 等待阶段一全部完成后，由编排代理（主对话）收集所有文本结果，组装完整 markdown 文件，校验 YAML frontmatter，必要时创建目录 mkdir -p docs/solutions/[category]/，并写入唯一最终文件 docs/solutions/[category]/[filename].md。

阶段三：可选增强 等待阶段二完成后，根据问题类型可选调用专门代理审查文档：performance_issue → performance-oracle；security_issue → security-sentinel；database_issue → data-integrity-guardian；test_failure → cora-test-reviewer；代码密集问题 → kieran-rails-reviewer + code-simplicity-reviewer。

使用方式

/workflows:compound                    # 记录最近一次修复
/workflows:compound [brief context]    # 提供额外上下文提示

自动触发短语包括：“that worked”“it's fixed”“working now”“problem solved”。也可用 /workflows:compound [context] 手动立即记录，无需等待自动检测。

记录内容

问题症状：确切的错误信息、可观察行为
尝试过的排查步骤：哪些没成功以及原因
根因分析：技术解释
可用解决方案：带代码示例的分步修复
预防策略：未来如何避免
交叉引用：相关 issue 和文档的链接

输出与分类

生成文件：docs/solutions/[category]/[filename].md。分类根据问题自动检测，包括：build-errors/、test-failures/、runtime-errors/、performance-issues/、database-issues/、security-issues/、ui-bugs/、integration-issues/、logic-errors/。

成功输出示例会列出各子代理结果、自动触发的专门代理审查，以及创建的文件路径。

适用场景

适用于团队在修复问题后希望快速沉淀知识、避免重复研究的场景，尤其适合需要结构化归档、可搜索、可交叉引用的工程问题记录。

限制与注意事项

关键要求：整个工作流只写入一个文件，即最终文档。阶段一子代理只返回文本数据，不得使用 Write、Edit 或创建任何文件；只有编排器（阶段二）写入最终文档。常见错误包括：让子代理写 context-analysis.md、solution-draft.md 等文件；让研究与组装并行运行；工作流中创建多个文件。正确做法是子代理返回文本、编排器写唯一最终文件，研究完成后再组装。

可用的专门代理

代码质量与审查：kieran-rails-reviewer、code-simplicity-reviewer、pattern-recognition-specialist。特定领域专家：performance-oracle、security-sentinel、cora-test-reviewer、data-integrity-guardian。增强与文档：best-practices-researcher、every-style-editor、framework-docs-researcher。

可通过编辑 compound-engineering.local.md 或调用 setup 技能来配置所有工作流使用的审查代理。

技能介绍

用途