跳到內容
Agent Threat Rules (ATR)EN
治理

ATR 怎麼治理,都寫在公開紀錄裡。

誰在維護、規則怎麼進來、spec 怎麼改、首席維護者有什麼利益衝突,全部寫在這一頁,也都能在 GitHub 上查。ATR 是 MIT 授權的開放標準,不隸屬任何公司。任何人都能檢查流程,標準才站得住腳,不用靠哪個權威背書。

現任維護者

負責規則品質、PR 審查和發版。

Adam Lin
林冠辛
Lead Maintainer

ATR 的創辦人和主要維護者。負責設計規則品質門檻(RFC-001)、對外聯繫社群,也審查外部整合。GitHub:eeee2345(Adamthereal)。

[email protected]

除了首席維護者,GitHub 上另有兩位維護者有寫入權限,還有一位協作者負責整理 issue。不過到目前為止,PR 的合併仍集中在首席維護者手上,這是接下來要分散的部分。招募更多維護者的條件寫在下面。路線圖上有一項是評估把標準託管給中立基金會,例如 Linux Foundation、OpenSSF 或同等級的組織;最終目標是成立技術指導委員會(TSC)。

合併政策

每條規則要過六道關,才能合併。

第 5 道是人工審查,其餘五道由機器執行,每一道都在公開的 CI log 留下紀錄。一條規則為什麼通過、為什麼被擋,誰都看得到。品質不只靠維護者的眼光,還有任何人都能重跑的測試。

1 · 語法驗證

YAML schema 合法,regex 有效且沒有 ReDoS,至少 1 個 TP 和 1 個 TN。

2 · RFC-001 品質門檻

信心分數決定規則進哪一條偵測車道。分數看的是精確度、野外驗證、覆蓋深度,以及已知的繞過手法有沒有寫下來。分數不夠的規則永遠不會升到 enforce,但仍可以用 advisory 的形式存在。門檻是一條公開的公式,誰都能拿來重算。

3 · 良性語料 0 FP

每個 PR 都會跑良性語料閘,新規則在上面必須是 0 誤報。這是合併時的最低門檻。發布之後,誤報率要在更大的良性語料上逐車道量測,不用單一數字概括。先前公布的各車道誤報率已在 2026-09-19 撤回,正在等重新量測。

4 · 跨規則衝突檢查

同一個輸入,新規則不能跟現有規則給出互相矛盾的結果。

5 · 人工審查

維護者審 regex 的形狀、test case 的覆蓋,還有來源文件。要到 Stable 等級,來源必須經過人工審查。

6 · PR 規範

每個 PR 最多 10 條新規則。test_cases 必須同時有 true_positives 和 true_negatives。

決策流程

改什麼,就過什麼樣的關。

改一條規則跟改 spec 是兩回事。規則錯了,可以撤下,也可以修正。spec 是每一個符規引擎都依賴的契約,要改,就得讓所有實作者都看得到,也來得及反應。門檻多高,看這個改動會牽動多少人。

新增規則
1 位維護者核可,加上自動安全閘通過

規則 PR 先跑六道安全閘(見上面的合併政策)。通過之後,一位維護者人工審過就能合併。不要求兩人核可,因為規則的客觀品質已經由安全閘把關。

修改 spec(SPEC.md)
先開 RFC issue,公開徵求意見 14 天(複雜提案延長到 30 天),再由 2 位維護者核可

spec 是所有相容引擎之間的契約。任何 spec 變動,都要先用 issue 提出 RFC,公開徵求意見 14 天(複雜提案延長到 30 天),讓每個實作者都看到,之後才收 PR。現在是 BDFL 階段,「2 位核可」是首席維護者加上另一位維護者。TSC 成立之後,改成 TSC 過半數核可。

破壞性變更(SemVer 主版號)
走修改 spec 的流程,加上 30 天前公告,以及一筆 CHANGELOG 紀錄

會破壞 rule schema、engine API,或改變既有 rule_id 語意的改動,都算破壞性變更。要提前 30 天在 GOVERNANCE.md 標題、CHANGELOG 公告,並通知 @adopters,讓上游採用者有時間因應。

新增或撤換維護者
所有現任維護者核可,加上受邀者書面同意

