用途:围绕模型设计、构建、诊断与演进智能体运行框架(harness),让智能体能够启动、在授权范围内行动、观察结果、恢复并带着证据完成工作。默认采用能解决已观测故障的最小改动。
主要能力:把 harness 拆为五个子系统——指令(意图与约束的路由、优先级、来源归属)、工具(模式、错误、权限执行、并发)、环境(运行时版本、依赖、服务、隔离)、状态(目标、版本、检查点、归属、证据)、反馈(真实检查、用户旅程、追踪、终止门);并覆盖范围、初始化、交接与恢复。工作流为:框定结果、建立基线、归因失败、设计最小干预、实现并挑战、比较与维护、留下可重启的交接。
必要用法:仓库 harness 用 scripts/harness.py audit 做只读审计,scaffold 预览与 --apply 应用,verify 配合 --commands 检查;契约校验用 scripts/contracts.py validate(kind 为 state/graph/run)与 compare。脚本为 Python 3.10+ 标准库,路径相对技能安装根目录,非目标仓库。先审查 JSON argv,仅执行授权命令。
适用场景:创建仓库 harness、诊断不可靠智能体、设计自定义运行时、降低上下文/成本、自动化重复工作、协调多 worker、维护或退役 harness 规则。
限制:scaffold 不覆盖已有路径、不装依赖、不运行项目;verify 只记录命令结果,不代表功能完成或批准发布;compare 拒绝指纹或输入变化的比较,不证明因果改进;无同类真实智能体运行证据时不得声称行为改善。SDK 实现、评估数据集、生产运营、技能格式、安全设计与业务授权应使用对应专门技能。其他细节暂未提供。