網頁內容學習分析 SOP

最後更新：2026-04-18 | 狀態：有效

---

一、觸發條件

應觸發（Tim 在對話中貼入以下類型 URL）

• Threads 貼文（非 YouTube）
• 部落格文章 / 長文
• LinkedIn 文章
• 電子報 / Newsletter
• 研究報告 / 學術文章

不應觸發（明確排除）

• YouTube 連結 → 改用 yt-learning-sop.md
• 操作型 URL（Vercel 後台、GitHub repo、Google Docs 等）
• 非內容頁面（首頁、登入頁、電商頁）
• Tim 只是轉貼連結但明確說「不需要分析」

---

二、內容類型判斷

收到 URL 後，先快速判斷內容類型，再選擇對應的讀取策略與分析重點：

判斷後在維度1輸出，不允許跳過類型判斷直接進入分析。

---

三、內容讀取策略

依內容類型選擇讀取方式：

讀取完整性檢查（讀取後必須確認）：

• 社群貼文型：是否讀到完整貼文正文 + 主要回應？
• 長文章型：是否包含所有章節標題與內文？（非截斷版）
• 技術文件型：是否包含所有步驟說明？
• 研究/報告型：是否包含數據表格與結論段落？

若讀取不完整，必須在維度2說明限制，並在分析中標注哪些部分係推斷而非直接讀取。

---

⛔ 多檔來源完整讀取規則（HARD STOP，RCF-090，2026-06-17 Tim 親自指出直接升規）

只讀 README/部分檔就輸出分析 = 知識庫條目不完整。多檔來源第一輪即須讀完所有核心內容檔。

觸發條件：來源為「多檔集合」——GitHub repo、含子目錄的文件集、多頁技術文件、任何「主檔 + references/docs 子檔」結構。

強制執行：

1. 第一輪即列出來源完整檔案清單（repo → 列出所有目錄與 .md；用 WebFetch 抓 tree 視圖或 raw 檔逐一讀）。
2. 所有「核心內容檔」必須在輸出八維分析前讀完。核心內容檔定義：README + 主規格檔（SKILL/spec）+ references/docs 子目錄全部 .md + 範例檔（*.example.md）。
3. 維度 2「讀取記錄」必須逐檔標「✅ 已讀 / ⚠️ 未讀」，且內容完整性需明確宣告「✅ 完整 / ⚠️ 部分」。
4. 任何未讀核心檔必須附排除理由（如「重複於 X 檔」「明確不相關」），禁止靜默跳過。
5. 排除項：LICENSE / .gitignore / CHANGELOG（除非分析版本演進）/ 二進位檔 = 非內容檔，不列入核心，但維度 2 須說明已排除。

禁止：只讀 README 推斷後輸出帶結論的五欄比較；以「次要檔未讀」標註當免責卻仍下結論（「已標記未讀 ≠ 免責」，IMP-111 利刃）；分多輪靠 Tim 追問才補讀（第一輪即窮舉，IMP-177 家族）。

WHY：2026-06-17 claude-skill-social-post 分析，第一輪只讀 README 推斷 F1-F7/R1-R35/語感機制即輸出，Tim 3 次追問才補讀全 13 檔，結論大幅修正（多平台發文判斷翻轉）。Tim 指示「以後學習分析都要全部讀完再分析，知識庫內容才完整」。同 IMP-177 家族（第一輪查照非一次窮舉）。

---

圖片內容讀取（社群貼文型補充步驟）（IMP-058，2026-04-27）：

• accessibility tree 出現有意義的 image 節點（非頭貼/icon，如架構圖、流程圖、卡片截圖）→ 執行 Chrome MCP computer 截圖 → Claude 直接讀取截圖中的文字與圖解
• 截圖讀取結果補充至維度 3「D 來源做法」欄，並在維度 2 標注「已截圖讀取圖片」
• 若截圖無法正確呈現圖片文字，在維度 2 說明限制並標注推斷部分

說明：Threads/IG 貼文的圖解（架構圖、步驟圖）往往是資訊密度最高的部分；純文字讀取只能取得描述，截圖讀取才能完整分析圖片內容（@inspiri.flow Agent架構圖為典型案例）。

---

四、八維分析輸出格式

完整分析必須依序輸出以下八個維度，不得省略：

---

維度 1：定性（基本資料）

- **平台**：[Threads / Medium / LinkedIn / 官方部落格 / 其他]
- **URL**：[完整連結]
- **作者**：[帳號名稱 + 一行背景描述]
- **發布日期**：[YYYY-MM-DD 或估算]
- **互動數據**：[按讚 X / 回覆 X / 轉發 X（如有）]
- **內容類型**：[社群貼文型 / 長文章型 / 技術文件型 / 研究報告型]
- **可信度評估**：[高 / 中 / 低，說明理由]