新增要所有現任維護者核可。撤換要 2/3 多數,BDFL 階段不適用。

把規則標為 deprecated
1 位維護者核可,另有 30 天緩衝期

deprecated 的規則仍留在規則庫裡,但引擎 MUST NOT 預設啟用。30 天後可以從規則庫移除。已經在用的下游,可以釘在 deprecated 的版本。

工作小組

目前還沒有。成立的條件寫在下面。

OASIS CTI、OpenTelemetry SIG、OWASP 工作小組都有固定會議。ATR 還沒到需要固定開會的規模。現在所有討論都在 GitHub Issues 和 PR 上非同步進行,公開,也都留下紀錄。實作者才幾個,沒人提出需求就先設委員會,沒有必要。

要不要成立,看需求。你如果手上有實際在做的整合、想把 spec 往某個方向推,或代表一個實作者,想在標準化過程裡有固定的發言管道,就開一個標題以 [WG-proposal] 開頭的 issue。只要有 3 個以上彼此獨立的實作者提出同樣的需求,維護者就會開始每兩週一次的工作小組會議。條件就寫在這裡,誰都可以拿來用。

想成為維護者

正在積極招募。

合併權集中在一個人手上,是 ATR 目前已知最大的結構風險。要分散出去,得等貢獻者合併過足夠多的 PR,夠資格拿到 commit 權限。更多維護者正在招募。

候選條件:

  • 過去六個月內,在 ATR repo 合併過至少三個有實質內容的 PR(新規則、schema 修正、引擎改進,或文件的實質改寫)
  • 熟悉 SPEC.md,能解釋其中的符規條款
  • 能配合非同步審查。不需要即時回應,但 PR 平均應在 7 天內收到第一次審查回覆
  • 在公開場合(GitHub、issue 留言、研討會)代表 ATR 時,語氣保持中立,不暗示任何商業利益

申請方式:寄信到 [email protected],主旨寫「ATR maintainer application」。信裡附上你最近的 PR 連結,以及你想負責哪一塊(rules / spec / engine / documentation)。

繼承計畫

如果首席維護者沒辦法繼續。

短期(30 天內):GitHub 上的 CODEOWNERS 檔和 CI 照常運作,PR 照樣能審查、合併。但發新的 npm 版本,要有發布權限的維護者用 2FA 核准,CI 只能先 stage。ATR 不依賴任何單一伺服器或封閉系統。規則是純文字 YAML,誰都可以 fork。

中期:由其他現任維護者接手 PR 審查和合併。人手不夠時,會從外部貢獻者裡找臨時維護者,條件是:過去六個月內合併過至少三個有實質內容的 PR、實際熟悉 schema 的實作,而且能配合非同步審查。邀請發出、對方也同意之前,不會公布人選。

長期:ATR 的路線圖包括評估把標準移交給中立基金會(Linux Foundation 或 OpenSSF)。移交的條件是:有兩位以上的外部維護者,以及至少一個組織願意提供資源支持治理。

利益衝突揭露

為什麼要揭露。

利益揭露:維護者創辦並控制 PANGUARD AI, INC.,這家公司販售以 ATR 為基礎的 agent 資安產品。

ATR(Agent Threat Rules)是 MIT 授權的開放標準,在 Agent-Threat-Rule 這個 GitHub 組織底下維護。上面這件事不藏,直接寫下來,揭露本身就是治理的一部分。維護者確實有利益,所以 ATR 把決策過程公開,讓任何人都能檢查這些利益有沒有影響決定。

界線是:ATR 的規則、CHANGELOG、benchmark 資料和文件,都不得被任何商業利益左右。ATR 的 issue tracker 和 PR 審查對所有人開放,包括這個商業利益的競爭對手。他們可以提規則、審 PR,也可以把整套標準 fork 走。GOVERNANCE.md 在 GitHub 上公開,誰都能查。

如果你看到有人越過這條界線,請在 GitHub 開 issue,或寫信到 [email protected]。

貢獻者權利

所有貢獻都以 MIT 授權發布。你的攻擊研究,你保留以任何形式使用的全部權利。ATR 只取用其中的偵測規則,研究本身仍歸你。

貢獻者的名字寫在規則的 author 欄位。