Software Dev AI Claude Toolkit

软件开发AI克劳德工具包

面向后端繁重的全栈开发人员的生产就绪Claude代码配置。预配置规则、斜线命令、代理、技能、钩子和MCP服务器——涵盖Java 17+Spring Boot 3、Python 3.12+FastAPI、JavaScript（Express.js+React）、PostgreSQL、MongoDB、Redis、Kafka、Flink、Docker、Kubernetes和AI/ML工作流。

把它放进去，运行安装程序，Claude Code会立即理解你的堆栈，执行你的标准，并按照你的工作方式工作。

这是给谁的

• 使用Java/Spring Boot、Python/FastAPI或Node.js/Express的后端开发人员
• 同时接触React前端的全栈开发人员
• 使用PostgreSQL、MongoDB、Redis、Kafka或Flink的工程师
• 任何构建AI/ML管道（RAG、代理、MCP服务器、矢量数据库）的人
• 希望Claude Code遵循真正的工程标准，而不是通用默认值的开发人员

里面有什么

总计：46个组件 共同努力，让Claude Code表现得像你团队中的高级工程师。

之前vs之后

之前（香草克劳德代码）

You: "Add a user registration endpoint"

Claude: *generates a basic endpoint with no validation, no error handling,
        uses field injection, no tests, hardcoded values, no consideration
        for your existing project patterns*

之后（使用此工具包）

You: "Add a user registration endpoint"

Claude: *reads your project's CLAUDE.md, follows your naming conventions,
        uses constructor injection, adds @Valid with proper DTOs, writes
        Flyway migration, includes unit + integration tests with Testcontainers,
        uses your custom exception hierarchy, follows your git commit format,
        and warns you about the missing rate limiter*

区别不是魔法，而是背景。这个工具包为Claude Code提供了与加入团队的新开发人员相同的上下文。

______________________________________________________________________

快速安装

Mac/Linux

git clone https://github.com/AshfaqSy/software-dev-ai-claude-toolkit.git
cd software-dev-ai-claude-toolkit
chmod +x install.sh
./install.sh

Windows（PowerShell）

git clone https://github.com/AshfaqSy/software-dev-ai-claude-toolkit.git
cd software-dev-ai-claude-toolkit
.\install.ps1

安装程序：

• 将所有组件复制到 ~/.claude/
• 在覆盖之前备份现有文件
• 将钩子合并到现有钩子中 settings.json
• 跳跃 CLAUDE.md 如果你已经有一个（不会覆盖你的个人配置）

手动安装

如果您喜欢挑选，请将单个文件夹复制到 ~/.claude/:

~/.claude/
  rules/        绿色（代码最少）->改进（重构）。 |
| `/build-fix` |逐步修复一个构建错误，直到构建成功。 |
| `/api-design` |使用请求/响应模式、错误格式和数据模型设计REST API端点。 |
| `/docker-setup` |通过检测您的项目堆栈来生成Dockerfile、docker-compose.yml和.dockergignore。 |
| `/system-design` |浏览系统设计：需求、架构、数据设计、API、可扩展性、可靠性。 |
| `/db-schema` |设计数据库模式：识别实体，选择正确的数据库，定义表/集合，计划迁移。 |

### 示例：使用 `/plan`

You: /plan Add order cancellation with inventory rollback

Claude:

Implementation Plan: Order Cancellation

Phase 1: Domain Changes

• Add CANCELLED to OrderStatus enum
• Add CancellationReason value object
• New Flyway migration V6__add_cancellation_fields.sql

Phase 2: Service Layer

• OrderCancellationService with rollback logic
• InventoryService.rollback(orderId) method
• Kafka event: orders.order.cancelled

Phase 3: API

• POST /api/v1/orders/{id}/cancel
• CancelOrderRequest record with reason field

Phase 4: Tests

• Unit: cancellation service, inventory rollback
• Integration: full cancel flow with Testcontainers
• Edge cases: already cancelled, already shipped

Risks

• Race condition: order shipped while cancellation in progress
• Partial rollback if inventory service fails mid-operation

Estimated Complexity: Medium

Files affected: 8 | New files: 3 | Migration: Yes

______________________________________________________________________

## 代理人（5名代理人）

代理是专门的人工智能角色，具有自己的系统提示、工具和推理模型。它们比斜线命令处理更深入的分析。

