symfony-hexagonal-skill

为什么要用

核心特性

10 auto-triggered skills for Symfony patterns
2 review agents that catch layering violations
Supports progressive refactor of existing codebases
Templates for Domain, Application, Infrastructure layers
DTO / Command / Query patterns baked in

实时演示

实际使用效果

symfony-hexagonal-skill.replay ▶ 就绪

0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： symfony-hexagonal-skill

Scaffold a new bounded context with hexagonal layers

👤 Symfony devs building non-trivial domain logic ⏱ ~60 min advanced

何时使用： You're starting a new feature and want the layering right from day one.

步骤

Name the context

Use symfony-hexagonal-skill. Scaffold a 'Billing' bounded context with Invoice aggregate, issue/void commands, and a query for open invoices.✓ 已复制

→ src/Billing/Domain, Application, Infrastructure folders with proper separation
Wire the infrastructure

Add a Doctrine adapter for InvoiceRepository behind the domain port.✓ 已复制

→ Interface in Domain, implementation in Infrastructure, services.yaml binding
Expose via controller

Add an HTTP adapter with a POST /invoices endpoint that dispatches the IssueInvoice command.✓ 已复制

→ Controller calls bus, not repository directly

结果： A clean bounded context that won't turn into spaghetti in 6 months.

注意事项

Domain depending on Doctrine annotations — Use XML / attribute mapping in Infrastructure, not on domain entities

搭配使用： filesystem

Review a PR for hexagonal layering violations

👤 Tech leads on Symfony teams ⏱ ~20 min intermediate

何时使用： Reviewing a PR and you want an automated first-pass on layering.

步骤

Run the review agent

Use symfony-hexagonal-skill review agent on this diff. Flag any Doctrine / Symfony FW imports in Domain/, any controller->repository direct calls, any ORM leakage into responses.✓ 已复制

→ Concrete findings with file+line
Suggest fixes

For each finding, propose the minimal refactor.✓ 已复制

→ Diffs introducing a port or DTO

结果： A PR that doesn't silently degrade the architecture.

搭配使用： github

Progressively refactor an existing Symfony app toward hexagonal

👤 Teams with a legacy Symfony project ⏱ ~120 min advanced

何时使用： Big-bang rewrite is off the table; you want incremental cleanup.

步骤

Identify a seam

Use symfony-hexagonal-skill. Look at src/Module/Orders — what's the smallest slice I can lift into a clean domain?✓ 已复制

→ Specific class identified with extraction plan
Extract incrementally

Walk me through the extraction in 3 PR-sized steps.✓ 已复制

→ Staged plan with tests preserved at each step

结果： A legacy codebase getting better, one PR at a time.

注意事项

Extracting too much in one step — PR-sized slices only; the plugin's review agent helps gate each step

搭配使用： git

组合

与其他 MCP 搭配，撬动十倍杠杆

symfony-hexagonal-skill + github

Gate PRs on layering review before merge

Run the hex review on the open PR in this repo and post findings as comments.✓ 已复制

symfony-hexagonal-skill + filesystem

Apply scaffolds into the actual repo

Apply the context scaffold to my project under src/.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
context_scaffold	context name, aggregates	New bounded context
port_adapter_pair	port interface name, adapter type	Adding infrastructure
layering_review	diff or directory	Pre-merge
refactor_plan	legacy module	Starting a cleanup

成本与限制

运行它的成本

API 配额: None
每次调用 Token 数: Moderate — reviews scan files
费用: Free
提示: Scope reviews to the diff, not whole repos, to save tokens.

安全

权限、密钥、影响范围

凭据存储： None

数据出站： None from skill

故障排查

常见错误与修复

Review agent misses violations

Ensure the full diff is in context; very large diffs may need chunking

Scaffold produces old Symfony 5 style

Mention your Symfony version explicitly — 6 vs 7 conventions differ

替代方案