SuperAPI AI 工具集

bloom-crystallize

智能体与模型

查看项目

更新于 10-23 23:07

技能介绍

用途

CocoBloom 结晶(crystallization)用于从最近一次已完成并成功 ship 的执行轨迹中,提取出一个可复用的技能(skill)。其目标是把一次成功实践中值得保留的模式固化为技能文件,供未来会话使用。

主要能力

  • 校验 CocoPlus 是否已初始化(检查 .cocoplus/ 是否存在)。
  • 验证近期是否存在成功的 ship:读取 .cocoplus/lifecycle/meta.json,检查 current_phase 为 "ship" 且 ship_completed_at 存在,或最近一次阶段记录显示 7 天内成功 ship。
  • 读取执行轨迹:读取 .cocoplus/lifecycle/deployment.md 以及 .cocoplus/flow.json 运行时状态中最近的 flow 阶段输出,收集交付物、应用的模式、关键决策、有效的命令与序列、非显而易见的技术等。
  • 通过 Haiku 子代理识别最可复用的模式,输出模式名称(kebab-case,≤5 词)、解决的问题、泛化后的步骤序列、新项目需填写的参数、非显而易见之处;若无泛化模式则输出 NO_CRYSTALLIZABLE_PATTERN。
  • 通过 Sonnet 子代理将模式抽象为符合规范的 CocoPlus 技能文件,要求包含标准 SKILL.md frontmatter(name、description、version、author、tags)、明确目标、带具体文件路径的编号步骤、Anti-Rationalization 表、Exit Criteria,对项目特定值使用 $ 语法,篇幅约 50–100 行。
  • 向开发者展示草稿并等待 ACCEPT / REVISE / DISCARD 输入。
  • 仅在开发者 ACCEPT 后写入技能文件,并创建 git 提交。

使用方式

通过 $bloom 调用。执行流程如下:

  1. 校验 .cocoplus/ 是否存在;若不存在,输出 "CocoPlus is not initialized. Run $pod init first." 并停止。
  2. 验证近期成功 ship;若未找到,输出 "CocoBloom crystallization requires a recent successful $ship. Complete the lifecycle through the Ship phase before crystallizing." 并停止。
  3. 读取执行轨迹(deployment.md 与 flow.json 运行时状态)。
  4. 启动 Haiku 子代理(Trace Reader)识别可复用模式;若输出 NO_CRYSTALLIZABLE_PATTERN,提示开发者 "No generalizable pattern found in this execution trace. Crystallization requires a pattern that would apply to future projects." 并停止。
  5. 启动 Sonnet 子代理(Pattern Abstractor)生成技能文件内容。
  6. 展示草稿供开发者审阅,等待 ACCEPT / REVISE / DISCARD。REVISE 时收集反馈并以附加约束重跑第 4 步(抽象步骤);DISCARD 时输出 "Crystallization cancelled." 并停止。
  7. 仅在 ACCEPT 后,将技能写入 .cortex/skills/crystallized/<slug>/SKILL.md,frontmatter 中带 source: crystallized;如目录不存在则创建。
  8. 创建 git 提交:feat(skills): crystallize <slug> skill from execution trace。
  9. 输出确认信息:
CocoBloom: skill crystallized.
  File: .cortex/skills/crystallized/<slug>/SKILL.md
  Source: crystallized from <deployment.md date>
  Invoke with: $<slug>

该技能是项目产物,会提交到 git 并可供未来会话使用。

适用场景

适用于在 CocoPlus 生命周期中刚完成一次成功 ship、希望把其中可泛化的做法沉淀为可复用技能的场景。

限制

  • 必须已初始化 CocoPlus(.cocoplus/ 存在)。
  • 必须存在近期成功的 $ship,否则无法结晶。
  • 若执行轨迹中不存在可泛化模式,则无法结晶。
  • 技能文件仅在开发者 ACCEPT 后才会写入。
  • 技能需足够通用,不能硬编码当前项目数据。

Anti-Rationalization 表

捷径 / 诱惑 为何失败
跳过 ship 验证 从不完整的执行中结晶会产生反映部分工作的技能
未经开发者 ACCEPT 就写入技能 开发者必须审阅——抽象器可能过度泛化或泛化不足
跳过 trace reader 直接进入抽象器 trace reader 负责识别值得结晶的内容——没有它,抽象器会处理所有内容

Exit Criteria

  • 仅在开发者 ACCEPT 后写入技能文件。
  • frontmatter 中存在 source: crystallized 元数据。
  • 已创建 git 提交。
  • 技能足够通用,可应用于未来项目(未硬编码当前项目数据)。