|Agent | Model |它的作用|
|-------|-------|--------------|
| `planner` |Sonnet |分析需求，读取现有模式，确定要更改的文件，制定分阶段实施计划。从不写代码。 |
| `code-reviewer` |Sonnet |扫描最近的更改，查找错误、逻辑错误、样式违规和堆栈特定的反模式。按严重程度分类。 |
| `security-reviewer` |Opus|检查代码是否存在硬编码的秘密、SQL注入、缺少身份验证检查、XSS、CSRF和堆栈特定的漏洞。 |
| `architect` |Opus |系统设计和架构决策。分析选项，解释权衡，推荐服务和技术选择的模式。 |
| `tdd-guide` |Sonnet | TDD教练，确保测试优先开发。指导完成红/绿/改善循环。在测试存在之前阻止实现。 |

### 代理与命令有何不同

命令是脚本，它们遵循固定的工作流程。代理人是思想家——他们分析你的具体情况，调整他们的方法，并提供细致入微的反馈。使用命令执行常规任务，使用代理执行需要判断的决策。

______________________________________________________________________

## 技能（13个技能包）

技能是深层次的领域知识包，可以在上下文中激活。当Claude检测到您正在进行Spring Boot项目时，相关技能会自动加载，以提供模式、示例和最佳实践。

|技能|领域|它提供了什么|
|-------|--------|-----------------|
| `springboot-patterns` |Java/Spring|RESTneneneba API设计、分层架构、缓存、异步处理、日志记录模式|
| `springboot-security` |Java/Spring|Auth/authz、验证、CSRF、机密、安全标头、速率限制|
| `springboot-tdd` |Java/Spring|JUnit5、Mockito、MockMvc、测试容器、JaCoCo覆盖模式|
| `java-coding-standards` |Java | Java 17习语、记录、密封类、模式匹配、可选用法|
| `jpa-patterns` |Java/DB|实体设计、关系、查询优化、事务、审计、分页|
| `postgres-patterns` |数据库|查询优化、模式设计、索引策略、安全最佳实践|
| `python-patterns` |Python | Python习语、PEP 8、类型提示、数据类、最佳实践|
| `python-testing` |Python|pytest，TDD方法，夹具，模拟，参数化，覆盖率|
| `frontend-patterns` |React/JS | React模式、状态管理、性能优化、UI最佳实践|
| `backend-patterns` |Node.js|neneneba API设计、数据库优化、Express/Next.js的服务器端模式|
| `iterative-retrieval` |AI/Agents |渐进式上下文检索用于解决RAG系统中的子代理上下文问题|
| `eval-harness` |AI/Dev |评估驱动开发（EDD）框架——在实施之前定义成功标准|
| `security-review` |安全|全面的安全检查表：机密、输入验证、SQLi、XSS、CSRF、身份验证|

______________________________________________________________________

## 挂钩（4个挂钩）

钩子是克劳德使用工具之前或之后运行的自动护栏。它们可以实时捕捉错误，而无需您记住进行检查。

### 预工具挂钩（执行前运行）

|钩子|触发器|动作|
|------|---------|--------|
|阻止危险命令| `git push --force`, `git reset --hard`, `rm -rf` | **阻止执行** 带有错误信息|
|Git推送提醒|任何 `git push` |警告先审查更改|

### Post Tool Hooks（在文件编辑后运行）

|钩子|触发器|动作|
|------|---------|--------|
|Java：System.out.println |编辑 `.java` files |警告并建议SLF4J记录器|
|Java:@Autowired |编辑 `.java` files |警告并建议构造函数注入|
|Python：print（）|编辑 `.py` files |警告并建议日志记录模块|
|JS/TS:console.log |编辑 `.js/.jsx/.ts/.tsx` 文件|提交前警告并建议删除|

这些钩子会自动运行。你不用召唤他们，他们会默默地保护你。

______________________________________________________________________

## MCP服务器（4台服务器）

MCP（模型上下文协议）服务器通过外部工具功能扩展了Claude Code。

|服务器|功能|成本|
|--------|-------------|------|
| `context7` |查找库文档。解析为最新文档，而不是过时的训练数据。|免费|
| `memory` |跨会话的持久内存。记住项目决策、偏好和背景。|免费|
| `sequential-thinking` |逐步推理复杂问题。系统设计、调试、架构决策。|免费|
| `github` |GitHub集成——PR、问题、repos、代码搜索。|免费（需要代币）|

