大师技能库 ddtcorex/maestro-skills

Maestro Skills（maestro-skills）

面向 AI 编程智能体的统一技能库，打包成通用插件，支持 DeepSeek Harness（DSH）、Claude Code、Codex CLI、OpenCode 和 GitHub Copilot —— 一个包，两半内容：

- 领域技能 —— Govard 开发环境编排，以及它支持的 Web 框架（Magento 2、Laravel、Symfony、WordPress、通用 PHP）：架构、lint、性能审计、安全扫描、代码审查、Hyvä/Luma 前端、后端 API，外加 php-dev-core 和 diagram-studio。
- 流程技能 —— 完整的 superpowers 方法论，逐字 fork 自 v7.0.0（MIT，© Jesse Vincent）：头脑风暴、测试驱动开发、系统化调试、编写/执行计划、子代理驱动开发、代码审查协作、会话诊断等。许可证与同步策略见 THIRD-PARTY-NOTICES.md。

每个技能都遵循开放的 Agent Skills 标准（一个 SKILL.md 文件，带 name/description frontmatter），主流 AI Agent 工具都能识别。

搭配 Govard 效果最佳。 领域技能里多数命令示例都假设开发环境由 Govard 管理（govard sh -c "..."、govard tool magerun ...）—— 没有 Govard，你需要把它们改成自己的容器/命令行配置。一行安装：curl -fsSL https://raw.githubusercontent.com/ddtcorex/govard/master/install.sh | bash。

📂 目录结构

每个技能都放在 skills/<name>/SKILL.md 下 —— 这是所有支持的 AI 工具与平台共用的唯一事实来源：

maestro-skills/
├── README.md # Global documentation and guide
├── package.json # NPM package & DSH Cordis Plugin manifest (@ddtcorex/maestro-skills)
├── THIRD-PARTY-NOTICES.md # Superpowers fork attribution + MIT license text
├── scripts/
│ └── sync-superpowers.sh # Refresh the superpowers fork from upstream
├── tsconfig.json # TypeScript compiler configuration
├── src/ # DSH Cordis Plugin source code
│ ├── index.ts # Cordis plugin entrypoint: serves the packaged skills (the agent preset is a declaration row, see Installation)
│ └── dsh-types.d.ts # DSH type definitions
├── .dsh-plugin/ # DeepSeek Harness Agent Preset definition
│ ├── preset.yml # Web GUI preset display metadata ("Maestro Skills")
│ └── agent.cordis.yml # DSH Agent preset composition
├── .claude-plugin/ # Claude Code plugin manifests
├── .codex-plugin/ # Codex CLI plugin manifest
├── .agents/plugins/ # Codex marketplace manifest
│
└── skills/ # one folder per skill (ls skills is the source of truth)
├── 🧠 流程技能（fork 自 obra/superpowers v7.0.0） │ ├── brainstorming/ # 苏格拉底式设计打磨，带审批关卡 │ ├── diagnosing-superpowers/ # 诊断会话中出了什么问题 │ ├── test-driven-development/ # 红-绿-重构铁律 │ ├── systematic-debugging/ # 四阶段根因排查流程 │ ├── verification-before-completion/ # 先拿证据，再宣称成功 │ ├── writing-plans/ + executing-plans/ │ ├── subagent-driven-development/ + dispatching-parallel-agents/ │ ├── requesting/receiving-code-review/ │ ├── using-git-worktrees/ + finishing-a-development-branch/ │ ├── writing-skills/ # 如何编写新技能 │ └── using-superpowers/ # 技能系统介绍 │ ├── 📦 核心规范与架构 │ └── magento2-dev-core/ # Magento 2 核心准则（DI、仓库、安全） ├── 🛠️ 质量保障与审计 │ ├── magento2-linter/ # PHPCS、PHPStan、PHPMD 质量检查 │ ├── magento2-performance-audit/ # Web vitals、基础设施与数据库性能剖析 │ ├── magento2-security-scan/ # 静态漏洞代码扫描 │ └── magento2-code-review/ # PR/模块/主题/项目评审编排 ├── 🎨 前端与后端框架 │ ├── magento2-hyva-dev/ # Alpine.js、Tailwind CSS、CSP 支付页 │ ├── magento2-frontend-dev/ # Luma Knockout.js、LESS、RequireJS │ ├── magento2-backend-dev/ # REST、GraphQL resolver、Cron、队列 │ └── maestro-design/ # Tailwind + shadcn/ui 设计系统、a11y、Figma 转代码 ├── 🐘 PHP 基础 │ └── php-dev-core/ # PSR-12、Composer、PHPStan、框架无关的 PHP ├── 📐 图表 │ └── diagram-studio/ # Mermaid + 编辑级 HTML 图表，命令行校验器 └── 🔧 开发环境与命令行工具（Govard 技术栈） ├── govard-toolbox/ # 基础容器编排工具箱 ├── govard-magento/ # Magento 专用开发环境命令 ├── govard-laravel/ # Laravel 专用开发环境命令 ├── govard-symfony/ # Symfony 专用开发环境命令 ├── govard-wordpress/ # WordPress 专用开发环境命令 └── review-in-worktree/ # 在分离的评审 worktree 中运行 Govard 命令

