SuperAPI AI 工具集

harness-engineering

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:为任意代码仓库搭建或更新 agent-first 工程脚手架,把智能体理解业务领域所需的知识、边界与规则编码为仓库内、可版本化的产物,使智能体仅凭仓库本身即可推理完整业务域。核心理念是“智能体执行、人类掌舵”。

主要能力:提供四层成熟度模型(0 未搭架、1 地图、2 规则、3 反馈、4 自主),并按八阶段多轮工作流实施:评估、规划、知识层、架构域、强制规则、质量评分、流程模式、验证。知识层产出 AGENTS.md(约 100 行、作路由表)、docs/ 目录(设计文档、执行计划、生成内容、产品规格、参考、产品感知与领域指南,使用渐进披露结构)与 ARCHITECTURE.md。架构层定义垂直切片领域与 Types→Config→Repo→Service→Runtime→UI 分层,依赖仅向前流动,横切关注点经 Providers 单一接口进入,生成 .harness/domains.yml。强制层用 .harness/principles.yml 记录 5–10 条原则,.harness/enforcement.yml 记录命名、文件大小、结构化日志、导入边界、测试覆盖等机械规则,并要求为每条规则生成 lint 配置、CI 工作流、结构测试或脚本等至少一个可执行产物,且违规提示需包含问题、原因、修复方式与查看位置。质量层对每个领域的代码质量、测试覆盖、文档、可观测性、可靠性、安全按 A–F 评级,生成 .harness/quality.yml。运行应用的仓库还可评估 worktree 启动、浏览器自动化(Chrome DevTools Protocol)、日志/指标/追踪查询与临时状态回收。流程层记录文档养护、垃圾回收、智能体评审等模式。

使用方式:资料未提供具体安装命令或调用命令;所述用法是在仓库中按上述阶段交互式推进,每阶段边界向用户呈现结果并等待确认,逐级向下一成熟度级别构建,而非一次跳级。

适用场景:适用于 agent-first(智能体写 90% 以上代码)、agent-assisted 或 agent-ready 的仓库;小型仓库(<5k LOC)可能仅需 1–2 级,大型仓库(50k+ LOC)可受益于四级全部。库、CLI 工具与基础设施仓库可跳过运行应用相关阶段。

限制:资料未提供收费、价格、平台支持或效果数据;资料未提供具体安装命令与版本要求。各级需按顺序构建,缺少下层时上层规则难以被发现或强制执行。