RCF-048a — 發布文章 SKILL 建立
類型：SKILL
日期：2026-05-20
觸發條件：條件 4 — 新增 SKILL（.claude/skills/發布文章.md，11 步驟整合流程）
相關文件：
.claude/skills/發布文章.md（新建）CLAUDE.md（v2.4→v2.5，SKILL 表 + 情境偵測表新增「發布文章」）knowledge/operations/add-article-guide.md（補入 SKILL 指針段落）
問題背景
每次發布官網文章需執行多個不相連步驟，缺乏整合流程，導致三類反覆出現的缺口：
- 聚落分類缺 HARD STOP：發布前未強制確認 A/B/C/D 分類，曾出現需事後重新分類的情況（IMP-074 根源問題）
- 雙向內鏈缺強制機制：每次收尾時遺漏反向更新，需等 Tim 追問才補做（IMP-076 根源問題）
- Excerpt 策略無規格：鑑論式開頭可 auto-extract，場景鋪陳式開頭需手動
--excerpt，無判斷規格時一律 auto 導致 meta description 不佳（IMP-082 根源問題）
add-article-guide.md 雖記錄了腳本使用方式，但為非整合式 SOP，無強制順序、無 HARD STOP、無 Excerpt 策略節點。
考慮過的方案
| 方案 | 描述 | 優點 | 缺點 | 採用？ |
|---|---|---|---|---|
| 方案 A | 維持 add-article-guide.md，補充 Excerpt 說明 | 零新增檔案 | 無 HARD STOP、無強制執行順序、雙向內鏈仍靠自律 | ❌ 未採用 |
| 方案 B（最終採用） | 建立獨立 SKILL，11 步驟強制順序 + 雙向內鏈 HARD STOP | HARD STOP 保障流程完整性；步驟 0 聚落分類強制在 HTML 建立前確認；Step 10 雙向內鏈列為獨立 HARD STOP 步驟 | 多一個文件需維護；與 add-article-guide.md 有重疊（以 SKILL 為主，guide 降格為備查） | ✅ 採用 |
最終決策
建立 .claude/skills/發布文章.md 11 步驟整合流程：
| 步驟 | 動作 | 關鍵規則 |
|---|---|---|
| Step 0 | 聚落分類 HARD STOP | 確認 A/B/C/D 後才進入 HTML 建立 |
| Step 1 | HTML 準備（Tim 原文 100% 保留） | 禁止改寫正文任何字 |
| Step 2 | slug 命名 | YYYY-MM-DD-[主題]-[關鍵字].html |
| Step 2.5 | Excerpt 判斷 | 鑑論式→auto；場景鋪陳式→手動 --excerpt 60-80 字 |
| Step 3 | python -X utf8 add_article.py 執行 |
即時/排程二選一 |
| Step 4 | 刪除暫存 HTML | 避免 ls blog/ 汙染 |
| Step 5 | batch_update_seo.py SEO 補入 |
Twitter Card + Schema.org |
| Step 6 | SEO 確認（Twitter Card Validator） | HTTP 200 + og:image 有值 |
| Step 7 | git commit + push | 訊息格式：content: 發布[標題前15字] |
| Step 8 | npx vercel --prod --yes |
唯一合法部署路徑 |
| Step 9 | 驗證 HTTP 200 | curl -I https://www.careerssl.com/blog/[slug].html |
| Step 10 | 雙向內鏈 HARD STOP | 更新 2 篇同聚落文章加反向連結 |
| Step 11 | 收尾記錄 | inventory.json + tasks.md + CLAUDE.md |
方案 A 排除原因：IMP-074/076/082 均源於「自律依賴而非結構強制」，補文字說明無法解決根本問題；SKILL 透過步驟順序提供結構性保障。
影響範圍
| 影響類型 | 具體項目 |
|---|---|
| 新增文件 | .claude/skills/發布文章.md（11 步驟，v1.0） |
| 修改文件 | CLAUDE.md v2.4→v2.5（SKILL 表 + 情境偵測表 +1 行） |
| 修改文件 | knowledge/operations/add-article-guide.md（頂部補入 SKILL 指針說明） |
| 影響的 SKILL | 發布文章（新增，觸發詞：「發布時間：」+ 文章內容貼入） |
| 觸發部門同步 | 無（SKILL 表已在主 CLAUDE.md 統一管理） |
驗證方式
3 次連續文章發布均完整執行 11 步驟，雙向內鏈 HARD STOP 全部執行：
| 發布日期 | slug | 聚落 | 雙向內鏈 | 驗證結果 |
|---|---|---|---|---|
| 2026-05-20 | employee-welfare-company-profit | C | resign-toxic-manager-strategy ✅ | HTTP 200 ✅ |
| 2026-05-22（排程） | workplace-oversharing-danger | A | workplace-politics + gaslighting-toxic-boss ✅ | HTTP 200 ✅ |
| 2026-05-23（排程） | strategic-resignation-burnout | C | resign-toxic-manager-strategy + employee-welfare ✅ | HTTP 200 ✅ |
三篇 6 篇反向連結全部更新，Step 0 聚落分類均在 HTML 建立前完成。SKILL 流程有效消除 IMP-074/076/082 三類缺口。