Playbooks
此處提供依危害類型區分的調查與正式環境 playbook。每個 playbook 是 agent 開始工作前讀取的宣告式操作配方。Playbook 會參照 ../entity_schema/abstract_entity_schema.yaml 的實體與 edge、../entity_schema/signals.yaml 的 Signal slot，以及 ../harm_taxonomy.yaml 的類別預設值。
兩種 persona 具有不同範圍。
| 檔案 | Persona | 權限 |
|---|---|---|
investigation_coordinated_commenting.yaml | 調查 agent | 只提出建議。建立 Case 並路由至人工 Queue。 |
production_spam_autoaction.yaml | 正式環境 agent | 只能在嚴格門檻內採取行動，每項操作都記錄至 Coop。 |
Query catalog 慣例
依 blog 的「預先核准 query catalog」原則，agent 不自行撰寫 SQL。每個 playbook 以名稱宣告允許呼叫的 query，實際 SQL 由 executor 管理。每個 playbook 的 queries: block 包含預留 SQL，整合者必須依 warehouse 的實際 schema 替換。參數形狀與回傳欄位應保持不變，使 playbook 的 walk: 步驟仍可正確綁定。
新增 playbook
- 複製兩個範例之一。
- 將檔案命名為
<persona>_<harm_id>.yaml，其中harm_id是harm_taxonomy.yaml的類別。 - 維持
walk:步驟精簡且有順序。每一步都須標明實體、query 及產出內容。 - 將每個
decide:規則綁定至 taxonomy 的類別預設值。若刻意覆寫政策，須說明原因。
production_spam_autoaction.yaml具有自動處置設計。翻譯與 schema 驗證不代表已核准在正式環境執行，仍須由平台治理、安全、工程及資料負責人共同審查。