SuperAPI AI 工具集

contract-prove

智能体与模型

查看项目

更新于 10-23 23:07

技能介绍

用途

contract-prove 是 snowflake-labs/cocoplus 仓库中的一个 V2 原生确定性契约技能,用于执行原本由 contract-prove 技能委托的 CocoPlus 功能行为。其目标是以 Coco 原生能力替代旧版脚本实现路径,使该功能行为具备确定性、可验证性,并与所属功能的产物约定保持一致。

主要能力

  • 使用 Coco 原生能力执行功能行为:Read、Write、Edit,以及在宿主明确需要时使用 Bash。
  • 在功能需要数据访问时使用 Snowflake 工具。
  • 在功能需要独立审查时使用子代理。
  • 保留所属功能技能所记录的产物路径、schema 和用户可见输出。
  • 优先采用确定性文件解析与结构化产物,而非自由形式的散文,以生成机器可读状态。
  • 在会产生外部副作用时,沿用所属功能相同的门控与确认语义。

使用方式

该技能以契约形式规定行为要求,而非提供具体命令。执行时应遵循以下要求:

  1. 不将旧版脚本作为实现路径调用。
  2. 保持产物路径、schema 与用户可见输出与所属功能技能文档一致。
  3. 生成机器可读状态时,优先使用确定性文件解析和结构化产物。
  4. 若操作会产生外部副作用,应用与所属功能相同的门控和确认语义。

退出标准(Exit Criteria):

  • 所属功能的文档化产物被生成或更新。
  • 输出 schema 与现有读取方保持兼容。
  • 无需调用任何已注册的运行时脚本。

适用场景

适用于需要以 V2 原生方式执行 CocoPlus 所属功能行为的场景,尤其是要求确定性产物、schema 兼容性以及避免调用旧版运行时脚本的场合。也适用于需要保留原有产物路径与用户可见输出、同时以结构化方式生成机器可读状态的流程。

限制

  • 资料未提供具体的安装命令、依赖项或运行环境要求。
  • 资料未提供价格、收费模式或平台支持信息。
  • 资料未提供具体的使用示例或调用参数。
  • 该技能强调不得将旧版脚本作为实现路径,且不得要求调用已注册的运行时脚本。
  • 反合理化(Anti-Rationalization)部分指出:不应仅因文件存在就认为技能完成,技能契约必须描述可观察行为与验证方式,而不仅是命令名称;也不应因命令较小而跳过产物与安全检查,小命令同样会改变状态或引导执行,需保留相同的门控。