---

維度 2：讀取記錄

- **讀取方式**：[WebFetch / Chrome MCP navigate + read_page / get_page_text / PDF]
- **內容完整性**：[完整 / 部分（說明截斷位置）]
- **讀取限制**：[無 / 動態載入限制 / 登入牆 / 截斷 X 字後]

---

維度 3：核心概念五欄比較

針對文章中提取 2–5 個核心概念，每個概念填寫五欄：

每個比較結論必須給出明確方向（全採 / 部分採 / 不採），不允許「視情況」模糊帶過。

---

維度 4：可採用點（具體行動）

列出 0–5 個可採用的行動，每條必須包含：

- 【系統/部門】行動描述 → 影響 → 難度（低/中/高）→ P等級（P1/P2/P3）

範例：

- 【知識庫/KM】在 knowledge/references/ 新增 XXX 分類 → 提升方法論覆蓋率 → 低 → P2
- 【社群部/CNT】將 XXX 觀點轉化為 Threads 輪播貼文 → 驗證受眾反應 → 中 → P3

難度低且影響明確的項目，優先升為 P2；可能影響多系統的項目，先評估跨系統衝突。

---

維度 5：明確不採用

列出從文章中識別但決定不採用的做法，並說明原因：

- [做法] — 不採用原因：[與現有架構衝突 / 成本過高 / 不符受眾 / 已有更好的替代方案]

若完全沒有不採用項目，仍必須輸出此維度並說明「本文無需排除的做法」，不得省略。

---

維度 6：整體對比判斷

- **與現有系統的關係**：[補充缺口 / 驗證現有做法 / 挑戰現有假設]
- **最有價值的一點**：[一句話總結]
- **最需要注意的風險**：[一句話說明]
- **整體評分**：[高價值 / 中等參考 / 低價值，理由一句]

---

維度 7：立即行動（0–3 條）

僅列出「本次對話結束前可以直接執行」的項目：

1. [動作] → [預期結果]
2. ...（最多 3 條，超過列入 tasks.md P3）

若沒有立即可執行的項目，輸出「本次無立即行動，採用點已列入 tasks.md」。

---

維度 8：存入知識庫（三步強制執行）

禁止：三步任一未完成 → 維度 8 未完成 = 整個分析未完成。

---

Step A：condensed entry → 分類 .md

插入位置：<!-- MANUAL END --> 標記之前。

路由規則：

condensed entry 格式（升規後，新增「完整分析」連結行）：

## [中文標題]（[YYYY-MM-DD]）

🔗 [完整 URL]

**作者**：[帳號/名稱]（[平台]）
**內容類型**：[社群貼文型 / 長文章型 / 技術文件型 / 研究報告型]
**分類**：[對應的 knowledge/references/ 分類標籤]
**完整分析**：`knowledge/analyses/YYYY-MM-DD-[slug].md`

**摘要**：[2-3 句話，說明文章核心觀點]

**深度分析**：[1-2 句，說明與我們系統的關聯或對比發現]

**採用點**：
- [採用點1]
- [採用點2]（最多 3 條）

**用途標籤**：[關鍵詞1、關鍵詞2、關鍵詞3]

---

---

Step B：完整八維分析 → knowledge/analyses/YYYY-MM-DD-[slug].md

檔名規則：YYYY-MM-DD-[作者縮寫或平台]-[主題關鍵字].md（全小寫英數，空格用 -） 範例：2026-04-27-threads-darkseoking-claude-code.md

檔案格式：

# [中文標題]（[YYYY-MM-DD]）

🔗 [完整 URL]
**平台**：[平台] ｜ **作者**：[帳號] ｜ **分類**：[knowledge/references/分類名]

---

## 維度 1：定性（基本資料）
[完整內容，不壓縮]

## 維度 2：讀取記錄
[完整內容]

## 維度 3：核心概念五欄比較
[完整表格]

## 維度 4：可採用點（具體行動）
[完整內容]

## 維度 5：明確不採用
[完整內容]

## 維度 6：整體對比判斷
[完整內容]

## 維度 7：立即行動
[完整內容]

## 維度 8（確認）
- Step A condensed entry 已寫入：[category].md ✅
- Step C index 已更新：knowledge/analyses/README.md ✅

---

Step C：更新雙索引（README.md ＋ topic-index.md）

C-1：knowledge/analyses/README.md — 在 <!-- ANALYSIS INDEX --> 標記之前新增一行：

