SuperAPI AI 工具集

compound

编程与开发

查看项目

更新于 10-15 08:13

技能介绍

用途

Compound 用于在开发周期完成后,提取本次开发中的模式、陷阱和关键决策,沉淀为可复用的结构化知识。其定位与 sync 互补:sync 同步文档状态、追溯矩阵,确保「这次做对了」;compound 提取经验、沉淀模式,确保「下次也能做对」。

主要能力

  • 回顾本次开发:读取 verify-report.md、04-dev-tasks*.md、git log 及对话中的关键决策点。
  • 提取候选模式:包括有效的解决方案(正面模式)、踩过的坑和修复方式(陷阱)、关键技术决策及理由(决策记录)、可复用的代码或架构模式、验证盲区。
  • 去重检查:扫描 docs/devdocs/patterns/ 已有模式,跳过相似模式或标记为「更新」。
  • 与用户确认:展示候选模式列表,由用户选择写入、跳过或修改。
  • 写入模式文档:新模式创建 docs/devdocs/patterns/<pattern-name>.md,已有模式则编辑现有文件。
  • 验证盲区提取:发现盲区时追加到 docs/devdocs/patterns/verify-blindspots.md,形成 verify → 使用 → 发现遗漏 → compound 沉淀 → verify 改进的闭环。
  • 系统学习检查:回答规则、模板、检查器、验证盲区四个维度是否已沉淀,未沉淀项说明原因。

使用方式

运行模式:

  • /compound:完整流程(提取 + 写入 + 更新)
  • /compound --extract-only:仅提取,不写入文件(预览模式)
  • /compound --check:系统学习检查(仅评估是否有未沉淀的经验)

触发条件:sync 完成后(推荐)、一轮开发迭代结束后、用户主动要求提取经验教训、发现值得记录的模式或陷阱。

语言规则:支持中英文提问,统一中文回复,使用中文生成文档。

适用场景

  • 开发迭代结束后沉淀经验。
  • 发现可复用的代码模式或架构模式。
  • 记录踩坑与修复方式,避免重复犯错。
  • 记录非显而易见的技术决策及理由。
  • 发现 verify 未检出的验证盲区并改进验证流程。

限制

  • 不修改代码文件。
  • 不修改现有 keel 文档,仅新建或更新 patterns/ 目录。
  • 不直接修改 AGENTS.md,需更新时建议用户运行 /agent-memory。
  • 必须与用户确认后再写入(--extract-only 仅预览)。
  • 模式必须包含「问题背景」和「解决方式」,以及「适用条件」和「禁忌条件」。
  • 项目特有且不可复用的细节、显而易见的最佳实践、临时性 workaround、已在 AGENTS.md 或 SKILL.md 中覆盖的规则不值得提取。

协作关系

  • 前置:/sync、/verify、/dev-workflow。
  • 知识更新:/agent-memory。

输出文件

  • 模式文档:docs/devdocs/patterns/<pattern-name>.md
  • 系统学习检查结论:输出到对话,不单独生成文件。