AI MAX
这是基于 everything-claude-code 进行二次开发，提供npm一键安装方式，协议沿用MIT
Claude Code 增强配置，开箱即用。
本仓库包含生产级 agents（代理）、skills（技能）、hooks（钩子）、commands（命令）、rules（规则）和 MCP 配置，帮助你快速提升 Claude Code 的使用体验。
快速开始
# 全局安装
npm install -g aimax
# 执行aimax，增强claude code智商
aimax # 终端执行aimax，进行交互式安装
# Claude Code 使用
/aimax:auto 你的问题 # 自动选择最优的aimax指令CLI 提供交互式界面，让你选择要安装的组件：
- Agents - 专用子代理（planner, architect, tdd-guide 等）
- Rules - 必须遵循的准则（security, testing, coding-style 等）
- Commands - 斜杠命令（/aimax:plan, /aimax:tdd, /aimax:code-review 等）
- Skills - 工作流定义和领域知识
斜杠指令使用指南
安装 AI MAX 后，你可以在 Claude Code 中使用以下斜杠指令。只需输入 /aimax:指令名 加上你的需求即可。
快速参考
| 指令 | 用途 | 示例 |
|---|---|---|
/aimax:auto | 智能选择最合适的指令 | /aimax:auto 帮我修复这个 bug |
/aimax:plan | 功能规划与实现方案 | /aimax:plan 添加用户登录功能 |
/aimax:tdd | 测试驱动开发 | /aimax:tdd 实现购物车功能 |
/aimax:code-review | 代码质量与安全审查 | /aimax:code-review |
/aimax:build-fix | 修复构建/类型错误 | /aimax:build-fix |
/aimax:e2e | 端到端测试生成 | /aimax:e2e 测试用户注册流程 |
/aimax:test-coverage | 测试覆盖率分析 | /aimax:test-coverage |
/aimax:refactor-clean | 代码重构与清理 | /aimax:refactor-clean 优化这个模块 |
/aimax:update-docs | 更新项目文档 | /aimax:update-docs |
/aimax:update-codemaps | 更新代码架构图 | /aimax:update-codemaps |
详细说明
/aimax:auto - 智能指令选择器
不确定用哪个指令？使用 /aimax:auto，它会根据你的描述自动选择最合适的指令。
/aimax:auto 我的构建失败了，有类型错误
→ 自动选择 /aimax:build-fix
/aimax:auto 帮我写个新功能
→ 自动选择 /aimax:plan
/aimax:auto 检查一下代码有没有安全问题
→ 自动选择 /aimax:code-review/aimax:plan - 实现规划
在编写代码之前创建详细的实现计划。适用于：
- 新功能开发
- 重大架构变更
- 复杂重构工作
/aimax:plan 添加实时通知功能AI 会分析需求、识别风险、创建分步计划，并等待你确认后才开始编码。
/aimax:tdd - 测试驱动开发
强制执行 TDD 工作流：先写测试，再写实现。适用于：
- 新功能实现
- Bug 修复
- 关键业务逻辑
/aimax:tdd 实现价格计算器遵循 红-绿-重构 循环，确保 80% 以上测试覆盖率。
/aimax:code-review - 代码审查
对未提交的更改进行全面审查，检查：
- 🔴 安全问题（凭证泄露、SQL 注入、XSS）
- 🟠 代码质量（函数过长、嵌套过深）
- 🟡 最佳实践（可变模式、缺少测试）
/aimax:code-review/aimax:build-fix - 构建错误修复
快速修复构建和类型错误。适用于：
- TypeScript 类型错误
- 编译失败
- 构建流程问题
/aimax:build-fix/aimax:e2e - 端到端测试
使用 Playwright 生成和运行 E2E 测试。适用于：
- 用户流程测试
- 跨页面功能验证
- UI 自动化测试
/aimax:e2e 测试用户登录到下单的完整流程/aimax:test-coverage - 覆盖率分析
分析测试覆盖率，识别未覆盖的代码。
/aimax:test-coverage/aimax:refactor-clean - 重构清理
移除死代码、优化结构、消除重复。
/aimax:refactor-clean 清理这个模块中未使用的代码/aimax:update-docs - 文档更新
更新项目文档、README、API 文档。
/aimax:update-docs/aimax:update-codemaps - 架构图更新
生成或更新代码架构图和模块依赖图。
/aimax:update-codemaps推荐工作流
1. /aimax:plan → 规划功能
2. /aimax:tdd → 测试驱动实现
3. /aimax:code-review → 审查代码
4. /aimax:build-fix → 修复构建问题（如有）
5. git commit → 提交代码核心概念
Agents（代理）
子代理以有限的范围处理委派的任务。示例：
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: Read, Grep, Glob, Bash
model: opus
---
你是一位资深代码审查员...Skills（技能）
技能是由命令或代理调用的工作流定义：
# TDD 工作流
1. 首先定义接口
2. 编写失败的测试（红灯）
3. 实现最少代码（绿灯）
4. 重构（改进）
5. 验证 80%+ 覆盖率Hooks（钩子）
Hooks 在工具事件时触发。示例 - 警告 console.log：
{
"matcher": "tool == \"Edit\" && tool_input.file_path matches \"\\\\.(ts|tsx|js|jsx)$\"",
"hooks": [{
"type": "command",
"command": "#!/bin/bash\ngrep -n 'console\\.log' \"$file_path\" && echo '[Hook] Remove console.log' >&2"
}]
}Rules（规则）
规则是必须始终遵循的准则。保持模块化：
~/.claude/rules/
security.md # 禁止硬编码密钥
coding-style.md # 不可变性、文件限制
testing.md # TDD、覆盖率要求重要说明
上下文窗口管理
关键： 不要同时启用所有 MCP。启用太多工具可能会使你的 200k 上下文窗口缩小到 70k。
经验法则：
- 配置 20-30 个 MCP
- 每个项目启用不超过 10 个
- 活动工具不超过 80 个
在项目配置中使用 disabledMcpServers 禁用未使用的工具。
定制化
这些配置适合我的工作流程。你应该：
- 从与你产生共鸣的内容开始
- 根据你的技术栈修改
- 移除你不使用的内容
- 添加你自己的模式
仓库内容
aimax/
|-- agents/ # 用于任务委派的专用子代理
| |-- planner.md # 功能实现规划
| |-- architect.md # 系统设计决策
| |-- tdd-guide.md # 测试驱动开发
| |-- code-reviewer.md # 质量和安全审查
| |-- security-reviewer.md # 漏洞分析
| |-- build-error-resolver.md
| |-- e2e-runner.md # Playwright E2E 测试
| |-- refactor-cleaner.md # 死代码清理
| |-- doc-updater.md # 文档同步
|
|-- skills/ # 工作流定义和领域知识
| |-- coding-standards.md # 编程语言最佳实践
| |-- backend-patterns.md # API、数据库、缓存模式
| |-- frontend-patterns.md # React、Next.js 模式
| |-- project-guidelines-example.md # 项目特定技能示例
| |-- tdd-workflow/ # TDD 方法论
| |-- security-review/ # 安全检查清单
| |-- clickhouse-io.md # ClickHouse 分析
|
|-- commands/ # 用于快速执行的斜杠命令
| |-- tdd.md # /aimax:tdd - 测试驱动开发
| |-- plan.md # /aimax:plan - 实现规划
| |-- e2e.md # /aimax:e2e - E2E 测试生成
| |-- code-review.md # /aimax:code-review - 质量审查
| |-- build-fix.md # /aimax:build-fix - 修复构建错误
| |-- refactor-clean.md # /aimax:refactor-clean - 死代码移除
| |-- test-coverage.md # /aimax:test-coverage - 覆盖率分析
| |-- update-codemaps.md # /aimax:update-codemaps - 刷新文档
| |-- update-docs.md # /aimax:update-docs - 同步文档
|
|-- rules/ # 必须遵循的准则
| |-- security.md # 强制性安全检查
| |-- coding-style.md # 不可变性、文件组织
| |-- testing.md # TDD、80% 覆盖率要求
| |-- git-workflow.md # 提交格式、PR 流程
| |-- agents.md # 何时委派给子代理
| |-- performance.md # 模型选择、上下文管理
| |-- patterns.md # API 响应格式、hooks
| |-- hooks.md # Hook 文档
|
|-- hooks/ # 基于触发器的自动化
| |-- hooks.json # PreToolUse、PostToolUse、Stop hooks
|
|-- mcp-configs/ # MCP 服务器配置
| |-- mcp-servers.json # GitHub、Supabase、Vercel、Railway 等
|
|-- plugins/ # 插件生态系统文档
| |-- README.md # 插件、市场、技能指南
|
|-- examples/ # 示例配置
|-- CLAUDE.md # 项目级配置示例
|-- user-CLAUDE.md # 用户级配置示例 (~/.claude/CLAUDE.md)
|-- statusline.json # 自定义状态栏配置许可证
MIT - 自由使用，按需修改，如果可以请回馈贡献。
如果有帮助请给这个仓库点星。阅读指南。构建伟大的东西。