adhd

环境要求

• 已安装 Node.js 与 npm（需能使用 npx / npm 命令；README 未注明具体版本）
• 支持 skills 机制的编码智能体（Claude Code、Cursor、Antigravity、Codex、Cline、Gemini CLI、Windsur
• 如需作为库集成：一个 TypeScript/JavaScript 项目环境

安装与启动步骤

1. 1一键安装技能

   执行后会自动检测你本机使用的智能体并安装 ADHD 技能，无需手动指定平台。

   npx skills add UditAkhourii/adhd

   复制

2. 2显式调用技能

   安装完成后在智能体对话中显式调用；README 说明它也会在构想类意图上自动触发。

   /adhd "your problem"

   复制

3. 3安装 CLI（可选）

   想脱离智能体直接在终端使用，则全局安装 CLI 包 adhd-agent。

   npm install -g adhd-agent

   复制

4. 4运行 CLI 提问

   把要解决的问题作为第一个参数传入，终端会输出发散后的候选方案。

   adhd "design a rate limiter that survives a leader election"

   复制

5. 5带参数运行 CLI

   用 --frames 指定认知框架数、--ideas 指定想法数、--top 指定保留的最优分支数。

   adhd "name this function" --frames 3 --ideas 8 --top 2

   复制

6. 6作为库集成

   在项目中安装 adhd-agent，然后 import run 与 renderText，用参数对象调用 run 并渲染结果。

   npm install adhd-agent

   复制

7. 7调用库 API

   传入 problem、framesPerRun、topK，返回结果包含 shortlist、nonObviousPick、traps、deepened、clusters。

   import { run, renderText } from "adhd-agent";
   
   const result = await run({ problem: "How should we shard this queue under bursty load?", framesPerRun: 5, topK: 3 });
   console.log(renderText(result));

   复制

关键配置

如何确认成功

运行 adhd "your problem" 能打印出候选方案（含 shortlist 等结果）即成功；技能安装后可用 /adhd 正常调用。

常见问题

注意事项

• README 未给出 Node.js 版本要求，建议使用较新的 LTS 版本。
• API 完整参数说明见 documentation/api.md，更多安装细节见 documentation/install.md。
• 该技能设计用于对抗过早收敛，需并行多分支思考，耗时通常高于普通单链提问。