ayghri/i-have-adhd

Kết luận: partial · Công nghệ: prompt-engineering · ai-agent · developer-tools · productivity · output-formatting

ayghri/i-have-adhd là một skill cho coding agent nhằm ép đầu ra ngắn, rõ, đưa đáp án trước thay vì chôn trong giải thích dài dòng; rất hợp cho workflow lập trình cần tốc độ đọc và ra quyết định nhanh. Với ~6869 stars và đúng nhóm developer-tools/productivity, đây là một mẫu tối ưu prompt/agent behavior hơn là công nghệ lõi của ứng dụng.

📖 Giới thiệu chi tiết

🧩 Nó là gì?

ayghri/i-have-adhd là một “skill”/plugin giúp trợ lý lập trình như Claude Code hoặc Codex trả lời gọn, rõ, đi thẳng vào việc cần làm. Nó tạo kiểu phản hồi thân thiện với người dễ bị quá tải thông tin, nhưng không yêu cầu bạn phải có chẩn đoán ADHD.

🎯 Giải quyết vấn đề gì? Dành cho ai?

Dự án này giải quyết một vấn đề rất quen thuộc: trợ lý AI trả lời quá dài, nhiều lời dẫn, nhiều ý phụ, khiến người đọc phải “lọc” mới biết cần làm gì tiếp theo.

Nó phù hợp với:

• Người mới học lập trình muốn câu trả lời ngắn gọn, có bước làm rõ ràng.
• Lập trình viên đang debug và cần hành động ngay, không muốn đọc một đoạn giải thích dài.
• Người dễ mất tập trung khi câu trả lời có quá nhiều nhánh phụ.
• Nhóm muốn chuẩn hóa cách AI phản hồi: ít lan man, có bước tiếp theo cụ thể.

Ví dụ thay vì trả lời kiểu:

Great question! Let me think about this...

Nó hướng trợ lý trả lời kiểu:

Run `npm install jsonwebtoken@latest`, then edit `src/auth.ts:42`.

1. Open `src/auth.ts`
2. Replace `verifyToken` (lines 42–58) with the snippet below
3. Run `npm test -- auth.spec.ts`

Next: paste the first failing line if any test fails.

⚙️ Hoạt động ra sao?

Cơ chế chính của ayghri/i-have-adhd là thêm một bộ quy tắc trả lời cho coding assistant:

• Ưu tiên hành động trước: nói ngay việc cần làm, không mở đầu dài dòng.
• Nếu có nhiều bước, đánh số rõ ràng để người đọc làm lần lượt.
• Kết thúc bằng một bước tiếp theo cụ thể, thay vì câu chung chung như “Hope this helps!”.
• Cắt bớt ý phụ, tránh kéo người đọc sang nhiều hướng không cần thiết.
• Nhắc lại trạng thái công việc mỗi lượt để người dùng không bị mất mạch.
• Ước lượng thời gian bằng phút nếu cần, thay vì nói mơ hồ như “một chút”.
• Báo lỗi thẳng, bình tĩnh, tập trung vào cách sửa.
• Giới hạn danh sách tối đa 5 mục để dễ đọc.

Nói đơn giản: nó không thay đổi khả năng lập trình của AI, mà thay đổi cách AI trình bày câu trả lời sao cho dễ hành động hơn.

🆚 Khi nào nên dùng / không nên

Nên dùng khi:

• Bạn muốn câu trả lời ngắn, rõ, có bước làm ngay.
• Bạn dùng Claude Code, Codex hoặc coding agent tương tự trong công việc hằng ngày.
• Bạn thường thấy AI trả lời quá dài, nhiều lời xã giao hoặc nhiều giải thích phụ.
• Bạn đang debug, sửa lỗi, cài đặt, refactor và cần hướng dẫn thực tế.

Không nên dùng khi:

• Bạn muốn bài giảng dài, giải thích sâu từ nền tảng lý thuyết.
• Bạn đang cần brainstorm nhiều hướng sáng tạo, nhiều lựa chọn mở.
• Bạn thích câu trả lời có nhiều bối cảnh, ví dụ phụ và phân tích chi tiết.

So với cách dùng AI mặc định, i-have-adhd giống như bật “chế độ làm việc”: ít lời dẫn hơn, nhiều hành động cụ thể hơn.

🚀 Bắt đầu nhanh

Cài cho Claude Code:

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

Sau đó dùng lệnh:

/i-have-adhd

Cài cho Codex:

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

Sau đó dùng lệnh:

$i-have-adhd

Ví dụ tối thiểu khi dùng với Codex:

$i-have-adhd

Giúp tôi sửa lỗi test trong dự án này.

Ví dụ kiểu phản hồi bạn sẽ nhận được:

Run `npm test`, then paste the first failing test.

1. Open the terminal
2. Run `npm test`
3. Copy the first error block
4. Send it here

Next: paste the first failing line.

Với các coding agent khác, xem thêm file INSTALL.md trong repo.

✅ Điểm mạnh & ⚠️ Hạn chế

Điểm mạnh:

• Dễ đọc, dễ làm theo, đặc biệt với người mới.
• Giảm câu chữ xã giao và phần giải thích không cần thiết.
• Hợp với các việc cần hành động nhanh như debug, sửa lỗi, chạy test.
• Có quy tắc rõ ràng trong skills/i-have-adhd/SKILL.md, dễ xem và chỉnh.
• Có thể fork repo rồi sửa SKILL.md để phù hợp phong cách riêng.

Hạn chế:

• Không phải công cụ chẩn đoán hoặc điều trị ADHD.
• Không tự sửa code; nó chỉ định hình cách coding assistant trả lời.
• Có thể quá ngắn nếu bạn đang muốn học lý thuyết thật sâu.
• Hiệu quả phụ thuộc vào coding assistant bạn đang dùng.
• Với công cụ ngoài Claude Code và Codex, bạn cần xem hướng dẫn riêng trong INSTALL.md.