用途
contract-hash 是 snowflake-labs/cocoplus 中的一个 V2 原生确定性契约技能,用于承载某个 CocoPlus 功能的行为。根据资料描述,它执行的是原先委托给 _contract-hash 技能的行为,但不再依赖已注册的运行时脚本。
主要能力与要求
该技能要求使用 Coco 原生能力来完成任务,具体包括:
- Read、Write、Edit:用于读写和编辑文件。
- Bash:仅在宿主显式需要时使用。
- Snowflake 工具:当功能需要数据访问时使用。
- 子代理:当功能需要独立审查时使用。
技能规定了几项必须遵守的契约:
- 保留所属功能技能所记录的产物路径、数据结构和用户可见输出。
- 不得将旧脚本作为实现路径来调用。
- 在生成机器可读状态时,优先采用确定性的文件解析和结构化产物,而非自由形式的文本。
- 如果会产生外部副作用,应沿用所属功能相同的门控与确认语义。
使用方式
资料未提供具体的安装命令、调用示例或配置步骤。技能本身以契约形式描述行为要求,而非提供可直接执行的命令。
退出标准
技能完成需满足以下条件:
- 所属功能记录的产物已生成或更新。
- 输出结构保持与现有读取方兼容。
- 无需调用已注册的运行时脚本。
反合理化说明
资料中列出了两种需要避免的捷径及其失败原因:
- 仅因文件存在就认为技能已完成:技能契约必须描述可观察的行为和验证方式,而不仅仅是命令名称。
- 因命令较小而跳过产物和安全检查:小命令同样会改变状态或引导执行,应保留相同的门控。
适用场景与限制
该技能适用于需要以 V2 原生方式执行 CocoPlus 功能行为、并保持产物路径与输出结构兼容的场景。资料未说明其具体支持的平台、收费方式或价格信息。