tetriz-harness icon

tetriz-harness

tetriz-harness 是開源開發者工具,可掃描並改善 AI coding 工具使用的規則、技能、hooks、agents 與其他設定,協助團隊審查建議並控管核准變更的分發。

tetriz-harness

AI coding harness 建議與受控分發

tetriz-harness 是開源開發者工具,用於評估與改善引導 AI coding agents 的 harness。其 harness 模型包含規則、技能、agents、命令、hooks,以及 Claude Code、Codex、Cursor 和 Kiro 等工具的 MCP 設定。

此儲存庫結合了可感知儲存庫的掃描器與建議引擎,以及用於分發核准變更的控制平面。團隊可以檢視偵測到的問題,利用程式碼與組織訊號產生其他建議,審查調查結果,然後將選定的成品指定給開發人員或群組。受眾指定也支援手動管理的測試組/控制組 rollout,而結果分析仍在控制平面之外進行。

核心功能

偵測 harness 問題

檢查已提交的 harness 檔案與儲存庫路徑及設定是否相符,找出衝突、遺失檔案的參照、無法符合任何檔案的模式,以及過於寬泛的權限,並提供證據與偵測器涵蓋範圍。

根據程式碼訊號產生建議

使用組織工作階段分析、程式碼審查主題與安全性訊號,提出新的規則、agents 與 hooks;此工作流程取決於已填入資料的訊號資料、隨附的 tetriz-py 服務,以及模型金鑰。

使用清單與使用情況證據

可透過擷取層納入提供的個人 harness 清單與呼叫記錄,以進行依使用情況提供資訊的檢查;僅掃描磁碟上的簽出內容本身無法推斷這些輸入。

審查並核准變更

保存調查結果與建議,讓團隊可以審查,並在發布前明確選擇要採用的變更。

分發核准的成品

提供 Go 伺服器函式庫、附有管理員 UI 的參考主機、harness-agent CLI,以及用於分發核准 harness 成品的 Node 函式庫。

指定並監控 rollout

將規則、技能、hooks 與 agents 指定給特定人員、團隊或整個組織,將其安裝在支援的使用者設定位置或已知的儲存庫簽出目錄,並回報每位人員的安裝狀態。

實際使用情境

  • 稽核現有儲存庫 harness

    針對已提交的 harness 檔案執行 DETECTED 掃描,在變更 harness 前找出過時的參照、無效的檔案模式、衝突,以及比預期更寬泛的權限。

  • 將團隊訊號轉化為建議成品

    結合工作階段分析、程式碼審查主題與安全性訊號,找出可解決重複工程模式的候選規則、agents 或 hooks。

  • 管理受控的團隊 rollout

    僅審查並發布選定的建議,接著將其提供給特定開發人員、團隊或整個組織,同時檢查安裝狀態。

  • 執行手動 harness 實驗

    建立互不重疊的測試組與控制組,僅將 harness 變更指定給測試組,並使用外部工作階段或審查分析系統比較程式碼成果。

  • 以本機 agent 證據豐富分析

    透過介面卡使用獨立的 Agent Desk 探索與工作階段擷取套件,將 harness 清單與觀察到的活動提供給建議工作流程。

Pros and Cons

Pros

  • 結合可感知儲存庫的靜態檢查,以及根據程式碼、審查、安全性、清單與使用情況訊號產生的建議。
  • 將建議審查與發布及分發分開,讓採用流程保持明確。
  • 支援按人員、團隊或組織指定,並回報目標使用者的安裝狀態。
  • 可作為可組合的 Go、Node、CLI、伺服器與管理員 UI 元件使用,而不僅是代管介面。

Cons

  • 以訊號驅動的建議需要額外資料來源、擷取介面卡、隨附的 tetriz-py 服務,以及模型金鑰。
  • 儲存庫記載的是手動管理的 rollout 流程,而非群組隨機分配、內建實驗分析或自動版本還原。
  • Agent Desk 配對不會直接匯入其 JSON 或 SQLite 儲存內容;需要使用介面卡。

FAQ

什麼是 tetriz-harness?

它是開源儲存庫,可掃描 AI coding harness 檔案,根據儲存庫與組織訊號產生建議,並透過控制平面分發核准的成品。

需要哪些輸入與設定?

DETECTED 掃描可在不呼叫模型的情況下,根據儲存庫路徑與設定檢查已提交的 harness 檔案。使用組織訊號的建議工作流程則需要已填入資料的訊號資料表、隨附的 tetriz-py 服務,以及模型金鑰。

如何分發核准的變更?

控制平面可將核准的成品指定給特定人員、團隊或整個組織,將其放入工具的使用者設定位置或已知的儲存庫簽出目錄,並回報安裝狀態。

它是否支援測試組與控制組的 rollout?

可以。受眾指定功能可將選定成品提供給測試群組,同時不指定給獨立的控制組。系統會回報交付狀態,但結果衡量與實驗分析仍由使用者自己的分析系統負責。

文件記載的 rollout 限制有哪些?

儲存庫說明,它不會隨機分配群組、不會計算實驗結果、不會自動還原較早的 harness 版本,也無法保證未被指定的使用者沒有從其他來源取得相同檔案。

Quick Facts

類別
開發者工具
主要用途
AI coding harness 分析與分發
儲存庫
GitHub / tetriz-ai/tetriz-harness
Harness 成品
規則、技能、agents、命令、hooks 與 MCP 設定
部署元件
Go 函式庫與伺服器、harness-agent CLI、Node 函式庫、參考管理員 UI
定價
可用來源未提供產品定價資訊