JDArmy/BREAK

BREAK 知識庫 Skill

BREAK (Business Risk Enumeration & Avoidance Knowledge) 是一個開放的業務風險枚舉與規避知識框架，包含 3416 條業務安全風險知識條目，涵蓋以下實體類型：

類型	數量	ID 格式	說明
Risk（風險）	400	R0001, R0001-001	業務安全風險定義和影響
Avoidance（規避手段）	350	A0001, A0001-001	應對風險的防禦措施
AttackTool（攻擊工具）	125	AT0001, AT0001-001	黑灰產使用的工具
ThreatActor（威脅行為者）	83	TA0001, TA0001-001	實施攻擊的人群
Term（術語）	657	T0001	業務安全領域術語
Case（案例）	1781	C0001	真實的安全事件案例
BusinessDomain（業務域）	20	BD00	行業/業務域分類

維護說明：本 Skill 的調用方式保持不變，實體統計與知識庫案例事實、來源質量及數據關係補強同步更新。

調用方式

使用 Bash 執行搜索腳本。腳本路徑位於 skill 目錄下的 break_search.mjs。

基本命令格式

node <skill_dir>/break_search.mjs "<query>" [options]

其中 <skill_dir> 為本 SKILL.md 所在的目錄路徑。

參數說明

參數	說明
<query>	必填。搜索關鍵詞、實體 ID 或安全問題描述
`--lang zh	en`
--type <types>	逗號分隔的實體類型過濾（risks, avoidances, attackTools, threatActors, terms, cases）
--limit N	每類型最大返回數，默認 5
--detail	詳細模式，顯示完整欄位和關聯關係

工作流程

收到 $query 後，按以下流程處理：

第一步：判斷用戶意圖

1. ID 查詢：$query 匹配實體 ID 格式（如 R0001、AT0034-001 等）→ 直接精確查詢
2. 關鍵詞查詢：$query 是簡短的關鍵詞或術語（如"驗證碼"、"DDoS"）→ 搜索模式
3. 問題諮詢：$query 是一段描述性問題（如"我們網站被爬蟲爬了怎麼辦"）→ 問答模式

第二步：執行搜索

ID 查詢

直接執行：

node <skill_dir>/break_search.mjs "<ID>" --lang zh

返回該條目的完整詳情，包括關聯關係展開。直接呈現給用戶。

關鍵詞搜索

node <skill_dir>/break_search.mjs "<關鍵詞>" --lang zh

如需限定範圍：

node <skill_dir>/break_search.mjs "<關鍵詞>" --type risks,avoidances --lang zh

將搜索結果整理後呈現給用戶。

問題諮詢（核心場景）

這是最重要的使用模式。用戶描述業務安全問題時：

步驟 1：提取關鍵詞

從用戶問題中提取 1~3 組搜索關鍵詞。例如：

• "我們公司網站被爬蟲爬了" → 關鍵詞："爬蟲"、"數據爬取"、"反爬"
• "用戶帳號總是被盜" → 關鍵詞："帳號盜用"、"撞庫"、"憑證填充"
• "有人在我們平台薅羊毛" → 關鍵詞："薅羊毛"、"行銷欺詐"、"黑產"

步驟 2：多輪搜索

對每組關鍵詞分別調用搜索腳本。可以多次調用：

# 第一輪：直接搜索問題關鍵詞
node <skill_dir>/break_search.mjs "爬蟲" --lang zh

# 第二輪：搜索相關風險和防禦手段
node <skill_dir>/break_search.mjs "反爬" --type avoidances --lang zh

# 第三輪：如有需要，搜索其他相關領域
node <skill_dir>/break_search.mjs "數據泄露" --type risks,cases --lang zh

步驟 3：深入查詢

從搜索結果中找到最相關的條目 ID，進行精確查詢以獲取詳細信息：

# 查看爬蟲風險的詳情和關聯規避手段
node <skill_dir>/break_search.mjs R0027 --lang zh

# 查看具體規避手段的詳情
node <skill_dir>/break_search.mjs A0003 --lang zh

步驟 4：綜合回答

基於所有檢索到的知識，給出結構化回答：

## 問題分析

根據 BREAK 知識庫，你描述的問題涉及以下風險：
- **[R0027] 爬蟲風險**：...（引用定義和描述）
- **[R0027-001] xxx**：...

## 防禦建議

針對上述風險，BREAK 推薦以下規避手段：
1. **[A0003] 雲端反爬**：...（引用定義）
2. **[A0004] 頻率限制**：...
3. ...

## 可能涉及的攻擊工具

- **[AT0005] 爬蟲工具**：...

## 相關案例

- **[C0xxx] xxx案例**：...

