名称: workflows-compound 描述: 记录最近解决的问题，以复利你的团队知识

参数

[可选: 关于修复的简要上下文]

/compound

协调多个并行工作的子代理来记录最近解决的问题。

目的

在上下文新鲜时捕获问题解决方案，在docs/solutions/中创建带有YAML frontmatter的结构化文档，以便搜索和未来参考。使用并行子代理以实现最大效率。

为什么是“复利”？ 每个记录的解决方案都会复利你的团队知识。第一次解决问题需要研究。记录下来，下一次出现时只需几分钟。知识复利。

用法

/workflows:compound                    # 记录最近的修复
/workflows:compound [简要上下文]    # 提供额外的上下文提示

执行策略: 并行子代理

此命令启动多个专业化的子代理并行工作以最大化效率:

1. 上下文分析器 (并行)

提取对话历史
识别问题类型、组件、症状
验证解决方案模式
返回: YAML frontmatter骨架

2. 解决方案提取器 (并行)

分析所有调查步骤
识别根本原因
提取工作解决方案和代码示例
返回: 解决方案内容块

3. 相关文档查找器 (并行)

搜索docs/solutions/中的相关文档
识别交叉引用和链接
查找相关的GitHub问题
返回: 链接和关系

4. 预防策略师 (并行)

开发预防策略
创建最佳实践指南
生成测试用例（如果适用）
返回: 预防/测试内容

5. 分类器 (并行)

确定最佳的docs/solutions/类别
验证类别是否符合模式
基于slug建议文件名
返回: 最终路径和文件名

6. 文档编写器 (并行)

组装完整的markdown文件
验证YAML frontmatter
格式化内容以提高可读性
在正确位置创建文件

7. 可选: 专业化代理调用 (文档后)

基于检测到的问题类型，自动调用适用的代理:

performance_issue → performance-oracle
security_issue → security-sentinel
database_issue → data-integrity-guardian
test_failure → cora-test-reviewer
任何代码密集型问题 → kieran-rails-reviewer + code-simplicity-reviewer

它捕获什么

问题症状: 确切的错误消息、可观察的行为
调查步骤尝试: 什么没有工作以及为什么
根本原因分析: 技术解释
工作解决方案: 逐步修复和代码示例
预防策略: 如何在未来避免
交叉引用: 链接到相关问题和文档

前提条件

<前提条件 enforcement=“advisory”> <检查 condition=“problem_solved”> 问题已解决（不是进行中） </检查> <检查 condition=“solution_verified”> 解决方案已验证工作 </检查> <检查 condition=“non_trivial”> 非琐碎问题（不是简单拼写错误或明显错误） </检查> </前提条件>

它创建什么

有组织的文档:

文件: docs/solutions/[类别]/[文件名].md

从问题自动检测的类别:

build-errors/
test-failures/
runtime-errors/
performance-issues/
database-issues/
security-issues/
ui-bugs/
integration-issues/
logic-errors/

成功输出

✓ 并行文档生成完成

主要子代理结果:
  ✓ 上下文分析器: 识别了brief_system中的performance_issue
  ✓ 解决方案提取器: 提取了3个代码修复
  ✓ 相关文档查找器: 找到了2个相关问题
  ✓ 预防策略师: 生成了测试用例
  ✓ 分类器: docs/solutions/performance-issues/
  ✓ 文档编写器: 创建了完整的markdown

专业化代理审查（自动触发）:
  ✓ performance-oracle: 验证了查询优化方法
  ✓ kieran-rails-reviewer: 代码示例符合Rails标准
  ✓ code-simplicity-reviewer: 解决方案适当最小化
  ✓ every-style-editor: 文档风格已验证

文件创建:
- docs/solutions/performance-issues/n-plus-one-brief-generation.md

此文档将在未来类似
问题出现在Email Processing或Brief System模块时可搜索参考。

下一步是什么?
1. 继续工作流（推荐）
2. 链接相关文档
3. 更新其他引用
4. 查看文档
5. 其他

复利哲学

这创建了一个复利知识系统:

第一次解决“brief生成中的N+1查询” → 研究（30分钟）
记录解决方案 → docs/solutions/performance-issues/n-plus-one-briefs.md（5分钟）
下一次类似问题出现 → 快速查找（2分钟）
知识复利 → 团队变得更聪明

反馈循环:

构建 → 测试 → 发现问题 → 研究 → 改进 → 文档 → 验证 → 部署
    ↑                                                                      ↓
    └──────────────────────────────────────────────────────────────────────┘

每个工程工作单元应该使后续工作单元更容易—而不是更难。

自动调用

<自动调用> <触发短语> - “that worked” - “it’s fixed” - “working now” - “problem solved” </触发短语>

<手动覆盖> 使用 /workflows:compound [context] 立即文档化，无需等待自动检测。 </手动覆盖> </自动调用>

路由到

compound-docs 技能

适用的专业化代理

基于问题类型，这些代理可以增强文档:

代码质量与审查

kieran-rails-reviewer: 审查代码示例的Rails最佳实践
code-simplicity-reviewer: 确保解决方案代码最小化和清晰
pattern-recognition-specialist: 识别反模式或重复问题

特定领域专家

performance-oracle: 分析performance_issue类别解决方案
security-sentinel: 审查security_issue解决方案的漏洞
cora-test-reviewer: 为预防策略创建测试用例
data-integrity-guardian: 审查database_issue迁移和查询

增强与文档

best-practices-researcher: 用行业最佳实践丰富解决方案
every-style-editor: 审查文档风格和清晰度
framework-docs-researcher: 链接到Rails/gem文档引用

何时调用

自动触发 (可选): 代理可以在文档后运行以增强
手动触发: 用户可以在 /workflows:compound 完成后调用代理进行更深层审查

工作流：知识复利Skill workflows-compound