i-have-adhd 怎麼安裝:讓 Codex 和 Claude Code 先給行動再解釋

介紹 i-have-adhd 輸出風格外掛的工作方式,以及在 Codex、Claude Code 和其他 Agent 中安裝、啟用、更新與自定義的方法。

當 AI 程式設計助手給出一大段背景說明,卻把真正要執行的命令藏在最後,問題通常不在模型能力,而在輸出結構。i-have-adhd 是一個面向編碼 Agent 的輸出風格技能:要求助手先給下一步行動,再補充必要解釋,並用編號步驟保持任務狀態清晰。

它不是 ADHD 診斷或治療工具,也不提供醫療建議。專案名稱描述的是一種偏好的資訊呈現方式;即使沒有 ADHD,也可以使用它來減少冗長回答帶來的閱讀負擔。

快速答案

在 Claude Code 中安裝:

1
2
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

安裝後輸入 /i-have-adhd,即可在當前會話啟用。

在 Codex 中安裝:

1
2
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

安裝後輸入 $i-have-adhd 啟用。這個技能預設不會自動介入所有回答;只有明確呼叫後才會改變當前會話的輸出風格。

i-have-adhd 改變了什麼

這個技能不負責寫程式碼、執行命令或修改專案,它主要約束 Agent 如何組織回答。官方規則可以歸納為以下幾類:

規則 實際效果
行動優先 第一行直接說明現在要做什麼
步驟編號 多步驟任務按執行順序列出,不把動作埋在段落中
每輪重述狀態 對話變長後仍能看出當前做到哪裡、下一步是什麼
控制支線 非必要背景和延伸建議暫不展開
列表限長 一次最多突出五項,減少同時處理的資訊
明確收尾 結尾只留下一個具體的下一步,而不是客套話

它還要求對時間估計更具體、把已完成的小進展明確標出來,並用平實語氣報告錯誤。核心不是簡單地“少說話”,而是把資訊重新排序:行動、狀態和阻塞項在前,解釋在後。

在 Claude Code 中安裝和管理

先新增官方倉庫提供的外掛市場,再安裝外掛:

1
2
claude plugin marketplace add ayghri/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

檢查安裝結果:

1
claude plugin list

需要更新時執行:

1
claude plugin marketplace update i-have-adhd

如果只想暫時停用,而不是刪除外掛:

1
claude plugin disable i-have-adhd

徹底解除安裝則執行:

1
2
claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd

安裝完成後,在需要這種輸出方式的會話裡輸入 /i-have-adhd。如果命令沒有出現在自動補全列表中,先重啟 Claude Code,因為外掛索引通常在啟動時讀取。

在 Codex 中安裝和管理

Codex 的安裝命令與 Claude Code 略有不同:

1
2
codex plugin marketplace add ayghri/i-have-adhd --ref main
codex plugin add i-have-adhd@i-have-adhd

檢查是否已經安裝:

1
codex plugin list

需要獲取新版時,可以更新市場索引,再重新安裝外掛:

1
2
3
codex plugin marketplace upgrade i-have-adhd
codex plugin remove i-have-adhd
codex plugin add i-have-adhd@i-have-adhd

解除安裝命令如下:

1
2
codex plugin remove i-have-adhd
codex plugin marketplace remove i-have-adhd

在對話中輸入 $i-have-adhd 才會啟用這個技能。想恢復普通輸出時,可以直接告訴 Agent stop adhd modenormal mode。如果切換後仍沿用舊風格,新建一個會話通常比反覆糾正當前上下文更可靠。

如何設為預設輸出風格

如果每次會話都需要手動啟用,可以把持續性規則寫入全域性指令檔案。

Claude Code 使用 ~/.claude/CLAUDE.md,Codex 使用 ~/.codex/AGENTS.md。加入以下內容:

1
2
3
## Output style

Always follow the rules in the `i-have-adhd` skill: action-first, numbered steps, no preamble, no closers, state restated each turn.

全域性啟用會影響所有專案。更穩妥的做法是先在幾個會話中手動呼叫,確認這種節奏適合自己的工作方式,再決定是否寫入全域性配置。對於需要教學式講解、設計討論或長篇推理的任務,也可以臨時要求助手完整解釋。

安裝到其他 Agent 工具

支援 Agent Skills 生態的工具可以透過 npx skills 安裝:

1
npx skills add ayghri/i-have-adhd

全域性安裝:

1
npx skills add ayghri/i-have-adhd -g

