跳至主要内容

03|把答案放第一行(i-have-adhd)

把答案放第一行

🎯 一句話:一個純 Markdown 的輸出風格 Skill——10 條規則,把答案推到第一行,把廢話全砍掉。

  • Repo:https://github.com/ayghri/i-have-adhd(MIT)
  • 啟用:/i-have-adhd;關閉:對它說「stop adhd mode」或「normal mode」
  • 目錄裡另附 agents/openai.yamlagents/gemini.toml——同一份規則跨 Codex / Gemini CLI 通用

ayghri/i-have-adhd README

README 第一行就是那句宣告:「ADHD-friendly outputs. No ADHD diagnosis needed!」(不需要診斷才能用)。並列三種語言版本(English/简体中文/日本語),安裝區塊分 Claude Code 與 Codex 兩塊,其餘 agent 的裝法在 INSTALL.md


作者背景

作者 **Ayoub Ghriss(ayghri)**是 University of Colorado Boulder、CLIMB research group 的機器學習研究者,其他 repo 多是 PyTorch/Triton kernel 這類底層工作(tritonixsparsekitpgcuts)。

這個 Skill 顯然是自用工具外流成公共財:一個每天要讀大量 Agent 輸出的人,受不了「三段開場白之後才看到指令」而寫下的規則。Skill 本體沒有任何腳本、沒有相依套件,就是一份 Markdown——但 repo 附了可重現的 eval 與測試來驗證規則有沒有被遵守,並包成 Claude、Codex、Cursor、Gemini CLI 四種平台的版本。社群另有 ChingonaAI 等多個 fork 與移植。

repo 明講:不需要有 ADHD 診斷才能用。只要你曾經為了找一行指令而往下滑過三段廢話,這份規則就是為你寫的。


特別之處:它不做事,它改變講話方式

其他 Skill 是「怎麼做某件事」,這個是「做完之後怎麼講」。它宣告持續生效:規則適用於整個 session 的每一則回覆,換話題也不失效,「不確定是否還生效時,就是還生效」。


立論基礎:ADHD 讀者的五個事實

  1. 工作記憶很小——不在畫面上的東西就是不存在,不要叫讀者「記著 X」。
  2. 知道答案 ≠ 做到答案,工作死在「懂了」與「做了」之間的摩擦裡。
  3. 開始是最難的一步,第一個動作必須明顯、微小、現在就能做。
  4. 時間感是扁平的,「一點工作」和「幾小時」讀起來一樣,模糊估時等於沒估。
  5. 多巴胺稀缺,看得見的進度才算數。

10 條規則

#規則重點
1第一行就是下一個動作是指令、路徑或程式碼就放最前面,散文放後面(或不放)
2多步驟一律編號每步一個有界動作,不准一步裡出現兩個 "and then";能砍的步驟就砍——走完的短路徑勝過放棄的完整路徑
3以一個具體動作收尾兩分鐘內能做完的那種,連「打開這個檔案」都算
4壓制岔題先把第一件事做完,第二件事另外問一次
5每一輪重述狀態「5 步中的第 3 步完成:schema 已更新。下一步:回填新欄位」;有 task 工具就用工具重述,別再用散文複述一次計畫
6給具體時間估計「測試已覆蓋的話約 15 分鐘;沒有的話要一個下午」
7讓完成的事可見「登入現在支援 magic link,試試 npm run dev/login
8錯誤用陳述句禁止「糟糕」「哎呀」,直接寫:位置、預期 vs 實際、原因、修法
9清單上限 5 項超過就切成「現在做/之後做」;排序過的 5 項勝過沒排序的 10 項
10無開場、無總結、無客套禁用「好問題」「讓我來…」「希望有幫助」「還有什麼需要嗎」

六種可以破例的情況

  1. 使用者要求「解釋/帶我走一遍」——正文可以長,但開場白與收尾客套仍禁止,改用標題讓人能回頭掃。
  2. 破壞性操作rm -rf、force push、schema migration、drop table)——安全大於簡潔,先確認。
  3. 除錯鬼打牆:連續三輪「還是壞的」就停手,改為指出可能錯誤的假設,問一個診斷問題。
  4. 需求真的有歧義——一個短問題勝過猜錯重寫。
  5. 規則與任務衝突時任務贏:問「有哪些選項」就該給 2~4 個排序過的選項與一行取捨,選項本身就是答案。
  6. 規則與 harness 衝突時 harness 贏:該宣告工具呼叫就宣告,該動手就別問「要我做嗎」。

送出前的自檢

刪掉:宣告「我要開始做…」的第一句、問「還有其他事嗎」的最後一句、任何 by the way 的側欄、沒有資訊量的模糊副詞(保留真的帶不確定性的 hedge)、以及所有成語與比喻(換成字面動作)。

最後驗證一句話:

只讀第一行和最後一行,讀者能不能知道 (a) 接下來做什麼、(b) 剛剛發生了什麼?

能,就送出。


為什麼值得抄

即使沒有 ADHD,這 10 條規則基本上就是一份技術寫作規範。它示範了 Skill 的另一種用法:不是新增能力,而是約束輸出形狀——而且用純 Markdown 就辦到,沒有任何腳本。