i-have-adhd: 為執行功能障礙優化編碼代理輸出

概述

i-have-adhd 是一套專門的技能與插件集,旨在防止編碼代理將答案「埋沒」在層層的對話填充物與冗長內容之下。透過實施一套嚴格的輸出限制,它將 AI 的回應從敘述性解釋轉變為行動導向的指令,使其對於 ADHD 使用者或僅僅偏好高密度、低雜訊技術溝通的使用者而言更易於理解。

核心問題:AI 的冗長性

現代編碼代理,特別是那些由近期 Claude 模型驅動的代理,通常表現出極度冗長的傾向。這種行為通常表現為:

  • 前言與結語: 在回應開頭使用「好問題!」或在結尾使用「希望這對你有幫助!」
  • 敘述性解釋: 在說明實際修復方法之前提供冗長的背景資訊。
  • 負面限制: 除了說明 AI 做了什麼 之外,還解釋 AI 沒有做什麼
  • 循環論證: 在回應末尾添加可能使主要解決方案失效的注意事項。

ADHD 友善輸出的 10 條規則

i-have-adhd 技能強制執行十條特定規則,以確保 AI 保持專注於任務,並將使用者的認知負荷降至最低:

  1. 以下一步行動作為開頭: 第一句話必須是使用者需要採取的立即步驟。
  2. 多步驟任務編號: 對序列使用編號列表,以確保清晰度與可追蹤性。
  3. 以一個具體的下一步作為結尾: 每個回應都必須以單一、明確的行動項目結束。
  4. 抑制離題: 移除任何對於完成當前任務不直接要求的資訊。
  5. 每輪重述狀態: 保持專案的當前狀態可見,以防止迷失方向。
  6. 具體的時間估計: 使用實際的分鐘或小時(例如,「15 分鐘」)而非模糊的詞彙如「一點點」。
  7. 讓成果可見: 清晰地標示出某個步驟已成功完成。
  8. 事實陳述錯誤: 平實地報告錯誤,而不使用道歉的語言。
  9. 限制列表長度為 5 項: 透過限制列表長度來防止認知負荷過重。
  10. 無前言、摘要或結語: 消除所有對話填充物。

實施與相容性

該專案是以「技能」的形式實施,可以整合到各種 AI 代理中。它為多個平台提供了特定的適配器與插件:

  • Claude Code: 支持插件與鉤子以實現「始終開啟」的功能。
  • OpenCode: 包含伺服器插件與專用命令。
  • Gemini CLI: 為自定義命令與擴展提供原生路由。
  • Cursor: 包含用於整合的便攜式技能元數據。
  • 其他平台: 為 Kimi 與 Qwen 提供相容層。

安裝

使用者可以透過將其 CLI 提示指向以下方式來安裝該技能:Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd, refer to the repo's AGENTS.md for instructions.

社群洞察與評論

雖然該專案已獲得顯著的關注(接近 3 萬顆星),但社群對於其效能與實施方式提出了幾點技術與哲學上的觀點。

模型特定行為

許多使用者指出,對此技能的需求在 Anthropic 的 Claude 模型中最为急性。一些使用者報告,即使在技能啟動的狀態下,Claude 仍傾向於在幾輪對話後恢復其冗長的「Claudian」風格。

"Claude models are the ones that need this the most and in my experience with this specific skill only maintain the conciseness for a few turns at most before they completely forget and are back to their unfathomable verbosity."

技術開銷

一些貢獻者對儲存庫的大小提出了質疑,指出雖然核心提示詞(Prompt)相對較小(在 SKILL.md 中約為 140 行),但為了支持各種代理插件,該儲存庫包含了數十個檔案中的數千行程式碼。

替代方案

使用者建議了幾種實現類似結果的正式技能之外的替代方案:

  • 提示詞工程: 使用關鍵字如 "BLUF" (Bottom Line Up Front), "tersely," 或 "Assume ADHD."
  • 輸出風格: 使用 "output style" 配置,這可能比全域技能更頻繁地提醒模型。
  • 模型選擇: 一些使用者發現,將模型從 Opus 5 降級到 Opus 4.8 能顯著提高可讀性並減少冗長性。

無障礙性疑慮

關於專案的命名與框架存在爭議。雖然旨在幫助那些有執行功能障礙的人,但一些使用者認為 "i-have-adhd" 這個名稱可能具有冒犯性,或者將臨床診斷用於「10 倍提升生產力」而使其變得輕描淡寫。

對比:之前 vs. 之後

特性 標準 AI 回應 i-have-adhd 回應
開頭 "Great question! Let me think..." "Run npm install jsonwebtoken@latest..."
結構 敘述性段落 編號的行動步驟
結尾 "Hope this helps! Let me know..." "Next: paste the first failing line..."
焦點 背景資訊與解釋 立即執行

Sources

相關