# AI MAX

> 这是基于 [everything-claude-code](https://github.com/affaan-m/everything-claude-code) 进行二次开发，提供npm一键安装方式，协议沿用MIT

**Claude Code 增强配置，开箱即用。**

本仓库包含生产级 agents（代理）、skills（技能）、hooks（钩子）、commands（命令）、rules（规则）和 MCP 配置，帮助你快速提升 Claude Code 的使用体验。

---

## 快速开始

```bash
# 全局安装
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（代理）

子代理以有限的范围处理委派的任务。示例：

```markdown
---
name: code-reviewer
description: 审查代码的质量、安全性和可维护性
tools: Read, Grep, Glob, Bash
model: opus
---

你是一位资深代码审查员...
```

### Skills（技能）

技能是由命令或代理调用的工作流定义：

```markdown
# TDD 工作流

1. 首先定义接口
2. 编写失败的测试（红灯）
3. 实现最少代码（绿灯）
4. 重构（改进）
5. 验证 80%+ 覆盖率
```

### Hooks（钩子）

Hooks 在工具事件时触发。示例 - 警告 console.log：

```json
{
  "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` 禁用未使用的工具。

### 定制化

这些配置适合我的工作流程。你应该：
1. 从与你产生共鸣的内容开始
2. 根据你的技术栈修改
3. 移除你不使用的内容
4. 添加你自己的模式

---

## 仓库内容

```
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 - 自由使用，按需修改，如果可以请回馈贡献。

---

**如果有帮助请给这个仓库点星。阅读指南。构建伟大的东西。**