i-have-adhd: Skill AI Nhỏ Khiến Coding Agent Cuối Cùng Cũng Trả Lời Thẳng

Coding agent của bạn không hẳn là vô dụng. Nhiều khi nó chỉ đang trả lời sai hình dạng so với khoảnh khắc bạn cần.

Bạn hỏi lệnh tiếp theo. Nó mở đầu bằng “Câu hỏi hay.” Bạn hỏi vì sao test fail. Nó xoa dịu cảm xúc một đoạn rồi mới đưa dòng lỗi. Bạn hỏi cách sửa. Câu trả lời có ở đó, nhưng bị chôn dưới bối cảnh, rào trước đón sau, tóm tắt lại, và một lời kết lịch sự.

Đó là vấn đề nhỏ nhưng đau mà i-have-adhd giải quyết. Đây là một skill nhẹ cho AI coding agent với một nguyên tắc rõ: đưa hành động lên trước, đánh số các bước, làm tiến độ nhìn thấy được, và dừng nói khi xong việc.

Repo này có 14.000 sao và 740 fork tính đến tháng 7/2026. Con số đó chính là câu chuyện: đây không chỉ là vấn đề accessibility cho ADHD. Đây là vấn đề trải nghiệm developer đang nằm ngay trước mắt.

---

TL;DR

• Nó là gì: Một skill 10 quy tắc thay đổi cách AI coding agent trình bày câu trả lời: lệnh trước, bước đánh số, hành động tiếp theo rõ ràng, không xã giao dài dòng.
• Vì sao viral: Developer nào cũng từng mất thời gian kéo qua một câu trả lời AI rất lịch sự chỉ để tìm đúng một dòng cần dùng.
• Hợp với ai: Claude Code, Cursor, Codex, Copilot, Gemini CLI, hoặc bất kỳ agent setup nào mà hình dạng output quan trọng ngang chất lượng model.
• Điểm cần nhớ: Nó không làm model thông minh hơn. Nó làm câu trả lời dễ thực thi hơn.
• Nên thử trước với: Một test fail, lỗi install, hoặc terminal message khó hiểu. Đó là nơi khác biệt lộ ra rõ nhất.

---

Bản Đồ Cho Người Mới

Nếu bạn mới đây, hãy đọc bài theo ba vòng:

1. Phần 1 (Nền Tảng) — hiểu vấn đề mà repo này giải quyết.
2. Phần 2 (Điều Tra) — xem mười quy tắc hoạt động thực tế ra sao.
3. Phần 4 (Triển Khai) — làm theo các bước cài đặt và thử ngay.

Bài Tập Đầu Tiên Cho Sinh Viên

Chọn bất kỳ công cụ AI coding nào bạn đang dùng. Đặt một câu hỏi kỹ thuật. Đếm xem bao nhiêu dòng trôi qua trước khi xuất hiện câu trả lời thực sự. Ghi lại con số đó. Sau đó cài i-have-adhd và hỏi lại y câu hỏi cũ. So sánh hai đầu ra cạnh nhau. Đó là toàn bộ thí nghiệm, và nó mất dưới 30 phút.

Đến cuối bài, bạn nên giải thích được repo này bằng một câu:

i-have-adhd xem output của AI như một giao diện người dùng: nếu hành động tiếp theo bị giấu đi, giao diện đó đã thất bại.

---

Phần 1: Nền Tảng (Mental Model)

Tại Sao Output Của AI Khó Scan

Các mô hình ngôn ngữ hiện đại được huấn luyện để “hữu ích và lịch sự”. Nghe có vẻ tốt — cho đến khi bạn nhận ra rằng “hữu ích và lịch sự” trong dữ liệu huấn luyện thường có nghĩa là:

• Mở đầu bằng lời thừa nhận thân thiện
• Nhắc lại câu hỏi để chứng minh đã hiểu
• Cung cấp bối cảnh trước khi trả lời
• Đưa ra câu trả lời
• Tóm tắt lại những gì vừa nói
• Kết thúc bằng “Hy vọng điều này giúp ích!”

Với một bài luận, cấu trúc đó hoạt động. Với một phiên coding khi bạn cần lệnh tiếp theo trong ba giây, đó là ma sát.

Đó là mental model quan trọng: output của AI là một giao diện người dùng.

