SuperAPI AI 工具集

ce-compound

写作与研究

查看项目

更新于 10-16 09:23

技能介绍

ce-compound 是 compound-engineering-skills 提供的一项技能,用途是在问题刚被解决、上下文仍然新鲜时,把解决方案记录成结构化文档,让团队知识“复利式”积累:第一次解决某个问题需要调研,记录下来后,下次再遇到只需几分钟。

【用途】 调用形式为 /ce-compound,用于记录最近一次的修复,或补充一段简要上下文提示。文档存放在 docs/solutions/ 目录下,带 YAML frontmatter,便于搜索和日后引用。它强调“compound(复利)”这一理念:每份被记录的方案都在为团队知识做加法。

【使用方式与模式】 技能会检查参数中是否包含 mode:headless 标记。以 mode: 开头的 token 属于标志位而非上下文,需剥离后作为上下文提示。

  • 交互模式(默认,无 mode token):会询问用户选择“完整流程”还是“轻量流程”;若选完整流程,会再问是否检索当前 harness 的会话历史;会征询可发现性检查的同意;最后以“下一步做什么”菜单结束。交互模式下不得预先选定模式、不得跳过提问。
  • headless 模式(参数含 mode:headless):无阻塞式提问,运行完整流程但不检索会话历史,若存在可发现性缺口则静默应用修订,跳过第三阶段的专项评审,最后输出结构化终端报告,不提供“下一步”菜单。该模式面向自动化与技能间调用,产出的文档与交互式完整流程一致。

【执行策略】 headless 模式跳过交互提问,直接进入完整流程且禁用会话历史。交互模式先让用户选择完整流程或轻量流程:完整流程会做研究、交叉引用与评审;轻量流程产出同样的文档但为单遍处理,更快、token 更少,但不检测重复、不交叉引用已有文档,适合简单修复或临近上下文上限的长会话。

【完整流程的各个阶段】

  • 阶段 0.5 自动记忆扫描:检查系统提示中注入的自动记忆块(仅 Claude Code),用语义判断寻找与当前问题相关的条目,作为补充上下文传给后续任务;若最终文档引用了记忆内容,会标注来源。
  • 阶段 1 研究:并行启动上下文分析器、方案提取器、相关文档查找器;随后(仅在用户选择检索会话历史时)同步调用 ce-sessions 技能,并传入精简的调度负载(预解析上下文、时间窗口、问题主题、过滤规则与输出结构)。子代理只向编排器返回文本数据,不得写文件。
  • 上下文分析器:读取 schema.yaml 校验枚举与判定问题轨道(bug 或 knowledge),确定问题类型、组件与相应字段,读取 yaml-schema.md 做分类映射,建议文件名(不带日期后缀),返回 frontmatter 骨架、分类目录路径、文件名与适用轨道。
  • 方案提取器:按轨道适配输出结构。bug 轨道输出 Problem、Symptoms、What Didn't Work、Solution、Why This Works、Prevention;knowledge 轨道输出 Context、Guidance、Why This Matters、When to Apply、Examples。
  • 相关文档查找器:在 docs/solutions/ 中检索相关文档,识别交叉引用与链接,查找相关 GitHub issue,标记可能过时或被推翻的文档,并按五个维度(问题陈述、根因、方案思路、引用文件、预防规则)评估重叠度,分为高(4-5 维匹配)、中(2-3 维)、低(0-1 维)。搜索策略以 grep 优先预筛,先只读前 30 行 frontmatter 打分,再完整读取强相关文件;GitHub issue 搜索优先用 gh CLI,其次 GitHub MCP 工具,都没有则跳过并说明。
  • 阶段 2:组装文档,按需读取 resolution-template.md,并运行 scripts/validate-frontmatter.py 做 frontmatter 解析安全校验(仅 Claude Code 通过 ${CLAUDE_SKILL_DIR} 解析,其他环境用手工清单回退)。2.4 步做词汇捕获:当出现符合条件的领域术语时创建或更新 CONCEPTS.md(只播种该学习所属领域,不覆盖整个仓库)。

【关键约束】 主要交付物是一份文档。阶段 1 的子代理只返回文本,不得写文件;只有编排器写文件。除方案文档外,编排器还会产生维护性副作用写入:在需要时创建或更新 CONCEPTS.md,以及在可发现性检查发现缺口时对项目指令文件(AGENTS.md 或 CLAUDE.md)做小幅编辑。

【适用场景与限制】 适用于记录近期解决的工程问题并沉淀团队知识,尤其适合希望自动化的场景(headless 模式)。若调用目的从零创建或引导 CONCEPTS.md,则不应走常规阶段,而应重定向到 ce-compound-refresh(它会询问是构建概念图还是运行刷新周期),随后退出;全仓库范围的概念图创建属于 ce-compound-refresh 的职责。技能是自包含的,专家人设放在 references/personas/ 下,不依赖已注册子代理或 agents/ 目录;若 harness 支持子代理则启动子代理并传入人设文件全文,否则在本地上下文内联采用该人设。人设的“操作约束”行(如只读)在两种模式下都需遵守。支持文件按需读取,不在技能启动时批量加载。

关于收费、价格、平台支持范围等具体信息,资料未提供。