SuperAPI AI 工具集

specification-system

设计与创作

查看项目

更新于 10-16 01:33

技能介绍

用途:Specification System 是 OpenRig 意图的声明式原语族,让人和智能体用规格描述可复用的拓扑与行为,避免在对话中反复解释,并可作为可分享产物发布,让他人实例化相同的 rig 结构、角色结构或工作流模式。缺少可靠的 spec 原语时,OpenRig 只能依赖手动启动提示与团队记忆,阻碍可重复性、产品演示、rig bundle 与自动构建。

主要能力:覆盖 rig spec、agent spec、workflow spec、启动/上下文片段、运行模式声明,以及存储和复用这些内容的用户规格库。已交付的界面包括:RigSpec / AgentSpec 编写(agent.yaml、rig.yaml 格式);workflow spec(markdown/YAML 文件,daemon 通过 workflow_specs 表读取缓存);bundle/spec 命令界面(rig bundle / spec / agent / specs ls/show/preview/add/sync/remove/rename);规格库(文件系统支撑,位于 packages/daemon/specs/ 与 ~/.openrig/specs/)。

适用场景:编写 RigSpec / AgentSpec / workflow spec;设计启动/上下文片段;推理规格库生命周期(校验、分享、升级语义);审计规格可移植性;区分 spec、bundle 与 extension。

使用方式:按声明式格式编写规格文件,进行结构校验,安装到规格库,并在干净的 OpenRig 环境实例化。证明标准为:编写规格、结构校验、安装、在干净环境实例化,并同时展示结构校验与运行时实现。

限制:规格不可仅声明拓扑而缺少工作流或运行模式;共享规格若依赖本地路径或隐藏启动片段会在其他主机失败,必须自描述;不应把可复用规格当作一次性文件修改;结构校验不足以证明拓扑真能运行,运行时实现才是真正证明。当前尚未交付:作为一等原语的规格库生命周期(校验、分享、升级)、跨主机规格分享、市场/公共注册表。一次性、不复用的工作可手动组装 rig;打包拓扑与工作流属于 bundle;添加运行时行为属于 extension。