Chúng ta thường nói về AI tool như thể thứ duy nhất quan trọng là độ thông minh của model. Benchmark cao hơn, context window lớn hơn, token rẻ hơn, khả năng code tốt hơn. Những thứ đó quan trọng, nhưng không phải toàn bộ trải nghiệm.

Nếu model biết cách sửa nhưng chôn nó ở dòng 17, giao diện vẫn tệ. Nếu nó đưa năm bước tiếp theo trong khi bạn chỉ cần một bước, giao diện vẫn nhiễu. Nếu nó nói “cái này có thể mất một lúc” thay vì “khoảng 15 phút,” giao diện vẫn mơ hồ.

i-have-adhd không cố thay đổi bộ não của model. Nó thay đổi hình dạng câu trả lời của model.

Năm sự thật dẫn dắt mọi quy tắc trong i-have-adhd:

1. Bộ nhớ làm việc nhỏ. Bất cứ thứ gì không còn trên màn hình đều bị quên. Agent không nên bảo bạn “nhớ X trong đầu.”
2. Biết câu trả lời ≠ làm theo câu trả lời. Khoảng cách giữa hiểu và thực hiện là nơi công việc chết.
3. Bước đầu tiên khó nhất. Hành động đầu tiên phải rõ ràng, nhỏ, và làm được ngay bây giờ.
4. Thời gian cảm giác đồng nhất. “Một chút công việc” và “vài tiếng” đều nghe như nhau. Ước tính mơ hồ thất bại.
5. Dopamine khan hiếm. Tiến độ nhìn thấy được quan trọng. Chiến thắng bị chôn vùi không ghi nhận được.

Đây không phải là khuyết điểm cá nhân. Đây là cách sự chú ý hoạt động khi bị áp lực. Những quy tắc trong skill này làm việc cùng với thực tế đó, thay vì chống lại nó.

Luận Điểm Sản Phẩm Trong Một Dòng

Hầu hết prompt pack cố làm assistant nghe thông minh hơn. i-have-adhd cố làm assistant dễ hành động hơn.

Điểm khác biệt đó là lý do dự án này đáng chú ý. Nó không chạy theo một personality mới. Nó gỡ ma sát ở khoảnh khắc giữa “tôi hiểu rồi” và “tôi đã làm xong.”

---

Phần 2: Cuộc Điều Tra

Cấu Trúc Repository

Cốt lõi của repo là một file SKILL.md duy nhất tại skills/i-have-adhd/SKILL.md. Mọi thứ còn lại là hạ tầng phân phối.

skills/i-have-adhd/SKILL.md   ← 10 quy tắc
hooks/                         ← hook SessionStart always-on (Claude Code)
.claude-plugin/                ← plugin manifest cho Claude Code
.codex-plugin/                 ← cấu hình plugin Codex
.cursor/skills/i-have-adhd/    ← bản sao skill cho Cursor
.agents/plugins/               ← tương thích plugin Codex
INSTALL.md                     ← hướng dẫn cho từng agent lớn
evals/                         ← bộ kiểm thử tự động để đo tuân thủ quy tắc

Skill được thiết kế để cài qua plugin system, không phải copy-paste thủ công. Nghĩa là khi maintainer cải thiện quy tắc, bạn nhận update qua luồng plugin update bình thường.

Điều Gì Khiến Nó Chuyên Nghiệp, Không Chỉ Dễ Thương

Repo này có thể dừng ở một file Markdown và vẫn hữu ích. Nhưng thứ khiến nó giống một công cụ nghiêm túc là lớp phân phối xung quanh bộ quy tắc:

1. Nhiều agent target: Claude Code, Codex, Cursor, Gemini CLI và các harness theo chuẩn agent-skills đều được xem như người dùng hạng nhất.
2. Kích hoạt rõ ràng: Trong Claude Code, skill tắt cho đến khi bạn gõ /i-have-adhd, nên nó không âm thầm đổi hình dạng session ngoài ý muốn.
3. Có chế độ always-on: Nếu bộ quy tắc hợp với não bạn, cờ ~/.claude/.i-have-adhd-always biến nó thành hành vi mặc định.
4. Có lối thoát khỏi quy tắc: Hành động phá hủy, câu hỏi mơ hồ, giải thích sâu, và vòng debug đều có quyền ghi đè câu trả lời siêu ngắn.
5. Có evals: Repo có harness để kiểm tra agent có thật sự làm theo quy tắc không, thay vì chỉ README nghe hay.

