SuperAPI AI 工具集

flow-template

智能体与模型

查看项目

更新于 10-23 23:08

技能介绍

用途

flow-template 用于管理可复用的 CocoFlow 2.0 执行计划模板。模板保存在 .cocoplus/flows/templates/ 目录下,记录一次成功流程运行的编排阶段输出,包括:战略评估摘要、依赖图、依赖分组、模型层级分配、每步上下文简报、预期输出、验证命令,以及实测的规划/执行成本拆分。

前置条件

使用前需确认 .cocoplus/ 目录存在。若不存在,应输出 "CocoPlus not initialized in this directory. Run $pod init to begin." 并停止。

主要能力与命令

$flow template list

读取 .cocoplus/flows/templates/ 下所有 *.json 文件,显示:name、source session、archetype、saved_at、last_used_at、reuse_count,以及预估的规划绕过节省。若无模板,输出提示:"No execution plan templates saved. Run $flow template save --from <session-id> --name <name> after a successful flow run."

$flow template save --from <session-id> --name <name>

在 .cocoplus/flows/runs/ 或 .cocoplus/harvest/ 中定位该会话已完成的编排产物,并验证其包含 dependency_graph、dependency_groups、tier_assignments、context_briefs、expected_outputs。若任一 per-step context_briefs[*].text 超过 200 词,则拒绝保存。通过后原子写入 .cocoplus/flows/templates/<name>-plan.json;若 meter 状态存在,则向 .cocoplus/meter/template-benchmarks.jsonl 追加 FLOW_TEMPLATE_SAVED 条目。

$flow template validate <name>

加载 .cocoplus/flows/templates/<name>-plan.json,将模板步骤与当前 .cocoplus/flow.json 比对;在存在 trace/context 产物时,验证引用的 Snowflake 对象。报告 PASS、WARN 或 FAIL,并列出不兼容项。FAIL 意味着 $flow run 必须使用全新的编排阶段。

$flow template show <name>

显示战略适配、依赖分组、模型层级分配和上下文简报形态。除非明确要求,不打印完整的历史 worker 上下文。

$flow template delete <name>

归档到 .cocoplus/flows/templates/archive/<timestamp>-<name>-plan.json,而非直接删除。

V2 集成

在 $flow run 开始时尝试模板匹配。若某个已验证模板与当前 flow.json 形态及上下文槽位匹配,则跳过战略评估与编排阶段,直接从模板派发;否则运行全新编排,并在完成后提供保存该计划的选项。

退出标准

  • list 报告所有已保存模板并处理空状态。
  • save 拒绝不完整的编排产物以及超过 200 词的上下文简报。
  • validate 逐项列出不兼容之处。
  • show 预览模板形态而不淹没 worker 上下文。
  • delete 执行归档而非移除。

限制与注意事项

该技能强调技能契约必须描述可观察行为与验证方式,而非仅命令名称;即使是小命令也会改变状态或引导执行,因此需保留相同的检查关卡。