| YYYY-MM-DD | [中文標題] | [平台] | [分類] | [用途標籤] | [高/中/低] | `[filename].md` |

C-2：knowledge/analyses/topic-index.md（⛔ 2026-06-21 補規，RCF-095） — 矩陣末行前插入新列（填 ●/△/空白），依該檔「維護說明」跑密度重算腳本整表覆蓋密度統計（禁手動增量），header 索引條目數 +1。

WHY：原 Step C 只列 README，導致 topic-index 矩陣自 2026-06-14 起漏更 8 篇（IMP-166 家族跨 session 漂移）。

---

五、分析品質自查

完成八維分析後，在輸出前逐項確認：

• 維度1完整：定性六欄均已填寫，可信度評估有理由
• ⛔ 多檔來源全讀（RCF-090）：若來源為 repo/多檔集合，維度 2 已列完整檔案清單且所有核心內容檔標 ✅ 已讀；未讀檔附排除理由；無「只讀 README 就下結論」
• 讀取記錄誠實：若有截斷或限制，已在維度2說明，且分析中標注推斷部分
• 五欄比較有結論：每個概念的比較結論欄位均有明確方向（全採/部分採/不採），無模糊帶過
• 採用點可追蹤：每條採用點有系統名稱 + 行動 + 影響 + 難度 + P等級，可直接移入 tasks.md
• 不採用維度已輸出：即使沒有不採用項目，維度5仍有內容
• 整體判斷有評分：維度6有整體評分與理由
• Step A 完成：condensed entry 已寫入 [category].md <!-- MANUAL END --> 之前，含「完整分析」連結行
• Step B 完成：完整八維分析已寫入 knowledge/analyses/YYYY-MM-DD-[slug].md（所有 8 維度逐字，無壓縮）
• Step C 完成：knowledge/analyses/README.md 已在 <!-- ANALYSIS INDEX --> 之前新增一行索引記錄
• 步驟九即時評估已啟動（詳細完成確認見步驟九內部品質自查三項）

---

步驟九：即時採用評估（v1.0 試行，2026-04-27 起）

觸發時機：維度 8 存入知識庫後立即執行。 核心設計：不重複維度 3-4 的分析——引用已有結論，補充決策，與 Tim 互動確認。 注意：維度 8 完成 ≠ 分析結束；Tim 確認後才是正式完成。

分流判斷

三步驟互動流程

Step 1：開頭列出已執行低難度項目（即使 0 條也明確說明，讓 Tim 有完整視野）

已執行（低難度）：
- [項目] → 已完成 ✅
（若無則寫：本次採用點均為中/高難度，無低難度直接執行項目）

然後引用維度 3-4 摘要（不重新分析）：

待討論採用點：
- [採用點描述]
  → 解決問題：[直接引用維度 4 B欄]
  → 現有對比：[直接引用維度 3 比較結論]
  → 難度/初步等級：[直接引用維度 4]

Step 2：Claude 給建議決定（⚠️ 若本次為 URL 直接觸發分析，此步驟前必須先 Read dev/tasks.md 確認 P1/P2 當前負載，再決定優先級，不可只複製維度 4 的等級）

建議：
- [採用點 A] → P2，理由：[考慮當前負載後的判斷]
- [採用點 B] → P3，理由：[一句話]
- [採用點 C] → 放棄，理由：[一句話]

Step 3：問 Tim 確認（⚠️ 強制等待點：輸出後 Claude 停止，不可在同一則訊息繼續執行）

「你同意這個分配嗎？或有哪條想調整？」

Tim 回應後的執行流程

完成後：tasks.md commit + push（若有修改 analyses/ 或 references/ 則一起 commit）

品質自查對應（本步驟完成後才可確認）

• Step 9 評估完成：已執行低難度列出 + Tim 已確認中 / 高難度分配
• tasks.md 最終寫入完成（按 Tim 確認結果）
• 放棄項目已補寫 analyses/[slug].md 維度 5（若有）+ condensed entry 已同步更新（若有）

試行期管理（v1.0，2026-04-27 起）

• 每次執行後：在對話品質自查 improvements.md 掃描時，主動記錄本次 Step 9 執行狀況（順暢 / 哪裡卡）
• 第 1 次執行結束後：在 Step 3 Tim 確認後，主動問「這是新版步驟九首次執行，流程有沒有哪裡感覺卡？」
• 第 3 次執行後：Claude 主動發起回顧 → 讀取 improvements.md 相關條目 → 輸出「順暢 / 局部調整 / 需重設計」判斷

---

六、最近修改記錄