🤖 技能兼容性矩阵

每个技能在下列所有工具上表现一致。

| 分组 | 技能 | Claude Code | Codex CLI | OpenCode | GitHub Copilot | DeepSeek Harness |
| Process（superpowers 分支） | brainstorming、diagnosing-superpowers、dispatching-parallel-agents、executing-plans、finishing-a-development-branch、receiving-code-review、requesting-code-review、subagent-driven-development、systematic-debugging、test-driven-development、using-git-worktrees、using-superpowers、verification-before-completion、writing-plans、writing-skills | ✅ | ✅ | ✅ | ✅ | ✅ |
| 核心与规范 | magento2-dev-core | ✅ | ✅ | ✅ | ✅ | ✅ |
| 检查与审计 | magento2-linter、magento2-performance-audit、magento2-security-scan、magento2-code-review | ✅ | ✅ | ✅ | ✅ | ✅ |
| 框架 | magento2-hyva-dev、magento2-frontend-dev、magento2-backend-dev、maestro-design | ✅ | ✅ | ✅ | ✅ | ✅ |
| 工具链（Govard） | govard-toolbox、govard-magento、govard-laravel、govard-symfony、govard-wordpress、review-in-worktree | ✅ | ✅ | ✅ | ✅ | ✅ |
| PHP 基础 | php-dev-core | ✅ | ✅ | ✅ | ✅ | ✅ |
| 图表 | diagram-studio | ✅ | ✅ | ✅ | ✅ | ✅ |

💾 安装

1. DeepSeek Harness（DSH）—— 作为插件安装（推荐）

一条命令就能装完 —— 插件自己提供打包好的全部技能：

dsh plugin --profile web add github:ddtcorex/maestro-skills

然后重启 dsh web。不需要 install.sh。

智能体预设是单独的一步，必须显式配置。 技能和预设是两套不同的机制：插件注册的是技能服务商，而预设是一行 @deepseek-ai/dsh-agent-preset 声明行，得由某个 bundle 来承载。想在 Web GUI 的智能体选择器里看到 "Maestro Skills"，就把本包 .dsh-plugin/ 里的两个文件复制成配置档 cordis.patch.yml 中的一行 dsh-agent-preset：

- insert:
- id: preset-maestro-skills
name: '@deepseek-ai/dsh-agent-preset'
config:
id: maestro-skills
name: "Maestro Skills"
description: "AI Agent preset bundling the maestro-skills library"
plugins: # the entry list from .dsh-plugin/agent.cordis.yml
- id: …

这个插件以前每次启动都会把该目录复制到 ~/.dsh/.agent-presets/maestro-skills/，并打日志说预设已安装。2026-09-22 起预设改成声明行，DSH 不再读那个目录 —— 那次写入什么也没改变，日志也在误导人。模板仍然放在 .dsh-plugin/ 里，因为声明行是复制手动从中提取。

Codex + Claude 委派预设（可选包，可选预设）： 当 web 配置档同时安装两个可选的子代理包（@deepseek-ai/dsh-subagent-codex 和 @deepseek-ai/dsh-subagent-claude-code）时，为 「Maestro Skills + Subagents (Codex + Claude)」 再加一行声明——组合方式相同，只是启用 subagent_codex 和 subagent_claude_code 两行工具，这样模型就能通过这两个产品官方的 app-server/SDK 结果契约委派任务，而不必依赖 PATH 上恰好是哪个命令行。src/subagent-variant.ts 是这套推导的可执行定义。两个服务商都通过各自的原生订阅登录认证，所以配额受限的账号可能会看到服务商侧的配额错误，直到限额重置。

