SuperAPI AI 工具集

loom-wiring-test

测试与质量

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能用于编写 loom 计划阶段(尤其是集成验证阶段)的 YAML 元数据,帮助智能体证明功能已被正确接入系统,例如命令已注册、端点已挂载、模块已导入、组件已被渲染。它针对的问题是:测试可以通过、代码可以编译,但功能实际上从未被接线,导致“隔离时正常、集成后失效”。

主要能力:通过三类证据证明集成——truths(可观察行为,如 shell 命令返回退出码 0)、artifacts(必须存在且包含真实实现、非空文件的实现文件)、wiring(证明连接点的代码模式,如导入、注册、挂载)。提供按功能类型划分的模板:CLI 命令、API 端点、模块/库、UI 组件,并给出好例与坏例对比及常见陷阱说明。

使用方式:在阶段 YAML 中填写 truths、artifacts、wiring 字段。例如 CLI 命令可写 truths: "loom check --help"、"loom check stage-1 --suggest";artifacts: "src/commands/verify.rs";wiring 条目包含 source、pattern、description,如 source: "src/main.rs"、pattern: "Commands::Verify"。执行 loom check <stage-id> 会运行这些检查,失败时可用 --suggest 获取修复建议。

关键限制:所有路径(artifacts、wiring.source)都相对于阶段的 working_dir 解析,禁止使用 ../ 路径穿越;YAML description 字段中不得使用三个反引号;模式需足够具体以避免匹配到注释或字符串;grep 建议使用 -q;artifacts 应为具体实现文件而非目录或测试文件。已知参考资料仅涵盖上述内容,未提供收费、平台支持范围等其它信息。