symfony-hexagonal-skill MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

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

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "symfony-hexagonal-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aligundogdu/symfony-hexagonal-skill",
        "~/.claude/skills/symfony-hexagonal-skill"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "symfony-hexagonal-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aligundogdu/symfony-hexagonal-skill",
        "~/.claude/skills/symfony-hexagonal-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "symfony-hexagonal-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aligundogdu/symfony-hexagonal-skill",
        "~/.claude/skills/symfony-hexagonal-skill"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "symfony-hexagonal-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aligundogdu/symfony-hexagonal-skill",
        "~/.claude/skills/symfony-hexagonal-skill"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "symfony-hexagonal-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/aligundogdu/symfony-hexagonal-skill",
        "~/.claude/skills/symfony-hexagonal-skill"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "symfony-hexagonal-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/aligundogdu/symfony-hexagonal-skill",
          "~/.claude/skills/symfony-hexagonal-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add symfony-hexagonal-skill -- git clone https://github.com/aligundogdu/symfony-hexagonal-skill ~/.claude/skills/symfony-hexagonal-skill

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： 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.

前置条件

Symfony 6.x+ project — composer create-project symfony/skeleton
Skill installed — git clone https://github.com/aligundogdu/symfony-hexagonal-skill ~/.claude/skills/symfony-hexagonal-skill

步骤

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

替代方案

symfony-hexagonal-skill 对比其他方案

替代方案	何时用它替代	权衡
Deptrac static analysis	You want rule-based static enforcement of layering	No refactor help; purely gates violations
craftcms-claude-skill	You're on Craft CMS, not Symfony	Different framework

symfony-hexagonal-skill

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： symfony-hexagonal-skill

Scaffold a new bounded context with hexagonal layers

前置条件

步骤

注意事项

Review a PR for hexagonal layering violations

步骤

Progressively refactor an existing Symfony app toward hexagonal

步骤

注意事项

组合

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

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

symfony-hexagonal-skill 对比其他方案

更多

资源