Claude Code hook

AI Max

一键给Claude Code 提高智商,包含生产级 agents、skills、hooks、commands、rules 和 MCP 配置

334 stars 37 forksHooks Source

Install

Install
npm install -g aimax

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/zhukunpenglinyutong/ai-max.git

From the README

AI MAX
这是基于 everything-claude-code 进行二次开发,提供npm一键安装方式,协议沿用MIT

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

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

快速开始

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,它会根据你的描述自动选择最合适的指令。

/aimax:plan - 实现规划

在编写代码之前创建详细的实现计划。适用于:
- 新功能开发
- 重大架构变更
- 复杂重构工作

AI 会分析需求、识别风险、创建分步计划,并等待你确认后才开始编码。

/aimax:tdd - 测试驱动开发

强制执行 TDD 工作流:先写测试,再写实现。适用于:
- 新功能实现
- Bug 修复
- 关键业务逻辑

遵循 红-绿-重构 循环,确保 80% 以上测试覆盖率。

/aimax:code-review - 代码审查

对未提交的更改进行全面审查,检查:
- 🔴 安全问题(凭证泄露、SQL 注入、XSS)
- 🟠 代码质量(函数过长、嵌套过深)
- 🟡 最佳实践(可变模式、缺少测试)

/aimax:build-fix - 构建错误修复

快速修复构建和类型错误。适用于:
- TypeScript 类型错误
- 编译失败
- 构建流程问题

/aimax:e2e - 端到端测试

使用 Playwright 生成和运行 E2E 测试。适用于:
- 用户流程测试
- 跨页面功能验证
- UI 自动化测试

/aimax:test-coverage - 覆盖率分析

分析测试覆盖率,识别未覆盖的代码。

/aimax:refactor-clean - 重构清理

移除死代码、优化结构、消除重复。

/aimax:update-docs - 文档更新

更新项目文档、README、API 文档。

/aimax:update-codemaps - 架构图更新

生成或更新代码架构图和模块依赖图。

推荐工作流

核心概念

Agents(代理)

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

Skills(技能)

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

Hooks(钩子)

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

Rules(规则)

规则是必须始终遵循的准则。保持模块化:

重要说明

上下文窗口管理

关键: 不要同时启用所有 MCP。启用太多工具可能会使你的 200k 上下文窗口缩小到 70k。

经验法则:
- 配置 20-30 个 MCP
- 每个项目启用不超过 10 个
- 活动工具不超过 80 个

在项目配置中使用 disabledMcpServers 禁用未使用的工具。

定制化

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

仓库内容

许可证

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

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

How hooks work

  • Hooks are shell commands Claude Code runs at fixed points: before or after a tool call, when you submit a prompt, when Claude stops, on notifications and at session start.
  • They are set in the hooks section of ~/.claude/settings.json (or .claude/settings.json for a project), or come bundled in a plugin.
  • A hook can block a tool call, add context, or run a formatter or test. Read the scripts before you install them: they run on your machine with your permissions.
Claude Code docs

Details

Type
Hooks
Language
JavaScript
License
MIT
Last updated
11 February 2026

FAQ

What is AI Max?

一键给Claude Code 提高智商,包含生产级 agents、skills、hooks、commands、rules 和 MCP 配置 It is a hook for Claude Code, from zhukunpenglinyutong/ai-max on GitHub.

How do I install AI Max?

Run npm install -g aimax, then follow the setup in the README.

Is AI Max popular?

zhukunpenglinyutong/ai-max has 334 GitHub stars and 37 forks. It was last updated on 11 February 2026.

More hooks

Browse the most popular Claude Code mods, all hooks, or the skills and MCP server directories.