tetriz-harness icon

tetriz-harness

tetriz-harness 是一款开源开发者工具,可扫描并改进 AI 编程工具使用的规则、技能、钩子、代理及其他配置,支持团队审核建议,并将获批变更分发给指定开发者或团队,包括手动管理的测试组与对照组发布。

tetriz-harness

AI 编程 harness 建议与受控分发

tetriz-harness 是一款开源开发者工具,用于评估和改进指导 AI 编程代理的 harness。其 harness 模型包括规则、技能、代理、命令、钩子,以及 Claude Code、Codex、Cursor 和 Kiro 等工具的 MCP 配置。

该仓库将支持仓库感知的扫描器和建议引擎,与用于分发获批变更的控制平面结合起来。团队可以检查检测到的问题,利用编程和组织信号生成更多建议,审核发现结果,然后将选定的构件定向分发给开发者或群组。受众定向还支持手动管理的测试组与对照组发布,而结果分析仍由控制平面之外的系统负责。

核心能力

检测 harness 问题

根据仓库路径和配置检查已提交的 harness 文件,识别冲突、缺失的文件引用、匹配不到任何文件的模式,以及权限范围过宽的问题,并提供证据和检测器覆盖信息。

根据编程信号生成建议

利用组织会话分析、代码审查主题和安全信号,提出新的规则、代理和钩子;此工作流依赖已填充的信号数据、随附的 tetriz-py 服务和模型密钥。

使用清单和使用情况证据

可以通过摄取层纳入个人 harness 清单和调用记录,以执行基于使用情况的检查;仅凭磁盘上的检出目录扫描无法自行推断这些输入。

审核并批准变更

持久化保存发现结果和建议,方便团队进行审核,并在发布前明确选择要采用的变更。

分发获批构件

提供 Go 服务器库、带管理界面的参考主机、harness-agent CLI 以及用于分发获批 harness 构件的 Node 库。

定向并监控发布

将规则、技能、钩子和代理定向分发给指定人员、团队或整个组织,将其安装到受支持的用户配置目录或已知的仓库检出目录中,并报告每个人的安装状态。

实际使用场景

  • 审计现有仓库 harness

    对已提交的 harness 文件运行 DETECTED 扫描,在修改 harness 之前查找过时的引用、无效的文件模式、冲突以及超出预期范围的权限。

  • 将团队信号转化为候选构件

    结合会话分析、代码审查主题和安全信号,识别能够应对反复出现的工程模式的候选规则、代理或钩子。

  • 管理受控团队发布

    仅审核并发布选定的建议,然后将其交付给指定开发者、团队或整个组织,同时检查安装状态。

  • 运行手动 harness 实验

    创建互不重叠的测试组和对照组,仅向测试组定向分发 harness 变更,并使用外部会话或审查分析系统比较编程结果。

  • 利用本地代理证据丰富分析

    通过适配器使用独立的 Agent Desk 发现和会话提取包,为建议工作流提供 harness 清单和观测到的活动。

Pros and Cons

Pros

  • 将支持仓库感知的静态检查,与基于编程、审查、安全、清单和使用情况信号的建议结合起来。
  • 通过将建议审核与发布和分发分开,确保采用过程明确可控。
  • 支持按人员、团队或组织进行定向,并报告目标用户的安装状态。
  • 提供可组合的 Go、Node、CLI、服务器和管理界面组件,而不只是托管式界面。

Cons

  • 基于信号的建议需要额外的数据源、摄取适配器、随附的 tetriz-py 服务和模型密钥。
  • 仓库记录的是手动管理的发布流程,而不是群组随机分配、内置实验分析或自动版本恢复。
  • Agent Desk 的配对不会直接导入其 JSON 或 SQLite 存储;需要使用适配器。

FAQ

什么是 tetriz-harness?

它是一个开源仓库,可扫描 AI 编程工具的 harness 文件,根据仓库和组织信号生成建议,并通过控制平面分发获批的构件。

需要哪些输入和设置?

DETECTED 扫描可以根据仓库路径和配置检查已提交的 harness 文件,无需调用模型。使用组织信号的建议工作流需要已填充的信号表、随附的 tetriz-py 服务和模型密钥。

获批的变更如何分发?

控制平面可以将获批的构件定向分发给指定人员、团队或整个组织,将其放置在工具的用户配置目录或已知的仓库检出目录中,并报告安装状态。

它支持测试组与对照组发布吗?

可以。受众定向功能可以将选定构件分发给测试组,同时不向单独的对照组定向分发。系统会报告交付状态,但结果衡量和实验分析仍由用户自己的分析系统负责。

文档记录的发布限制有哪些?

仓库说明,该系统不会随机分配群组、计算实验结果、自动恢复到较早的 harness 版本,也无法保证未被定向分发的用户不会从其他来源获得等效文件。

Quick Facts

类别
开发者工具
主要用途
AI 编程 harness 分析与分发
仓库
GitHub / tetriz-ai/tetriz-harness
Harness 构件
规则、技能、代理、命令、钩子和 MCP 配置
部署组件
Go 库和服务器、harness-agent CLI、Node 库、参考管理界面
定价
现有来源未提供产品定价信息