### 设置

安装后，编辑 `~/.claude/.mcp.json` 并替换 `` 带着一个  （如果你想集成GitHub）。

其他3台服务器无需配置即可开箱即用。

______________________________________________________________________

## 示例（3个模板）

|文件|它是什么|
|------|-----------|
| `examples/CLAUDE.md` |全局用户级配置。定义您的偏好、技术栈和规则链接。安装到 `~/.claude/CLAUDE.md`. |
| `examples/CLAUDE-TEMPLATE.md` |空白项目级模板。复制到您的项目根目录 `CLAUDE.md` 并填补空白。 |
| `examples/sample-springboot-CLAUDE.md` |已填写Spring Boot订单管理服务的示例。显示一个好的项目CLAUDE.md是什么样子的。 |

### CLAUDE.md系统

克劳德代码读取 `CLAUDE.md` 文件分为两个级别：

1. **全球** (`~/.claude/CLAUDE.md`)——你的个人喜好、技术栈、编码风格。为每个项目加载。
1. **项目** (`./CLAUDE.md` 在项目根中）——项目特定的上下文：如何运行、结构、关键决策、环境变量、不可触碰的内容。

全球配置告诉克劳德你是谁。项目配置告诉克劳德你正在做什么。他们一起给了克劳德完整的画面。

______________________________________________________________________

## 如何自定义

### 添加自己的规则

创建新 `.md` 归档 `~/.claude/rules/`:

My Custom Rule

Always

• Use tabs, not spaces
• Prefer composition over inheritance

### 添加您自己的斜线命令

创建新 `.md` 归档 `~/.claude/commands/`:

My Custom Command

When I invoke this command:

1. Do step one
2. Do step two
3. Return the result in this format

### 修改现有组件

每个文件都是纯Markdown。打开它，编辑它，保存它。更改将在下一个Claude Code会话中生效。

### 删除不需要的组件

删除文件。如果你不使用Python，请删除 `python-backend-ai.md` 从规则和 `python-patterns/` 和 `python-testing/` 从技能。

______________________________________________________________________

## 存储库结构

software-dev-ai-claude-toolkit/ ├── README.md ├── LICENSE # MIT ├── .gitignore │ ├── rules/ # 9 always-on coding standards │ ├── coding-style.md │ ├── java-springboot.md │ ├── python-backend-ai.md │ ├── javascript.md │ ├── databases.md │ ├── infra.md │ ├── git-workflow.md │ ├── testing.md │ └── security.md │ ├── commands/ # 8 slash commands │ ├── plan.md │ ├── code-review.md │ ├── tdd.md │ ├── build-fix.md │ ├── api-design.md │ ├── docker-setup.md │ ├── system-design.md │ └── db-schema.md │ ├── agents/ # 5 specialized AI agents │ ├── planner.md │ ├── code-reviewer.md │ ├── security-reviewer.md │ ├── architect.md │ └── tdd-guide.md │ ├── hooks/ # Automated guardrails │ └── settings.json │ ├── mcp/ # MCP server configs │ └── mcp-servers.json │ ├── skills/ # 13 domain knowledge packs │ ├── springboot-patterns/ │ ├── springboot-security/ │ ├── springboot-tdd/ │ ├── java-coding-standards/ │ ├── jpa-patterns/ │ ├── postgres-patterns/ │ ├── python-patterns/ │ ├── python-testing/ │ ├── frontend-patterns/ │ ├── backend-patterns/ │ ├── iterative-retrieval/ │ ├── eval-harness/ │ └── security-review/ │ ├── examples/ # Templates and examples │ ├── CLAUDE.md │ ├── CLAUDE-TEMPLATE.md │ └── sample-springboot-CLAUDE.md │ ├── install.sh # Mac/Linux installer └── install.ps1 # Windows installer

______________________________________________________________________

## 学分

基于以下模式构建：

- [一切克劳德代码](https://github.com/anthropics/everything-claude-code) --Anthropic官方收集的Claude Code配置、技能和社区模式
- [Claude代码文档](https://docs.anthropic.com/en/docs/claude-code) --规则、命令、代理、钩子、MCP和技能的官方文件

## 许可证

麻省理工学院——使用它，分叉它，修改它，分享它。