aimax

AI MAX

声明：本项目经AI编辑，非原创，不过都是我本人正在使用的，非佬勿6，还会持续迭代

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

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

快速开始

# 全局安装
npm install -g aimax

# 然后直接使用
aimax                    # 交互式安装
aimax install            # 安装全部组件
aimax install -y         # 跳过确认直接安装
aimax update             # 更新到最新版本
aimax uninstall          # 卸载
aimax docs               # 打开使用文档
aimax -v                 # 查看版本号

或者使用 npx 临时运行（无需安装）：

npx aimax
npx aimax install

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     # 自定义状态栏配置

赞助支持

如果这个项目对你有帮助，欢迎赞助支持，你的支持是我持续维护的动力！

支付宝

微信

PayPal

赞助者列表

感谢以下赞助者的支持 ❤️

名称	金额	日期
虚位以待	-	-

无论多少金额，我会将你添加到赞助者列表中，感谢各位的支持

许可证

MIT - 自由使用，按需修改，如果可以请回馈贡献。

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