跳到內容
Agent Threat Rules (ATR)EN
貢獻

你找到的攻擊,可以變成所有人的規則。

ATR 是公共財,任何人都能提規則。規則通過公開的 PR 審查和安全閘,就會收進這套防守方共用的標準。MIT 授權,不需要專屬工具,也不用簽 CLA。可以先從回報一個繞過手法開始,只要 15 分鐘。

把 ATR 接到你的專案
規劃中 / 實作中

開一個 Integration Request issue

任何引擎都可以實作這個標準,這條路是給正在實作的人。表單是結構化的,5 分鐘填完。需要 spec 導讀、設計審查、你那個語言的範例程式碼,或合規框架對照,就走這條。維護者七天內回覆。

開 issue
已經上線

提 PR 加進 ADOPTERS.md

整合已經公開、可以驗證,就走這條。格式符合 schema、附上證據連結,就會合併。維護者不預先審核採用者,做法跟 Sigma 一樣。

ADOPTERS.md
改進規則本身
  1. 提交新規則(不用 fork)

    發現新的攻擊手法?填一個 issue,bot 會自動把它轉成 draft proposal PR。不用 clone repo,也不用寫 YAML。

    開一個 issue
  2. 提交紅隊 probe

    手上有攻擊 payload,也有長得像但無害的對照樣本?維護者審過、接受之後,會把它轉成提案 PR。之後的量測可能會用到你的 payload,但不保證會進 benchmark 語料。

    送一個 probe
  3. 回報繞過手法

    找到繞過規則的方法?每一個確認過的繞過,都會讓規則被改進。這是影響最大的一種貢獻。

    開一個 issue
  4. 回報誤判

    規則把正常內容當成攻擊?回報誤判,規則才修得準。各車道的誤報率已在 2026-09-19 撤回,正在等重新量測。

    開一個 issue
  5. 自己寫完整規則(進階)

    想直接寫 YAML?fork repo,照著 spec 寫,跑 atr validate 和 atr test,再提 PR。教學會一步一步帶你。

    看教學
  6. 讓 AI 幫你寫

    用 Claude Code 或 Cursor 接上 ATR 的 MCP server。AI 寫 YAML,你來審。

    看 MCP 設定
送出後會發生什麼
  1. 新規則 issue:bot 會把你的 issue 轉成 proposals/ 底下的 YAML 草案,開一個 draft PR,author 欄位寫的是你的名字。上面其他類型的 issue,包括紅隊 probe,會先由維護者審。維護者接受之後,才會有 PR。
  2. 維護者或社群成員把偵測用的 regex 寫完,再跑安全閘:要有真陽性和假陽性樣本、符合 schema、不跟現有規則衝突,而且在良性語料上 0 誤報是硬性條件。這道閘真的會擋。
  3. 規則合併進 main,隨下一個版本發布。CI 先在 npm 上 stage,維護者用 2FA 核准後上線,再建立 GitHub release。從這一刻起,每一個讀 ATR 的引擎都能用它,不分廠商,也不分國家。
  4. 之後的量測可能會用到你的 payload,但不保證會進 benchmark 語料。 data/measurements/<source>/ 底下的歷史檔,記錄每一次量測的 recall、precision、fp-rate。數字綁定版本,不會漂移。
  5. ATR 公開引用 recall 數字時,一定附上量測檔的路徑。你的貢獻,在公開的審計鏈裡查得到。
想改 spec 本身

spec(SPEC.md)是所有相容引擎之間的契約,改它沒有加規則那麼直接。先開一個標題以 [RFC] 開頭的 issue,寫清楚要改什麼、為什麼改。接著公開徵求意見 14 天(複雜提案延長到 30 天),讓所有實作者看到並回應。之後才收 PR。破壞性變更(SemVer 主版號)還要另外提前 30 天公告。

完整流程寫在治理頁的「決策流程」段落。

第一次貢獻

想幫忙,但不知道從哪裡下手?有兩個門檻低的入口:

  • 標了「good first issue」的未關閉 issue:維護者標過、範圍清楚的入門任務。
  • 誤判回報。工作中碰到規則誤判,花 15 分鐘填表,就能直接幫到下游所有採用者。維護者最重視這類回饋。
想成為維護者

ATR 有多位維護者,但合併目前集中在首席維護者手上,所以還在招募更多人。候選條件、決策結構和申請方式,都寫在治理頁。

看治理頁的「想成為維護者」