# ai-dandan **Repository Path**: httphickey/ai-dandan ## Basic Information - **Project Name**: ai-dandan - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 3 - **Forks**: 0 - **Created**: 2026-06-25 - **Last Updated**: 2026-06-25 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AI DANDAN > 一键增强 Claude Code 的能力套件：**融合 AI MAX 全套能力 + 阿里巴巴 Java 开发手册规约 + 「策划 → PRD → plan → 多 agent 协作开发」文档拆解工作流**。 AI DANDAN 是一个面向 Claude Code 的安装器（npm CLI）。它把一组精心设计的 **agents（子代理）、commands（斜杠命令）、rules（规则）、skills（技能）** 一键安装到你的 `~/.claude` 目录，让 Claude Code 在写代码、做规划、审查、测试时全程遵循统一规约与工作流。 --- ## 它是什么的组合 | 来源 | 带来的能力 | |------|-----------| | **AI MAX**（完整继承） | 9 个专业子 agent、10+ 斜杠命令、规则集、TDD/安全/E2E 等 skill、npm 安装/更新/卸载机制 | | **阿里巴巴 Java 开发手册（嵩山版）** | 完整 7 大维度规约（编程、异常日志、单测、安全、MySQL、工程结构、设计），写 Java 前自动加载 | | **文档拆解工作流**（本项目原创） | 全新功能自动拆解为 `策划方案.md → 产品PRD.md → plan.md`，再由多 agent 协作落地开发 | --- ## 快速开始 ### 安装 **方式一：本地开发（推荐）** ```bash # 1. 克隆或下载本项目 git clone <你的仓库地址> cd ai-dandan # 2. 安装依赖 npm install # 3. 创建全局符号链接（需要在 CMD 或 PowerShell 中执行，不能用 Git Bash） npm link # 4. 一键把所有组件装入 ~/.claude ai-dandan install # 或交互式菜单 ai-dandan ``` **方式二：从 npm 安装（待发布）** ```bash # 发布到 npm 后可用 npm install -g ai-dandan ai-dandan install ``` **注意**：如果项目路径包含中文字符，`npm link` 必须在 Windows 原生命令行（CMD 或 PowerShell）中执行，Git Bash 无法处理中文路径。 安装完成后 **重启 Claude Code**，即可使用 `/dandan:*` 系列斜杠命令。 ### 其他命令 ```bash ai-dandan install # 安装（-y 跳过确认，-f 强制覆盖） ai-dandan update # 更新到最新版本 ai-dandan uninstall # 卸载（仅删除本工具安装的文件，不影响其他插件） ai-dandan list # 列出可安装组件 ai-dandan docs # 打开文档 ai-dandan -v # 查看版本 ``` --- ## 核心：文档拆解工作流 这是 AI DANDAN 相对 AI MAX 最大的增量。当你提出一个**全新功能**时，不要一上来就写代码，而是分四步拆解： ``` /dandan:proposal ──► /dandan:prd ──► /dandan:plan ──► /dandan:dev 策划方案.md 产品PRD.md plan.md 多 agent 协作开发 （为什么/给谁） （做什么/字段/接口） （怎么做/技术拆解） （并行+串行落地+联调） ``` ### 智能判断：要不要走完整流程？ 你不需要自己判断。直接用 **智能路由**： ``` /dandan:auto 我想做一个会员积分商城 ``` `auto` 会先判断这是不是「**比较新的功能**」： - **全新功能模块**（新业务 + 新表 + 多接口/多端）→ 自动从 `/dandan:proposal` 启动完整文档拆解流程 - **轻量任务**（改 bug、加字段、调样式）→ 走捷径，直接 `/dandan:plan` 或 `/dandan:tdd`，**不浪费时间生成决策文档** 边界模糊时它会反问你一句确认。 ### 四步详解 1. **`/dandan:proposal`（策划方案）** 把一句话需求拆成 `docs/proposals/<功能名>/策划方案.md`：背景价值、目标用户、用户故事、MVP 范围、竞品参考、初步评估。**只产文档不写码**。 2. **`/dandan:prd`（产品 PRD）** 把策划方案细化成 `产品PRD.md`：功能清单、业务流程、交互细节、数据字段、接口约定、验收标准。 3. **`/dandan:plan`（技术计划）** 读 PRD，由 `planner` agent 产出 `plan.md`：技术实施步骤、模块归属、建表 SQL 位置、并行/串行依赖图。 4. **`/dandan:dev`（多 agent 协作开发）** 由 `feature-orchestrator` agent 读取 `plan.md`，把任务拆给多个专业子 agent： - **可并行批次**在单条消息内并行启动 - **强依赖任务**串行推进 - 开发完**自动触发** `code-reviewer` + `security-reviewer` 审查 - 最后**启动后端实测接口并贴出返回数据**（遵循项目 `CLAUDE.md` 要求） --- ## Java 规约自动加载 只要识别到将编写/修改 Java 代码（Controller、Service、Mapper、Entity、MyBatis、`@SaCheckPermission` 等），AI DANDAN 会**先加载 `java-development-manual` skill** 再动手，确保： - 命名规范（UpperCamelCase / lowerCamelCase / 常量全大写） - 异常处理（抛 `ServiceException`、不吞异常） - 日志规范（`@Slf4j` + 占位符 + 敏感脱敏） - MyBatis/MySQL（建表三字段、索引命名、禁止 `SELECT *`） - 并发安全（禁用 `Executors`、`ThreadLocal` 回收） - 安全（参数化查询、参数校验、UGC 内容审核） 详见 `skills/java-development-manual/`，按 7 个维度拆分为独立参考文档。 --- ## 完整命令清单 | 命令 | 用途 | 来源 | |------|------|------| | `/dandan:auto` | 智能路由：判断新功能 vs 轻量任务并分发 | 增强 | | `/dandan:proposal` | 生成策划方案.md | 原创 | | `/dandan:prd` | 生成产品PRD.md | 原创 | | `/dandan:plan` | 生成技术 plan.md（衔接 dev） | 增强 | | `/dandan:dev` | 多 agent 协作开发 + 审查 + 联调 | 原创 | | `/dandan:tdd` | 测试驱动开发（80%+ 覆盖率） | AI MAX | | `/dandan:code-review` | 代码质量与安全审查 | AI MAX | | `/dandan:build-fix` | 构建/类型错误修复 | AI MAX | | `/dandan:e2e` | Playwright 端到端测试 | AI MAX | | `/dandan:test-coverage` | 测试覆盖率分析 | AI MAX | | `/dandan:refactor-clean` | 重构与死代码清理 | AI MAX | | `/dandan:update-docs` | 文档更新 | AI MAX | | `/dandan:update-codemaps` | 代码架构图更新 | AI MAX | --- ## 子 Agent 清单 安装到 `~/.claude/agents/`： | Agent | 用途 | |-------|------| | `feature-orchestrator` | **多 agent 协作开发编排器**（原创核心） | | `planner` | 实现规划 | | `architect` | 系统架构设计 | | `tdd-guide` | 测试驱动开发 | | `code-reviewer` | 代码审查 | | `security-reviewer` | 安全分析 | | `build-error-resolver` | 构建错误修复 | | `e2e-runner` | E2E 测试 | | `refactor-cleaner` | 死代码清理 | | `doc-updater` | 文档更新 | --- ## 项目结构 ``` ai-dandan/ ├── bin/ │ └── cli.js # CLI 入口（install/update/uninstall/list/docs） ├── src/ │ ├── index.js # 交互模式与各命令逻辑 │ ├── installer.js # 安装/卸载核心（精确记录已装文件） │ ├── prompts.js # 交互提示与横幅 │ └── utils.js # 路径、版本、组件定义 ├── agents/ # 10 个子代理（含 feature-orchestrator） ├── commands/ # 13 个斜杠命令（含 proposal/prd/dev） ├── rules/ # 规则集（编码风格、安全、测试、git 等） ├── skills/ # 技能库 │ ├── java-development-manual/ # 阿里 Java 手册全套规约 │ ├── security-review/ │ └── tdd-workflow/ ├── hooks/ # hooks 配置示例 ├── mcp-configs/ # MCP 服务器配置示例 ├── examples/ # CLAUDE.md / statusline 示例 ├── tests/ # vitest 单元测试 ├── package.json ├── LICENSE └── README.md ``` 安装后落地到： ``` ~/.claude/ ├── agents/ ← agents/* ├── rules/ ← rules/* ├── commands/dandan/ ← commands/*（对应 /dandan:* 斜杠命令） └── skills/ ← skills/*（含 java-development-manual） ``` 版本与已安装文件记录在 `~/.claude/.ai-dandan-version`，卸载时据此**精确删除**，不会误删其他插件文件。 --- ## 典型使用场景 ### 场景一：从零做一个新功能 ``` /dandan:auto 给社区加一个「打卡签到」模块，每天签到得积分 → auto 判定为全新功能，启动： 1. /dandan:proposal 生成 策划方案.md（确认价值与 MVP） 2. /dandan:prd 生成 产品PRD.md（字段/接口/验收） 3. /dandan:plan 生成 plan.md（技术拆解 + 依赖图） 4. /dandan:dev 多 agent 并行开发 → 审查 → 后端实测接口 ``` ### 场景二：小修小补 ``` /dandan:auto 帖子详情接口少返回了作者头像，补一下 → auto 判定为轻量任务，直接 /dandan:plan（不生成策划/PRD），加载 Java 规约后实现 ``` ### 场景三：写完想审查 ``` /dandan:code-review → 调用 code-reviewer + security-reviewer，输出关键/高/中问题清单 ``` --- ## 开发与测试 ```bash npm install # 安装依赖 npm test # 运行单元测试 npm run test:coverage # 覆盖率报告 ``` --- ## 设计原则 - **不重复造轮子**：完整继承 AI MAX 经过验证的安装机制与 agent/command 体系 - **规约即护栏**：Java 代码强制走阿里手册，UGC 强制走内容审核（结合项目 CLAUDE.md） - **先想清再动手**：全新功能先拆文档，避免「写到一半发现方向错」 - **协作优于单干**：复杂功能由 orchestrator 调度多 agent 并行，效率与质量兼顾 - **轻重分流**：智能路由避免给小任务套用重流程 --- ## 致谢 - [AI MAX](https://github.com/zhukunpenglinyutong/ai-max) —— 安装机制与 agent/command 体系 - 《阿里巴巴 Java 开发手册（嵩山版）》—— Java 规约来源 ## License MIT