用途
compound 用于在问题刚被解决、验证有效、排查细节尚新鲜时，及时把解决方案沉淀为可检索的文档。触发场景包括“that worked”“it's fixed”“working now”“problem solved”“tests are passing”等说法。适合非平凡的修复，即不是简单笔误或显而易见错误的情况；修复仍在进行或未经验证、问题过于琐碎时不应使用。
主要能力
- 自动把解决方案写入
docs/solutions/[category]/[filename].md，并生成 YAML frontmatter 以便搜索。 - 从问题类型自动判定类别：build-errors、test-failures、runtime-errors、performance-issues、database-issues、security-issues、ui-bugs、integration-issues、logic-errors。
- 默认执行完整模式：先读取自动记忆目录中的 MEMORY.md，若存在与当前问题相关的条目，会作为补充摘录传给上下文分析与方案提取环节，并在最终文档中标注为“(auto memory [claude])”。
- 第一阶段并行启动五个子代理，各自只返回文本数据、不写文件：上下文分析器返回 YAML frontmatter 骨架（问题类型、组件、症状）；方案提取器返回根因与可用的解决方案及代码示例；相关文档查找器返回交叉引用、相关问题与过期文档候选；预防策略师返回预防策略与测试用例；分类器返回最终文件路径。
- 第二阶段等待全部子代理完成后，汇总文本、组装 Markdown、校验 YAML frontmatter，创建目录并写出唯一最终文件。
- 第二阶段之后进行选择性刷新检查：若新修复与旧文档建议相矛盾，调用
rubypowers:compound-refresh [doc-name]；若新修复取代旧方案，按最小必要范围调用；同一区域有多个相关候选时询问用户是否做定向刷新；无相关文档或文档仍一致则跳过。不得在无范围参数时调用刷新。 - 第三阶段可选增强：按问题类型调用专门代理，性能问题用 performance-oracle，安全问题用 security-sentinel，数据库问题用 data-integrity-guardian，测试失败用 cora-test-reviewer，代码较多时用 kieran-rails-reviewer 与 code-simplicity-reviewer。
使用方式
/rubypowers:compound：记录最近一次修复。/rubypowers:compound [brief context]：附带额外上下文提示。/compound --compact：上下文受限会话使用的单遍模式。
默认始终运行完整模式，仅在明确要求时使用紧凑模式。紧凑模式跳过第一阶段子代理，按顺序从对话历史（及相关 MEMORY.md 笔记）中提取问题、根因与方案，判定类别，写出含 YAML frontmatter、1 至 2 句问题描述、根因、关键代码片段和一条预防提示的最小文档，并跳过第三阶段审查。
关键约束
整个流程只写一个文件，即最终文档。第一阶段子代理只返回文本数据，不得写文件；只有主控在第二阶段写出最终文档。常见错误包括：让子代理写 context-analysis.md、solution-draft.md 等文件；把研究与组装并行执行；在工作流中创建多个文件。正确做法是研究完成后才组装，最终只产出 docs/solutions/[category]/[filename].md 一个文件。