Chi tiết cuối cùng rất quan trọng. Viết style guide giao tiếp thì dễ. Viết style guide có thể kiểm thử được thì khó giả hơn nhiều.

10 Quy Tắc Giải Thích Rõ Ràng

Toàn văn nằm trong SKILL.md. Đây là tóm tắt bằng ngôn ngữ thông thường:

Quy tắc 1 — Dẫn bằng hành động tiếp theo.
Dòng đầu tiên của mỗi phản hồi là thứ bạn có thể làm ngay. Không phải bối cảnh. Không phải kế hoạch. Hành động. Nếu câu trả lời là một lệnh, nó lên dòng đầu tiên.

Quy tắc 2 — Đánh số tác vụ nhiều bước.
Nếu công việc cần hơn một bước, nó được đánh số. Mỗi mục là một hành động có phạm vi rõ. Không có bước nào chứa “rồi thì” hai lần.

Quy tắc 3 — Kết thúc bằng một bước tiếp theo cụ thể.
Nếu còn điều gì đó mở, nêu đúng một việc có thể làm trong dưới hai phút. “Chạy npm test” được tính. “Cho tôi biết nếu bạn cần thêm” thì không.

Quy tắc 4 — Chặn lan man.
Nếu vấn đề thứ hai xuất hiện, kết thúc vấn đề thứ nhất rồi đề xuất vấn đề thứ hai như một câu hỏi tách biệt. Một luồng một lúc.

Quy tắc 5 — Nêu lại trạng thái mỗi lượt.
Bạn không thể giữ “chúng ta đang ở bước 3 của 5” giữa các tin nhắn. Agent nêu lại nó. Mỗi lượt.

Quy tắc 6 — Ước tính thời gian cụ thể.
“Khoảng 15 phút nếu test đã cover. Một buổi chiều nếu chưa.” — không phải “cái này có thể mất một lúc.”

Quy tắc 7 — Làm rõ công việc đã hoàn thành.
Chỉ ra cái gì đang hoạt động, cụ thể. Không phải “Tôi đã thực hiện một số thay đổi.” — “Login hoạt động với magic links. Thử: npm run dev, mở /login.”

Quy tắc 8 — Giọng điệu bình tĩnh khi báo lỗi.
Không “Ôi không” hay “Có vẻ như đang có vấn đề.” Nêu nguyên nhân, nêu cách sửa.

Quy tắc 9 — Giới hạn danh sách 5 mục.
Nếu danh sách vượt quá năm, tách thành “làm ngay” và “để sau.” Năm mục được xếp hạng tốt hơn mười mục không xếp hạng.

Quy tắc 10 — Không rào đón, không tóm tắt lại, không lời kết xã giao.
Cấm mở bằng: “Câu hỏi hay đấy,” “Để tôi…”, “Tất nhiên!”, “Nhìn vào câu hỏi của bạn…”
Cấm kết thúc bằng: “Hy vọng điều này giúp ích,” “Báo tôi biết nếu bạn cần thêm.”

Khi Nào Quy Tắc Bị Ghi Đè (và Nên Như Vậy)

Skill định nghĩa rõ sáu trường hợp override:

1. Người dùng yêu cầu “giải thích” hoặc “hướng dẫn từng bước” — giải thích đầy đủ, nhưng vẫn không rào đón hay kết thúc xã giao
2. Hành động phá hủy sắp xảy ra — xác nhận trước khi làm, an toàn thắng ngắn gọn
3. Vòng debug sau ba lượt thất bại — dừng lặp code, đặt một câu hỏi chuẩn đoán
4. Câu hỏi thực sự mơ hồ — một câu hỏi làm rõ ngắn tốt hơn đoán và viết lại
5. Quy tắc sẽ xóa mất câu trả lời — nhiệm vụ thắng, hình dạng giữ nguyên
6. System prompt của harness outrank skill — tuân theo harness

Thiết Kế Ẩn: Không Phải “Cứ Ngắn Là Tốt”

Skill này thường được mô tả là thân thiện với ADHD, nhưng chi tiết quan trọng là nó không đơn giản bảo model viết ngắn.

Ngắn vẫn có thể vô dụng:

Thử kiểm tra environment variables của bạn.

Có thể hành động được thì tốt hơn:

printenv | grep -E "OPENAI|ANTHROPIC|GITHUB"

Sau đó agent nên nói kết quả đó nghĩa là gì và bước tiếp theo là gì. Mục tiêu không phải ít chữ bằng mọi giá. Mục tiêu là giảm ma sát khi thực thi.

---

Phần 3: Chẩn Đoán

So Sánh Trước và Sau: Ví Dụ Thực

README của repo cho thấy sự chuyển đổi rõ ràng. Đây là vài ví dụ cụ thể:

Demo 30 Giây

Tưởng tượng bạn hỏi agent: “Vì sao deploy của tôi fail?”

Câu trả lời AI mặc định thường bắt đầu kiểu này:

Có một vài lý do khiến deployment của bạn có thể thất bại.
Đầu tiên, hãy xem log và đảm bảo môi trường đã được cấu hình...

Câu đó không sai. Nó chỉ chậm để hành động.

Câu trả lời theo kiểu i-have-adhd nên bắt đầu gần như thế này:

Chạy `pnpm run build` local và paste dòng lỗi đầu tiên.

1. Nếu build fail local, sửa lỗi đó trước khi redeploy.
2. Nếu build pass local, kiểm tra deploy log xem thiếu env var không.
3. Nếu log báo frozen lockfile, chạy `pnpm install --no-frozen-lockfile`.

Cùng một chủ đề. Tư thế hoàn toàn khác. Phiên bản thứ hai cho tay bạn một việc để làm trước khi sự chú ý trôi mất.

Báo lỗi — Quy tắc 8:

Trước:
"Ôi không, có vẻ như đang có vấn đề với auth flow của bạn.
Có gì đó có vẻ không đúng..."

Sau:
"Test thất bại tại auth.spec.ts:42 — expected 200, got 401.
Nguyên nhân: thiếu header Authorization.
Sửa: thêm `Authorization: Bearer ${token}` vào request."

Tác vụ nhiều bước — Quy tắc 2:

Trước:
"Đầu tiên bạn muốn mở file, sau đó tìm hàm,
thay nó bằng phiên bản mới, và sau đó chạy test."

Sau:
1. Mở src/auth.ts
2. Thay verifyToken (dòng 42–58) bằng đoạn code dưới đây
3. Chạy npm test -- auth.spec.ts

Theo dõi tiến độ — Quy tắc 5:

Trước:
"Xong. Sẵn sàng cho phần tiếp theo chưa?"

Sau:
"Bước 3 của 5 xong: schema đã cập nhật.
Tiếp theo: backfill cột mới. Chạy script không?"

Mỗi ví dụ là cùng một thông tin. Hình dạng hoàn toàn khác. Phiên bản “Sau” có thể scan mà không cần đọc từng từ.

Khi Nào i-have-adhd Không Phải Công Cụ Phù Hợp

Cần thành thật về giới hạn:

• Nó không thay đổi kiến thức hay năng lực của model. Câu trả lời sai được trình bày action-first vẫn là câu trả lời sai.
• Nó không giúp ích cho tác vụ mà bối cảnh phong phú và khám phá là mục tiêu — nghiên cứu, brainstorm kiến trúc, tư duy mở. Những tác vụ đó được lợi từ văn xuôi mở rộng hơn.
• Nó không làm phản hồi dài thành ngắn. Nó làm phản hồi có thể scan được. Đây là hai điều khác nhau.
• Trong Claude Code, skill tắt theo mặc định. Bạn phải gọi /i-have-adhd mỗi session trừ khi cài hook always-on.

Cách dùng sạch nhất không phải “ép mọi câu trả lời phải thật ngắn.” Cách dùng sạch nhất là: bật nó khi bạn đang thực thi, debug, install, ship, hoặc phục hồi sau lỗi. Tắt nó khi bạn muốn khám phá dài hơi.

---

Phần 4: Cách Triển Khai

Cài Trên Claude Code (2 phút)

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

Khởi động lại Claude Code. Sau đó gõ /i-have-adhd để bật cho session hiện tại.

Để bật always-on (mỗi session, không cần gõ /i-have-adhd):

touch ~/.claude/.i-have-adhd-always

Hook SessionStart đọc cờ này và tải bộ quy tắc đầy đủ từ tin nhắn đầu tiên.