包在安装时通过 prepare 脚本自行构建。pnpm ≥ 10 会阻止 git 依赖的构建脚本，直到你允许为止——如果第一次 add 报告有构建被忽略，把 pnpm 打印的 key 复制到配置档的 pnpm-workspace.yaml，然后重跑： allowBuilds: '@ddtcorex/maestro-skills': true

如果要从手写的补丁层引用插件，那一行必须写真实包名：
- insert:
- id: maestro-skills
name: '@ddtcorex/maestro-skills'

不要把技能链接到 ~/.dsh/skills/（旧的 install.sh --target dsh 路径，已移除）：预设层的 skill-filesystem 服务商会用过期缓存遮蔽插件。在 DSH 上，插件是唯一事实来源。

2. Claude Code —— 作为插件

/plugin marketplace add ddtcorex/maestro-skills
/plugin install maestro-skills@ddtcorex
更新：/plugin marketplace update ddtcorex。

3. Codex CLI —— 作为插件

codex plugin marketplace add ddtcorex/maestro-skills
codex plugin add maestro-skills@ddtcorex
更新：codex plugin marketplace upgrade ddtcorex。

4. OpenCode 与 GitHub Copilot —— 散装技能文件（那边没有插件加载器）

curl -fsSL https://raw.githubusercontent.com/ddtcorex/maestro-skills/master/install.sh | bash

| 工具 | 扫描路径（项目范围） | 扫描路径（个人范围） |
| OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ |
| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ |

安装脚本只服务没有插件加载器的工具。在 Claude Code、Codex CLI 和 DSH 上，请安装插件（上面第 1-3 节），不要链接散装文件：散装副本会用过期缓存遮蔽插件。如果是从使用已移除的 claude、codex 或 dsh 目标的安装升级：先跑一次 install.sh --uninstall（它会删掉安装脚本记录过的所有路径，包括旧目标），然后只为 OpenCode 或 Copilot 重跑安装脚本。

🔄 Superpowers fork 维护

流程技能是上游 fork，不是手工维护的副本：

scripts/sync-superpowers.sh # latest upstream HEAD
scripts/sync-superpowers.sh v7.0.0 # a specific tag

脚本会打印 diff 供你审阅；fork 不带任何内容新增（它的 PRESERVE 列表有意留空），using-superpowers/SKILL.md 里的 fork 来源说明会在审阅时手动重新加上。不要手动编辑 fork 过来的技能正文——见 THIRD-PARTY-NOTICES.md。

⚡ 扩展指南：添加新的领域技能

Govard 支持的任何新框架或工具链（例如 Laravel、Symfony、React、Vue、Docker 等），你都能轻松扩充进这个中心。

第 1 步：创建技能文件夹

用 kebab-case 创建 skills/[framework/tool]-[purpose]/（例如 skills/laravel-dev-core/、skills/vue-hyva-checkout/）。流程类技能不要在这里创建——请向上游 obra/superpowers 贡献。

第 2 步：创建 SKILL.md 文件

每个技能文件夹必须在根目录下有一个 SKILL.md 文件，并带合法的 YAML frontmatter：

name: your-skill-name
description: |
Describe exactly when the AI Agent should trigger this skill.
compatibility: claude, codex, opencode, copilot, dsh
depends: [any-dependencies-if-applicable]

Your Skill Title

Capabilities
Describe what this skill enables the agent to do.

Best Practice Patterns
Provide code templates, standards, and typical commands.

Verification
Step-by-step commands to verify output works properly.

一个包，一套工作流：Govard 的领域专长加上 superpowers 的流程纪律。 🚀

贡献

改动遵循 AGENTS.md 规定的 Superpowers 工作流：头脑风暴 → 编写计划 → 执行计划，全程严格 TDD。只开功能分支；绝不直接提交到 master。

致谢与署名

- 领域技能：© DDTCoreX，MIT 协议（见 LICENSE）。
- 流程技能：fork 自 obra/superpowers v7.0.0，作者 Jesse Vincent / Prime Radiant，MIT 协议——完整声明见 THIRD-PARTY-NOTICES.md。fork 不带任何本地内容新增。