mini-taiwan-pulse: Skill for Claude Code

Pulse 筆記寫作流程

正本文件：

• 架構、front matter、語法、嵌入地圖限制 → docs/features/blog/README.md
• 要寫哪些、進度 → docs/features/blog/article-plan.md

本檔只寫流程與踩過的坑，不重抄上面兩份。

1. 選題

1. 讀 article-plan.md，依「建議順序」挑一篇（使用者有指定就照指定）。
2. 主題只有三類，依「文章在做什麼」分（src/blog/topics.ts）：layers 圖層（把資料畫成地圖）、analysis 分析與模擬（用資料問問題）、making 製作筆記（怎麼做出來的）。不要為單一資料種類新增主題；真的三類都放不下，先問使用者。
3. 用一則訊息跟使用者確認：標題方向、主題、要不要嵌入地圖。附上建議值，讓使用者一句「照建議」就能帶過。

2. 開分支

從最新 origin/develop 開 worktree，不要在別人的分支上做：

git fetch origin
git worktree add -b docs/blog-<slug> .worktrees/blog-<slug> origin/develop
ln -s ../../node_modules .worktrees/blog-<slug>/node_modules

之後的指令一律用絕對路徑或 git -C，不要 cd 進 worktree。

3. 抽素材

• Threads 貼文：../knowledge-radar/threads/data/posts/*.jsonl（以 id 去重；只有部分貼文有 text）。依計劃表的日期範圍抽出原文，存到 scratchpad，不要整包貼進對話：

  python3 - <<'PY'
  import json, glob
  seen, rows = set(), []
  for f in glob.glob("../knowledge-radar/threads/data/posts/*.jsonl"):
      for line in open(f):
          p = json.loads(line)
          if p["id"] in seen or not p.get("text"):
              continue
          seen.add(p["id"]); rows.append(p)
  rows.sort(key=lambda p: p["timestamp"])
  for p in rows:
      if "2026-02-13" <= p["timestamp"][:10] <= "2026-02-14":   # ← 改成計劃表的日期
          print(f'## {p["timestamp"][:10]} · {p["permalink"]}\n{p["text"]}\n')
  PY
  

• 計劃表的素材範圍晚於最後同步日（2026-08-28）時，先用 threads-api skill 增量同步。

• 作者口吻：../knowledge-radar/threads/STYLE.md（第一人稱、轉折用「但」、技術細節具體到名詞和數字、不用 emoji）。長文可以有正常的句號與段落。

4. 查證數字（不可省）

• 文章裡每個數字、日期、名稱都要有出處：repo 文件、git log、資料檔筆數、程式常數。貼文說的數字也要回頭對一次。
• 查不到的不要編，也不要「合理推估」。草稿裡寫 〔待確認：…〕，交給使用者確認後才能發布。
• 同一件事出現不同數字時（例：台鐵 907／928／992 班），寫明口徑與時間點，或乾脆不用。
• 查證量大時派 subagent，要求回報「數字 → 出處檔案:行號／commit」對照表。

5. 寫 Markdown

檔案：content/blog/<slug>.md，front matter 欄位見 README。

• 開頭兩三句就回答「這是什麼、在哪裡看」，AI 摘要最常引用開頭。
• 內文 1,800–3,000 個中文字，分 4–6 個 ## 小節（自動進左側目錄）。
• 最後一節前放 ## 常見問題，3 題，每題用 ### 問題 加一段答案（自動產生 FAQ 結構化資料）。
• 標題含搜尋關鍵字（計劃表有列），32 字內；description 120 字內。
• 不出現內部名稱：程式識別字、資料表名、檔名、圖層 key。
• 文末不要自己放 Threads 連結，版型會依 threads: 自動列出。
• tags 不要重複主題名。