Nên Chọn Cách Cài Nào?

Nếu bạn dùng	Bắt đầu ở đây	Vì sao
Claude Code	Plugin marketplace + /i-have-adhd	Đường dẫn được hỗ trợ tốt nhất và dễ bật/tắt
Claude Code hằng ngày	Thêm ~/.claude/.i-have-adhd-always	Tự động áp dụng qua các session
Cursor	npx skills add ayghri/i-have-adhd	Đi theo convention thư mục skills của Cursor
Copilot trong VS Code	Đưa quy tắc vào Copilot instructions	Copilot không dùng trực tiếp Claude plugin
Fork của riêng bạn	Sửa SKILL.md rồi cài fork	Phù hợp khi muốn chỉnh wording hoặc giới hạn

Cài Trên Cursor

npx skills add ayghri/i-have-adhd

Khởi động lại Cursor. Skill được index khi bắt đầu session.

Cài Trên Codex

codex plugin install ayghri/i-have-adhd

Hoặc làm theo hướng dẫn chi tiết trong INSTALL.md.

Cài Trên Gemini CLI

Thêm đoạn always-on từ INSTALL.md vào system prompt Gemini của bạn, hoặc dùng đường dẫn cài extension:

gemini extension install ayghri/i-have-adhd

Cài Trên GitHub Copilot (VS Code / Copilot CLI)

Sao chép nội dung của skills/i-have-adhd/SKILL.md và dán vào file hướng dẫn Copilot của bạn (.github/copilot-instructions.md trong repo, hoặc file hướng dẫn cấp người dùng trong cài đặt VS Code). Các quy tắc có hiệu lực ngay ở cuộc trò chuyện tiếp theo.

Tùy Chỉnh Quy Tắc

Nếu quy tắc nào không phù hợp với workflow của bạn, fork repo, chỉnh sửa skills/i-have-adhd/SKILL.md, và cài fork của mình:

claude plugin uninstall i-have-adhd
claude plugin marketplace remove i-have-adhd
claude plugin marketplace add <tên-của-bạn>/i-have-adhd
claude plugin install i-have-adhd@i-have-adhd

Các quy tắc được viết bằng ngôn ngữ tự nhiên (tiếng Anh thuần). Bạn không cần hiểu code để thay đổi chúng.

Prompt Đầu Tiên Nên Thử Sau Khi Cài

Đừng test bằng một câu hỏi triết học mơ hồ. Hãy test bằng một điểm đau thật.

/i-have-adhd
Build của tôi đang fail. Hãy cho tôi lệnh đầu tiên cần chạy, rồi tối đa 3 bước tiếp theo.

Bạn sẽ thấy giá trị ngay: ít câu khởi động hơn, thứ tự rõ hơn, và một hành động tiếp theo thay vì một màn sương các khả năng.

---

Kết luận

i-have-adhd là một trong những công cụ nhìn qua gần như quá đơn giản khi đọc source: mười quy tắc trong một file Markdown. Không build step. Không mê cung dependency.

Vậy mà 14.000 developer đã star nó. Điều đó không phải ngẫu nhiên.

Insight đằng sau dự án không mới: giao tiếp kỹ thuật tốt dẫn bằng câu trả lời, đánh số các bước, nêu rõ trạng thái, và dừng nói khi xong. Điều mới là repo này làm cho hành vi đó có thể cài đặt được — một lệnh, một lần kích hoạt, mọi agent.

Cách đặt tên theo ADHD là trung thực và chính xác. Nó mô tả những gì các quy tắc tối ưu hóa: giới hạn bộ nhớ làm việc, ma sát giữa hiểu và hành động, chi phí của ước tính thời gian mơ hồ. Những giới hạn đó áp dụng với hầu hết mọi người trong công việc tập trung, không chỉ những người có chẩn đoán.

Bài học viral lớn hơn repo này: chất lượng model là chưa đủ. Câu trả lời cũng cần đúng hình dạng. Trong developer tools, hình dạng không phải trang trí. Hình dạng quyết định người dùng có thể tiếp tục di chuyển hay không.

Nếu bạn đã từng kéo qua ba đoạn văn để tìm một lệnh, đây là thứ đáng thử ngay hôm nay.

Cài đặt: github.com/ayghri/i-have-adhd