SuperAPI AI 工具集

harness

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:harness 用于为任意代码库搭建或更新“Agent 优先”的工程脚手架,把智能体推理所需的知识、边界和规则编码为仓库内可版本化的产物。核心理念是“智能体执行、人类掌舵”,工程师负责设计环境、明确意图和构建反馈回路。

主要能力:它采用多轮交互工作流,依次进行评估、规划、知识层、架构层、强制层、质量评分、流程模式与验证八个阶段,每一步展示结果并等待用户确认。工具提出成熟度模型:0 级无脚手架,1 级提供 AGENTS.md、ARCHITECTURE.md 与 docs/ 作为“地图”,2 级通过 .harness/principles.yml、enforcement.yml、domains.yml 定义规则,3 级加入 .harness/quality.yml、文档维护与垃圾回收等反馈机制,4 级实现工作树隔离与升级边界等自主能力,并强调逐级递进、不要跳跃。

使用方式:按阶段推进。评估阶段检查仓库结构、技术栈、Agent 配置、文档、代码组织、测试、可观测性、流程与依赖,输出 Agent Readiness Report;规划阶段按当前成熟度与仓库规模拟定待建产物清单;随后依次生成知识层、领域定义(垂直切片、Types→Config→Repo→Service→Runtime→UI 前向依赖、Providers 处理横切关注点)、机械规则与面向智能体的错误信息、质量评分,以及文档维护、垃圾回收和智能体互审等流程模式,最后交叉验证完整性。

适用场景:适用于希望让编码智能体在仓库中高效工作的团队,包括 agent-first、agent-assisted 和 agent-ready 三类团队配置;含可运行应用的仓库还可评估工作树启动、浏览器自动化与日志/指标/链路可观测性。

限制:不是所有仓库都需要全部组件,需按评估结果合理裁剪;不建议从 0 级直接跳到 4 级;面向智能体的仓库应从一开始就建立架构边界,而非推迟。规范若无检查工具执行会腐化,因此每条规则至少应生成一种具体产物。资料未提供安装命令、收费方式与具体平台支持信息。