Claude Code + PHP:一个拥有 300+ 组件的 AI 架构开发工具

Claude Code 为 PHP 开发提供了一整套工程化能力，包括架构审计（Architecture Audit）、领域驱动设计（DDD）、安全分析、性能分析、PSR 规范检查、设计模式分析、Docker 支持、CI/CD 管理、测试检查与文档分析等功能。

该工具集目前包含：

• 300+ 专用组件
• 50+ AI 代理（Agents）
• 200+ 技能模块（Skills）

这些组件共同构成了一个面向 PHP 架构开发的智能辅助系统。

人工智能辅助 PHP 开发的新阶段

近年来，AI 驱动的代码助手正在改变软件开发的方式。最初的 AI 编程工具主要用于代码自动补全，而如今，这类系统已经能够理解完整的代码上下文，并在更高层面参与开发过程，例如：

• 提供架构设计建议
• 发现潜在缺陷和安全问题
• 分析代码质量与结构
• 自动生成符合规范的代码

Claude Code 是这一领域中较为强大的工具之一。它通过命令行界面（CLI）将 Claude 的能力直接集成到开发者终端中，使 AI 能够参与日常开发流程。

然而，Claude Code 本身是一个通用型工具，并不了解具体项目的开发规范。例如：

• 项目是否采用 领域驱动设计（DDD）
• 团队是否遵循特定 PSR 标准
• 是否使用 微服务架构或熔断器机制

为了解决这一问题，Awesome Claude Code（ACC）为 Claude Code 提供了一套面向 PHP 架构开发的扩展组件，使其能够更深入地理解 PHP 项目的设计模式和工程实践。

开发中的常见问题

在 PHP 项目开发中，许多工作往往是重复性的。例如，当实现一个新功能时，开发者通常需要创建一整套结构化代码：

• 聚合根（Aggregate Root）
• 仓库接口（Repository Interface）
• 数据传输对象（DTO）
• 命令与查询处理器（Command / Query Handler）
• 单元测试

这些模式在项目中反复出现，但仍需要手动编写。

代码审查也面临类似问题。开发者需要逐行检查代码，以发现以下问题：

• SQL 注入风险
• N+1 查询
• 领域设计违规
• 测试覆盖不足

当项目规模扩大时，人工审查数千个文件不仅耗时，而且容易遗漏问题。

在遗留系统维护中，情况更加复杂。架构偏差、设计不一致以及性能问题往往分散在大量代码中，手动排查几乎不可行。

这些问题本质上属于可自动化处理的工程问题。

Awesome Claude Code 的解决方案

Awesome Claude Code（ACC） 是 Claude Code CLI 的增强插件，专门针对 PHP 架构开发进行优化。

安装后，开发者可以直接获得：

• 300+ PHP 架构组件
• 支持 DDD、CQRS、Clean Architecture、事件溯源
• Docker 与 CI/CD 自动化支持

插件会自动将命令、代理与技能模块复制到项目的 .claude/ 目录中，无需额外配置即可使用。

安装方式

通过插件市场安装

/plugin marketplace add dykyi-roman/awesome-claude-code
/plugin install acc@awesome-claude-code

通过 Composer 安装（旧版本）

composer require dykyi-roman/awesome-claude-code

升级插件

./vendor/bin/acc upgrade

智能代理与任务编排机制

ACC 的核心能力在于其 智能代理系统（Agent Orchestration）。

当开发者发出命令时，系统会自动分析任务，并选择合适的专业代理执行操作。例如：

/acc:code-review

系统会自动调度多个审查代理，包括：

• PSR 规范审查
• 测试质量分析
• Bug 检测
• 代码可读性分析
• 安全审计
• 性能优化
• DDD 架构检查

每个代理只使用自己所需的技能模块。例如：

• 安全代理使用 OWASP 安全技能库
• DDD 审计代理使用 领域设计知识库
• 架构代理使用 架构模式分析技能

这种机制形成了一个由多个专业 AI 组成的 专家协作系统。

技能体系：知识、分析与生成

1. 知识模块（Knowledge）

提供专业知识与最佳实践，例如：

