SuperAPI AI 工具集

status-envelope-check

测试与质量

查看项目

更新于 10-23 23:08

技能介绍

status-envelope-check 是 snowflake-labs/cocoplus 中面向 CocoPlus 所属功能的一个 V2 原生、确定性的契约型技能。它的核心用途是:不再调用旧版脚本,而是使用 Coco 原生能力完成原本由 cococonverge/status-envelope-check 执行的同一项状态文件检查行为。

主要能力与要求:

其一,行为迁移。技能要求通过 Coco 原生能力实现功能行为,只有在宿主明确需要时才使用 Read、Write、Edit、Bash;当功能涉及数据访问时使用 Snowflake 工具;当需要独立复核时可使用子代理。旧脚本不得作为实现路径被调用。

其二,约定保持。技能必须保留所属功能技能所记录的状态文件路径、数据结构与用户可见输出,不得改变既有读者依赖的格式。

其三,结构化输出。在产出机器可读状态时,应优先采用确定性的文件解析与结构化状态文件,而不是自由书写的文本。

其四,副作用门槛。如果某项操作会产生外部副作用,须沿用与所属功能相同的校验与确认规则。

退出标准包括:所属功能记录的状态文件已生成或更新;输出数据结构与现有读取方保持兼容;无需调用已注册的运行时脚本。

该技能还列出反合理化条款,提醒不要因为文件存在就认为技能已完成,也不要在命令看似简单时跳过状态文件与安全检查,因为小命令同样会改变状态或影响执行过程。

适用场景主要是旧功能行为的迁移复现、状态文件与输出格式的一致性维护,以及需要确定性、可验证行为的自动化流程。限制方面:具体的状态文件路径、字段定义、校验细则与执行步骤在现有资料中暂未提供。