# 影片筆記：I-HAVE-ADHD Skill +  Claude,Codex,Deepseek: YOU'RE MISSING OUT without THIS SKILL!

## 一句話總結

影片介紹了 GitHub 上熱門的 Claude Code 插件 "I have ADHD"，該插件透過模擬 ADHD 患者的認知特點（工作記憶有限、需可見進度），強制 AI 編碼助手以「行動優先、編號列表、無廢話」的結構回應，從而解決 AI 回答冗長、隱藏關鍵指令的問題，並顯著節省 Token 消耗。

## 核心重點

1.  **插件名稱與熱度**：
    *   插件名稱為 **"I have ADHD"**。
    *   在 GitHub 上獲得約 16,000 顆星，由開發者 **Igri** 製作。
    *   採用 MIT 授權，完全免費且開源。

2.  **設計靈感與痛點**：
    *   靈感來自書籍《the ADHD toolkit》，但針對 LLM 的溝通方式進行調整。
    *   解決的核心痛點：AI 助手回答冗長，充滿前言、最佳實踐講解和未請求的建議，導致真正答案被埋沒。
    *   認知原理：模擬 ADHD 患者的特點（工作記憶有限、理解與執行間的落差、需要可見進度），這同樣適用於疲勞或分心的開發者。

3.  **10 項核心規則**：
    1.  **行動優先 (Lead with action)**：直接給出命令或檔案編輯位置，無前言。
    2.  **編號與單一動作 (Numbered & Bounded)**：多步驟任務需編號，每步僅含單一有界動作，無隱藏的「然後」鏈。
    3.  **具體下一步 (Concrete next action)**：回應結尾必須包含一個可在兩分鐘內完成的具體下一步。
    4.  **抑制旁支 (Tangent suppression)**：先解決主要問題，次要建議作為單獨的後續回應。
    5.  **重述狀態 (Restate state)**：每輪回應需重述當前進度（例如：「步驟 3/5 完成，schema 已更新」）。
    6.  **回溯填充 (Backfilling)**：在長會話中確保用戶不會迷失進度。
    7.  **具體時間預估 (Specific time estimates)**：提供具體時間（如「約 15 分鐘」），而非模糊說法。
    8.  **事實性錯誤報告 (Matter-of-fact errors)**：直接報告原因和修復方法，無情緒化或猶豫詞彙。
    9.  **限制列表長度 (Lists capped)**：列表最多五項。
    10. **無廢話 (No fluff)**：無前言、無回顧、無結尾客套話（如「希望這有幫助」）。

4.  **例外與覆蓋規則**：
    *   **解釋請求**：若用戶要求解釋，AI 仍會提供結構化的解釋。
    *   **破壞性操作**：若操作具破壞性，需先確認。
    *   **模糊請求**：若請求 genuinely ambiguous（真正模糊），僅提問一個澄清問題，而非猜測。

5.  **實際操作對比**：
    *   **無插件狀態**：回答包含 JWT 定義、認證重要性、不同方法等大量文字，命令隱藏其中。
    *   **有插件狀態**：
        *   第一行即為安裝命令。
        *   四個編號步驟，每步包含確切的檔案和行號。
        *   結尾指定下一步（運行開發伺服器並測試登入路由）。
        *   預估總時間（約 20 分鐘）。
        *   無多餘文字、無講課、無「好問題」等客套話。

6.  **自訂與多語言**：
    *   由於技能僅是一個 `skill.md` 檔案，用戶可 fork 倉庫，編輯 `skills/avadh/skill.md` 來修改規則（例如將列表上限改為三項）。
    *   倉庫已翻譯為中文、日文、韓文和葡萄牙文。

7.  **講者評語**：
    *   **優點**：修正了模型過度注重禮貌而非實用性的溝通方式；零成本、開源、安裝快速（兩分鐘）、可隨時關閉；「重述進度」和「結尾小下一步」規則極具價值，使長期的 Agent 會話更易跟蹤；節省 token，對有限制方案的用戶有益。
    *   **缺點**：對初學者可能過於簡略（too tur），需要明確要求解釋。
    *   **總結**：對於已知曉自己在做什麼的開發者，這是一個非常好的選項。

## 詳細大綱

### A. 插件背景與核心理念
*   **名稱與熱度**：插件名稱為 "I have ADHD"，在 GitHub 上獲得約 16,000 顆星。
*   **開發者**：由開發者 Igri 製作。
*   **授權與費用**：MIT 授權，完全免費且開源。
*   **設計靈感**：靈感來自書籍《the ADHD toolkit》，但針對 LLM（大型語言模型）的溝通方式進行調整。
*   **核心痛點**：解決 AI 助手回答冗長、充滿前言、最佳實踐講解和未請求的建議，導致真正答案被埋沒的問題。
*   **認知原理**：模擬 ADHD 患者的特點（工作記憶有限、理解與執行間的落差、需要可見進度），這同樣適用於疲勞或分心的開發者。

### B. 核心規則 (10 項原則)
1.  **行動優先 (Lead with action)**：直接給出命令或檔案編輯位置，無前言。
2.  **編號與單一動作 (Numbered & Bounded)**：多步驟任務需編號，每步僅含單一有界動作，無隱藏的「然後」鏈。
3.  **具體下一步 (Concrete next action)**：回應結尾必須包含一個可在兩分鐘內完成的具體下一步。
4.  **抑制旁支 (Tangent suppression)**：先解決主要問題，次要建議作為單獨的後續回應。
5.  **重述狀態 (Restate state)**：每輪回應需重述當前進度（例如：「步驟 3/5 完成，schema 已更新」）。
6.  **回溯填充 (Backfilling)**：在長會話中確保用戶不會迷失進度。
7.  **具體時間預估 (Specific time estimates)**：提供具體時間（如「約 15 分鐘」），而非模糊說法。
8.  **事實性錯誤報告 (Matter-of-fact errors)**：直接報告原因和修復方法，無情緒化或猶豫詞彙。
9.  **限制列表長度 (Lists capped)**：列表最多五項。
10. **無廢話 (No fluff)**：無前言、無回顧、無結尾客套話（如「希望這有幫助」）。