也可以指定目標工具並跳過互動確認,例如:

1
2
npx skills add ayghri/i-have-adhd -a cursor -y
npx skills add ayghri/i-have-adhd -a opencode -y

使用以下命令檢查本地或全域性技能:

1
2
npx skills list
npx skills ls -g

Antigravity 使用者可以直接從 GitHub 倉庫安裝:

1
2
agy plugin install https://github.com/ayghri/i-have-adhd
agy plugin list

解除安裝時執行:

1
agy plugin uninstall i-have-adhd

一次回答會怎樣變化

假設構建失敗,普通回答可能先解釋依賴解析原理、列出幾個潛在原因,最後才給檢查命令。啟用 i-have-adhd 後,回答會更接近下面的結構:

  1. 先執行一條只讀命令,取得完整錯誤資訊。
  2. 明確當前狀態,例如“構建尚未透過,正在確認缺失依賴”。
  3. 根據輸出只選擇一個最可能的修復方向。
  4. 修復後立即執行驗證命令。

最後只保留一個下一步,例如“現在把第一條命令的輸出發來”。這樣做尤其適合安裝依賴、處理 Git 衝突、排查部署問題,以及需要在多個短步驟之間來回確認的任務。

簡潔不等於跳過安全檢查

官方技能為幾類場景保留了例外:

  1. 使用者明確要求解釋或完整演練時,仍應充分說明。
  2. 刪除資料、覆蓋檔案等破壞性操作必須先確認,不能為了簡短而繞過安全步驟。
  3. 連續多輪除錯沒有進展時,應暫停並質疑原有假設,而不是繼續堆疊命令。
  4. 條件確實不明確時,應先問一個簡短問題,避免憑空猜測。

因此,這個技能更像資訊優先順序規則,而不是強制壓縮一切內容。涉及醫療、法律、財務或系統安全的任務時,必要的風險說明和確認仍然要保留。

自定義自己的版本

如果預設規則過於激進,可以 Fork 倉庫並編輯 skills/i-have-adhd/SKILL.md。比較實用的調整包括:

  • 把列表上限從五項改為適合自己的數量;
  • 允許在程式碼評審中保留更完整的原因說明;
  • 規定只在執行型任務中使用行動優先結構;
  • 為團隊加入固定的“當前狀態、風險、下一步”模板。

修改前建議先閱讀完整技能檔案,確認規則和例外是否符合自己的工作環境。安裝第三方外掛時也應檢查倉庫內容、許可證和後續更新,而不是隻依據專案名稱直接啟用。

與 caveman 有什麼區別

i-have-adhd 主要解決“先說什麼、每輪如何保持任務狀態”的問題;caveman 更強調壓縮 Agent 輸出、減少廢話和 token 消耗。兩者目標相近,但關注點不同:前者偏向行動順序和注意力負擔,後者偏向表達壓縮。

如果只是嫌回答太長,先嚐試 caveman;如果常常找不到下一步、對話一長就丟失任務狀態,i-have-adhd 的結構化規則更有針對性。不要同時疊加過多風格約束,否則模型可能為了滿足格式而省略必要資訊。

常見問題

安裝後為什麼沒有變化?

外掛預設不會自動啟用。Claude Code 需要輸入 /i-have-adhd,Codex 需要輸入 $i-have-adhd。如果希望每個會話都生效,再把輸出規則寫入對應的全域性指令檔案。

為什麼找不到斜槓命令或技能?

先重啟 Agent,再執行外掛或技能列表命令確認安裝位置。使用本地路徑新增市場時,路徑應指向倉庫根目錄;使用 GitHub 時則使用 owner/repo 形式。

它能幫助診斷或治療 ADHD 嗎?

不能。它只調整大語言模型的輸出方式,不評估症狀、不管理藥物,也不能替代醫生或其他專業支援。如果你關心自身健康狀況,應諮詢合格的醫療專業人員。

專案可以商用或修改嗎?

倉庫採用 MIT License。實際使用或再分發前,仍建議檢視倉庫中的最新許可證文字和檔案內容。

總結

i-have-adhd 的價值不在於讓 Agent 永遠只回答幾句話,而在於穩定回答順序:先行動,再解釋;每輪說明狀態;結束時只留下一個明確的下一步。對於經常被長篇前言、過多支線和模糊收尾打斷的開發流程,這是一套可以直接安裝,也可以 Fork 後自行調整的輸出規範。

專案地址:ayghri/i-have-adhd