blog-scout

<!-- 🔒 LOCKED — managed by clade · auto-generated by sync-to-cursor; edit source in .claude/ then re-run sync --> # blog-scout — 內部知識資產 → 部落格選題建議 把「哪些坑夠通用、哪些已寫過、哪些湊在一起才成一篇、哪些敏感度太高不能寫」這四個人腦判斷標準化成可重跑的掃描流程。輸入是 clade 的知識資產現況，輸出是**一份排序過的選題建議報告**——到此為止。 ## 兩條硬邊界（先讀） 1. **只選題，NEVER 寫成稿**。文章成稿一律主線 Opus 自己寫（`rules/core/agent-routing.md` § 派不派：對外文件的定稿措辭外包不了）。本 skill 的輸出止於「建議題目 + 素材清單 + 敏感度標記」。 2. **NEVER 寫入 yudefine-blog**。本 skill 對 `~/offline/yudefine-blog/` 只讀不寫；建議被採納後的落地（開稿、frontmatter、category）由使用者與主線另行處理。 ## 判準來源（Step 1 必讀，NEVER 信本檔的轉述） | 判準 | SoT | 用在哪 | | --- | --- | --- | | 寫什麼 / 不寫什麼、藏招準則、禁詞清單 | `~/offline/yudefine-blog/AGENTS.md` § 部落格內容主軸 | 敏感度分級、候選准入 | | 讀者輪廓與品牌定位 | `~/offline/yudefine-blog/PRODUCT.md` | 每題「讀者是誰 / 為什麼值得讀」 | | pitfall frontmatter 契約與合格標準 | `~/offline/clade/docs/pitfalls/README.md` | 素材解析 | | tag controlled vocabulary | `~/offline/clade/docs/pitfalls/tags.yml` | 聚類與內部 tag 判定 | 禁詞清單與內部 tag 清單在 `scripts/scan-pitfalls.py` 有內建副本，**會漂移**：Step 1 讀完 SoT 後發現新禁詞，用 `--banned-extra` 補進掃描，NEVER 直接信 script 內建清單。 ## Workflow ### Step 1 — 載入判準 讀上表四個 SoT（各只讀相關節）。輸出：本輪生效的禁詞清單、藏招準則三欄表、現行 category 清單。 ### Step 2 — 素材盤點與聚類（維度 1） ```bash python3 "$SKILL_DIR/scripts/scan-pitfalls.py" --min-cluster 5 ``` （`$SKILL_DIR` = 本 skill 的 base directory，skill 載入時 harness 會告知；archive 也要納入時加 `--include-archive`。） 輸出三段：inventory（條目數 / severity / status / 年月分佈）、clusters（public-tag pair 聚類，每群列成員 + severity + 敏感度初判）、sensitivity 統計。實跑形狀（2026-08-25，236 條）： ``` severity: critical=8 ...