• 设计模式使用原则
• 常见架构反模式
• PHP 开发规范

2. 分析模块（Analyzer）

用于检测具体问题，例如：

• N+1 查询
• SQL 注入
• 代码异味
• SOLID 原则违规

3. 生成模块（Generator）

用于自动生成代码，包括：

• 值对象
• 聚合
• 设计模式实现
• PSR 标准组件

这些代码模板均来源于实际项目实践，可直接用于生产环境。

代码审查系统：三级分析

ACC 的代码审查系统支持 三级分析模型。

/acc:code-review feature/payment high

审查层级包括：

基础层

• PSR-12 规范检查
• 测试质量评估

中级层

• 逻辑错误检测
• 空指针问题
• 命名与复杂度分析

高级层

• OWASP Top 10 安全检查
• N+1 查询
• 内存泄漏
• DDD 架构合规性

系统还会生成一个 任务匹配度评分，评估代码与原始需求之间的一致性，从而帮助发现功能范围扩散的问题。

自动化 Bug 修复系统

ACC 还提供完整的缺陷诊断与修复流程。

/acc:bug-fix "OrderService::process() 中的 NullPointerException"

处理流程包括：

1. 诊断：识别错误类型与根因
2. 生成修复方案：提供最小且安全的修改
3. 生成测试：自动创建回归测试
4. 验证修复：执行测试并输出结果

系统可以识别的错误类型包括：

• 逻辑错误
• 空指针异常
• 边界错误
• 竞态条件
• 资源泄漏
• SQL 注入
• 无限循环

架构审计引擎

ACC 提供全面的架构审计能力，可分析项目是否符合主流架构模式，包括：

结构架构

• 领域驱动设计（DDD）
• Clean Architecture
• 六边形架构
• 分层架构
• SOLID 与 GRASP 原则

行为模式

• CQRS
• 事件溯源
• 事件驱动架构
• GoF 行为模式

系统稳定性模式

• Saga
• Outbox
• 熔断器
• 重试机制
• 限流机制

系统会输出可执行的优化建议，并标注具体代码位置。

CI/CD 与 Docker 支持

ACC 还提供完整的 CI/CD 自动化能力。

    /acc:ci-setup
    /acc:ci-fix
    /acc:ci-optimize
    /acc:audit-ci

支持的 PHP 工具包括：

• PHPStan
• Psalm
• PHPUnit
• PHP CS Fixer

同时还内置 Docker 专家系统，可自动生成和优化：

• Dockerfile
• docker-compose
• 多阶段构建
• PHP 扩展配置
• OPcache 优化

代码生成能力

ACC 提供 50+ 架构组件生成器，支持自动生成：

DDD 组件

• 实体（Entity）
• 值对象（Value Object）
• 聚合（Aggregate）
• 仓库（Repository）
• 领域事件

CQRS 组件

• Command
• Query
• Handler
• Read Model

设计模式

• Strategy
• State
• Builder
• Adapter
• Facade
• Proxy
• Circuit Breaker
• Saga

PSR 标准组件

• PSR-3 日志
• PSR-6 / PSR-16 缓存
• PSR-7 / PSR-15 HTTP
• PSR-11 容器

与其他工具的关系

ACC 并不是替代现有 PHP 工具，而是对其进行补充。

工具

功能定位

PHPStan / Psalm

类型分析

Rector

批量代码重构

Deptrac

架构依赖检查

GitHub Copilot

通用 AI 编程助手

ACC 的定位是提供更高层级的能力，例如：

• 架构审计
• DDD / CQRS 支持
• 设计模式生成
• 自动化代码评审

总结

Awesome Claude Code 将 Claude Code 从一个通用 AI 编程助手，扩展为面向 PHP 架构开发的专业工具集。

它能够自动完成许多重复性的工程任务，例如：

• 样板代码生成
• 代码审查
• 架构分析
• CI/CD 配置

同时还能够在开发过程中持续提供架构与设计建议，从而帮助开发者构建更高质量的 PHP 项目。

项目地址

GitHub：https://github.com/dykyi-roman/awesome-claude-code