### C. 例外與覆蓋規則 (Overrides)
*   **解釋請求**：若用戶要求解釋，AI 仍會提供結構化的解釋。
*   **破壞性操作**：若操作具破壞性，需先確認。
*   **模糊請求**：若請求 genuinely ambiguous（真正模糊），僅提問一個澄清問題，而非猜測。

### D. 安裝與使用
*   **安裝命令**：`claude plug-in install I have a HD` (逐字稿原文)。
*   **激活命令**：在 Claude Code 中輸入 `/avad HD`。
*   **停用命令**：`claude plugin disable I have a HD`。

### E. 實際操作對比
*   **無插件狀態**：回答包含 JWT 定義、認證重要性、不同方法等大量文字，命令隱藏其中。
*   **有插件狀態**：
    *   第一行即為安裝命令。
    *   四個編號步驟，每步包含確切的檔案和行號。
    *   結尾指定下一步（運行開發伺服器並測試登入路由）。
    *   預估總時間（約 20 分鐘）。
    *   無多餘文字、無講課、無「好問題」等客套話。

### F. 自訂與多語言
*   **自訂方式**：由於技能僅是一個 `skill.md` 檔案，用戶可 fork 倉庫，編輯 `skills/avadh/skill.md` 來修改規則（例如將列表上限改為三項）。
*   **多語言支援**：倉庫已翻譯為中文、日文、韓文和葡萄牙文。

### G. 講者評語與結論
*   **優點**：
    *   修正了模型過度注重禮貌而非實用性的溝通方式。
    *   零成本、開源、安裝快速（兩分鐘）、可隨時關閉。
    *   「重述進度」和「結尾小下一步」規則極具價值，使長期的 Agent 會話更易跟蹤。
    *   節省 token，對有限制方案的用戶有益。
*   **缺點**：
    *   對初學者可能過於簡略（too tur），需要明確要求解釋。
*   **總結**：對於已知曉自己在做什麼的開發者，這是一個非常好的選項。

## 工具 / 模型 / 名詞整理

*   **Claude Code**：AI 編碼助手工具。
*   **I have ADHD**：本影片介紹的插件/技能名稱。
*   **GitHub**：代碼託管平台。
*   **Igri**：插件開發者名稱。
*   **Codeex**：提及可與該技能配合使用的其他代理工具。
*   **the ADHD toolkit**：被提及的靈感來源書籍名稱。
*   **npm install**：安裝命令範例。
*   **Express app**：應用程式框架範例。
*   **JWT**：JSON Web Tokens，身份驗證範例。
*   **super thanks**：YouTube 捐贈選項。
*   **join button**：YouTube 會員按鈕。

## 操作流程整理

1.  **安裝插件**：
    *   執行命令：`claude plug-in install I have a HD`
2.  **激活插件**：
    *   在 Claude Code 介面中輸入：`/avad HD`
3.  **使用插件進行編碼**：
    *   提出開發需求。
    *   AI 會依照 10 項規則回應：
        *   直接給出命令或檔案編輯位置。
        *   多步驟任務編號化，每步單一動作。
        *   結尾包含具體下一步（兩分鐘內可完成）。
        *   重述當前進度狀態。
        *   提供具體時間預估。
        *   無前言、無客套話、無旁支話題。
4.  **停用插件**：
    *   執行命令：`claude plugin disable I have a HD`
5.  **自訂規則（可選）**：
    *   Fork 倉庫。
    *   編輯 `skills/avadh/skill.md` 檔案以修改規則（如調整列表上限）。

## 值得注意的限制或風險

*   **初學者適用性**：插件對初學者可能過於簡略（too tur），若需要詳細解釋，必須明確要求 AI 提供解釋，否則 AI 會直接給出行動指令。
*   **命令辨識風險**：安裝與激活命令在逐字稿中出現拼寫不一致的情況（如 `I have a HD`、`/avad HD`），使用者需確認實際命令格式，以免操作失敗。
*   **依賴特定環境**：此插件專為 Claude Code 設計，其他工具（如提及的 Codeex）可能需要不同的配置或支援。

## 逐字稿辨識疑點

*   **I have a HD**：逐字稿中安裝命令部分聽起來或寫為 "I have a HD"，與插件名稱 "I have ADHD" 略有不同，需查證是否為口誤或特定識別碼。
*   **avad HD**：激活命令部分聽起來為 `/avad HD`，與插件名稱 "I have ADHD" 拼寫不一致，需查證正確命令。
*   **skills/avadh/skill.md**：檔案路徑中出現 "avadh"，與插件名稱 "ADHD" 拼寫不一致，需查證正確路徑。
*   **too tur**：講者形容插件對初學者可能過於「tur」，疑為口誤或聽寫錯誤，需查證原意。
*   **JW2 authentication**：範例中提到的身份驗證類型為 "JW2"，疑為 JWT 的聽寫錯誤，但依規則保留原樣。

## 可延伸追問

*   如何確認 `claude plug-in install I have a HD` 與 `/avad HD` 的正確拼寫？
*   除了 Claude Code，Codeex 和其他代理工具如何具體整合此技能？
*   若需將列表上限從 5 項改為 3 項，具體的 `skill.md` 修改語法為何？
*   該插件在長會話中「重述狀態」的具體實現機制為何，是否會增加 token 成本？