> 以上信息來源於 BREAK 知識庫 (https://break.jd.army/)

重要原則

1. 永遠先檢索再回答：不要憑記憶回答業務安全問題，必須通過搜索腳本查詢 BREAK 知識庫
2. 引用來源：回答中必須標注具體的 BREAK 條目 ID（如 R0027、A0003）
3. 多次檢索：如果第一輪搜索結果不足或不夠精確，換關鍵詞再搜
4. 關係展開：找到相關風險後，查看其 avoidances 字段獲取防禦手段；找到攻擊工具後，查看其 directCauseRisks 字段了解關聯風險
5. 中英文適配：如果用戶使用中文提問，用 --lang zh 檢索並用中文回答；反之亦然

文檔新鮮度門禁

當 scripts/skill/ 搜索 / 打包腳本、導出的中英文數據包、實體字段 / 關係結構、Skill 調用參數或搜索結果格式發生變化時，必須同步更新 SKILL.md 與 SKILL_en.md。npm run validate:docs-freshness 已接入 npm run validate:data，會在相關變更缺少 Skill 文檔更新時阻斷。

數據治理改動也會影響 Skill 檢索結果。修復 Case 的 references / summary 事實核驗問題或調整 Risk 的 avoidances 關係時，應同步維護英文翻譯文件，並確保前兩條 Case references 盡量指向可抓取正文的穩定頁面，避免 Skill 返回的案例事實無法被複核。

Term 分類使用集中註冊表 key；分類修正只改中文結構源並同步實體版本，Skill 的搜索與展示會在運行時合併英文文本，無需在英文實體文件重複寫入 category。

2026-07-10 的 ThreatActor 覆蓋治理新增物流套利、惡意物流從業者、市場操縱、惡意量化交易、AI 智能體攻擊、平台規則濫用經營和通信資源濫用服務角色，並用 audit:risk-threat-actor-coverage 區分待補關係與明確豁免風險；不改變 Skill 調用參數、搜索字段或返回格式。

2026-07-10 的 ThreatActor 引用審計將 Wikipedia 降為二手背景來源，標記機構首頁、新聞索引和研究欄目等通用佔位鏈接，並補強威脅行為者的政府、司法、學術及原始安全研究證據；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的實體粒度複核清理了 R0285 的無關 Term 關係及 R0159 的重複 Avoidance 引用；該維護不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的原子化治理將 A0124 拆分為 Rug Pull 鏈上實時檢測與損失賠付/資金恢復，合併刪除重複的 A0142/A0160，並刪除不滿足具體工具准入邊界的 AT0093；關係已遷移到現有原子實體，不改變 Skill 調用參數和返回格式。

清理 Case 事實待辦時，summary 只保留來源正文直接支撐的主體、時間、行為、處置和影響信息；抓取失敗、僅有標題支撐或來源未覆蓋的金額、數量、判決結果、監管措施等細節，應補充穩定來源後再保留，或收斂為更保守的事實表述。

補強高價值 Case references 時，優先查找執法機關、法院、檢察院、監管機構、廠商公告等一手來源；若公開原始頁面不可得，應使用可抓取的權威媒體、地方政法/公安頻道或穩定轉載交叉驗證，並在 summary 中避免寫入只有失效原文才支撐的細節。經檢索確認原始來源不可得且已有多源支撐的項，可在待辦吸納清單中記錄，不為滿足門禁編造來源。

2026-07-09 的 Case P1 引用質量維護僅補強 C0066、C0130、C0248 的 references / summary 與英文翻譯；未改變 Skill 調用參數、搜索字段、返回格式或實體結構。

Case 事實核驗使用抓取正文送入 LLM。review-case-fact.mjs 優先使用 Scrapingdog 抓取，失敗或正文為空時回退本地直連抓取，並按頁面聲明處理 UTF-8 / GBK / GB18030；維護該腳本時需保證送審片段足夠覆蓋正文關鍵段落。大批量清理 P2 待辦時按約 100 個改動設置 checkpoint，先跑 validate:data / review:changed 再提交，避免長時間積累未驗證變更。

2026-07-09 的 Case P2 事實核驗維護僅補強或收斂案例 summary / references / 英文翻譯，不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-09 的第二批 Case P2 事實核驗 checkpoint 繼續收斂 C0249、C0310、C0401、C0588、C0595、C0635、C0687、C0697、C0705、C0715、C0753、C0755、C0766、C0796、C0797、C0803、C0805、C0819、C0821、C0833、C0948 的 summary、incidentTime、references 與英文翻譯；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 C0354 案例維護補充法院系統來源，並將案例分類調整為更貼近事實屬性的安全事件；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 C0446 案例維護補充石門縣人民法院官方微信原文，並同步英文翻譯；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的第三批 Case P2 事實核驗 checkpoint 繼續補強或收斂 C0463、C0521、C0522、C0558、C0565、C0571、C0577、C0579、C0593、C0630、C0642-C0720、C0728、C0735、C0744、C0749、C0772、C0781、C0785、C0791 等案例的 summary、references、incidentTime 與英文翻譯，並補充 R0290 的規避手段覆蓋；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的第四批 Case P2 事實核驗維護繼續收斂 C0654、C0657、C0684、C1160、C1198、C1235 等案例的 summary、incidentTime 與英文翻譯，並將已由現有穩定來源支撐的 C0226、C0410、C0792、C0798 等項納入待辦吸納清單；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 P1 引用質量與後續 P2 事實核驗維護補強 R0081、R0196、TA0030 及 C0484、C0493、C0502、C0508、C0518、C0538、C0802、C0810、C0812、C0813、C0816、C0851、C0878、C0938、C0996、C1050、C1061、C1062、C1075、C1079、C1084、C1090、C1160、C1198 等條目的 references、summary、incidentTime 與英文翻譯，並同步修正 A0225、R0267 的來源與規避關係；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 P1 引用質量補強繼續替換或補充 AT0076、A0124、A0270、R0168、R0177、TA0058 的權威來源，移除 R0168 的論壇弱來源，並同步英文翻譯；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 AI 數據投毒關係複核校正了 AT0108 對 R0273 的直接因果關係，移除與數據投毒無關的規避手段和 TA0058 案例/風險歸因，並統一 TA0058 的訓練、反饋與檢索知識鏈路描述；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的後續 Case P2 事實核驗維護繼續補強 C1056、C1060、C1064、C1067、C1069、C1077、C1100、C1102 等案例的可抓取來源、summary、incidentTime 與英文翻譯；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-10 的 Case P2 事實核驗 checkpoint 繼續修訂 C1482、C1484、C1485、C1488、C1490、C1493、C1495、C1498、C1500、C1501、C1504、C1505、C1511、C1512、C1518、C1519、C1521、C1523、C1528、C1531 的 summary、references、incidentTime、關係與英文翻譯，並為 A0222-001 補充電商平台商品抽檢專項來源；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-11 的 P2 清理批次修訂 C1190、C1251、C1287、C1366、C1377、C1380、C1384、C1386、C1391、C1392、C1393、C1396、C1400、C1401、C1404、C1406、C1407、C1412、C1414、C1416 的事實摘要與來源，修復 5 個行為者一致性和 5 個風險-規避關係待辦，並新增人肉刷、呼死你、溯源、DEX、隱私幣、零樣本語音克隆、PII、社交工程、洗號、Tor 等術語；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-07-11 的後續 P1 引用質量維護補強 C1377、C1384、C1401、C1406、C1414、C1416 的官方或事件專項來源，並將 C1384 收斂為可由來源支持的供應鏈篡改風險表述；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

2026-09-02 的術語 T0621（清結算）引用維護將 references 從中國人民銀行清算總中心（cncc.cn）替換為中國人民銀行條法司發布的《支付結算辦法》（銀發〔1997〕393號）官方頁面，並同步英文翻譯；不改變 Skill 調用參數、搜索字段、返回格式或實體結構。

review:should-extract 會用全庫實體 title、keywords、aliases 以及當前實體已引用關係識別已覆蓋的候選實體；維護該腳本時，應保持重複抽取建議被降噪，避免 Skill 檢索結果中出現語義重複的新增實體。

實體關係圖譜

理解實體間的關聯關係有助於給出更完整的回答：

ThreatActor（誰）
    ├── buildAttackTools → AttackTool（自建工具）
    ├── useAttackTools → AttackTool（使用工具）
    ├── directCauseRisks → Risk（直接造成的風險）
    └── indirectSupportRisks → Risk（間接支持的風險）

AttackTool（用什麼工具）
    ├── directCauseRisks → Risk（直接造成的風險）
    ├── indirectSupportRisks → Risk（間接支持的風險）
    └── avoidances → Avoidance（可被什麼手段規避）

Risk（什麼風險）
    └── avoidances → Avoidance（如何規避）

Case（案例）
    ├── relatedRisks → Risk
    ├── relatedAttackTools → AttackTool
    └── relatedThreatActors → ThreatActor

Term（術語）
    └── related* → 所有其他實體類型

BusinessDomain（業務域）
    ├── riskDimensions → RiskScene（按業務風險域組織風險場景）
    └── riskScenes → Risk（場景下的風險列表；父風險可代表其子風險）