ddtcorex/maestro-skills

Maestro Skills (maestro-skills)

一个面向 AI 编程代理的统一技能库，打包为适用于 DeepSeek Harness (DSH)、Claude Code、Codex CLI、OpenCode 和 GitHub Copilot 的通用插件——一个包中融合两大部分：

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

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

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

📂 目录结构

每个技能都位于 skills//SKILL.md 下——这是所有受支持的 AI 工具和平台中的唯一事实来源：

maestro-skills/
├── README.md                        # 全局文档和指南
├── package.json                     # NPM 包与 DSH Cordis 插件清单 (@ddtcorex/maestro-skills)
├── THIRD-PARTY-NOTICES.md           # Superpowers 派生归属 + MIT 许可证文本
├── scripts/
│   └── sync-superpowers.sh          # 从上游刷新 superpowers 派生
├── tsconfig.json                    # TypeScript 编译器配置
├── src/                             # DSH Cordis 插件源代码
│   ├── index.ts                     # Cordis 插件入口点：提供打包的技能 + 安装 DSH 代理预设
│   └── dsh-types.d.ts               # DSH 类型定义
├── .dsh-plugin/                     # DeepSeek Harness 代理预设定义
│   ├── preset.yml                   # Web GUI 预设显示元数据（"Maestro Skills"）
│   └── agent.cordis.yml             # DSH 代理预设组合
├── .claude-plugin/                  # Claude Code 插件清单
├── .codex-plugin/                   # Codex CLI 插件清单
├── .agents/plugins/                 # Codex 市场清单
│
└── skills/                          # 共 31 个技能
├── 🧠 流程技能（派生自 obra/superpowers v6.3.0）
│   ├── brainstorming/              # 带审批门控的苏格拉底式设计精炼
│   ├── 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/          # 技能系统介绍（+ DSH 工具映射）
│
├── 📦 核心标准与架构
│   └── magento2-dev-core/           # Magento 2 核心指南（DI、仓储、安全）
├── 🛠️ 质量保证与审计
│   ├── magento2-linter/             # PHPCS、PHPStan、PHPMD 质量检查
│   ├── magento2-performance-audit/  # Web 核心指标、基础设施与数据库性能分析
│   ├── 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 解析器、Cron、队列
└── 🔧 开发环境与 CLI 工具（Govard 技术栈）
├── govard-toolbox/              # 基础容器编排工具箱
├── govard-magento/              # Magento 专用开发环境命令
├── govard-laravel/              # Laravel 专用开发环境命令
└── review-in-worktree/          # 在分离的审查工作树中运行 Govard 命令

🤖 技能兼容性矩阵

全部 31 项技能在所有列出的工具上表现一致。

| 分组 | 技能 | Claude Code | Codex CLI | OpenCode | GitHub Copilot | DeepSeek Harness |
|---|---|---|---|---|---|---|
| 流程（superpowers 分支） | brainstorming, 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 | ✅ | ✅ | ✅ | ✅ | ✅ |
| 工具链（Govard） | govard-toolbox、govard-magento、govard-laravel、review-in-worktree | ✅ | ✅ | ✅ | ✅ | ✅ |
| PHP 基础 | php-dev-core | ✅ | ✅ | ✅ | ✅ | ✅ |

| 技能 | 描述 |
|-------|-------------|
| php-dev-core | 通用 PHP 基础（PSR-12/Composer/PHPStan/安全） |

💾 安装

1. DeepSeek Harness (DSH) — 作为插件（推荐）

一条命令即可完成完整安装——该插件自身提供全部 31 个打包技能，并且在启动时将 “Maestro Skills” 代理预设物化到 ~/.dsh/.agent-presets/maestro-skills/：

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

然后重启 dsh web，并在 Web GUI 代理选择器中选择 Maestro Skills。无需 install.sh。

Codex + Claude 委托预设（可选捆绑包，可选预设）： 当 web 配置文件还安装了这两个可选的子代理捆绑包（@deepseek-ai/dsh-subagent-codex 和 @deepseek-ai/dsh-subagent-claude-code）时，该插件还会额外物化一个 maestro-skills-subagents 预设——相同的组合，但启用了 subagent_codex 和 subagent_claude_code 工具行，因此模型可以通过这些产品的官方 app-server/SDK 结果契约进行委托，而不是使用 PATH 上碰巧存在的任何 CLI。会话在选择器中选择 “Maestro Skills + Subagents (Codex + Claude)”；两个提供方都通过其原生订阅登录进行身份验证，因此配额受限的账户可能会看到提供方侧的配额错误，直到限制重置。

该包在安装时通过其 prepare 脚本自行构建。pnpm ≥ 10 会阻止 git 依赖的构建脚本，直到你允许它们——如果第一次 add 报告了被忽略的构建，请将 pnpm 打印的键复制到配置文件的 pnpm-workspace.yaml 中并重新运行：
allowBuilds:
'@ddtcorex/maestro-skills': true

若要改为从手写的补丁层引用该插件，该行必须命名真实包：
- insert:
- id: maestro-skills
name: '@ddtcorex/maestro-skills'

替代方案：通过安装器使用松散技能文件（无插件）

curl -fsSL https://raw.githubusercontent.com/ddtcorex/maestro-skills/master/install.sh | bash -s -- --target dsh
将所有技能链接到 ~/.dsh/skills/，并将代理预设复制到 ~/.dsh/.agent-presets/maestro-skills/。

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

| 工具 | 扫描路径（项目范围） | 扫描路径（个人范围） |
|------|------------------------|--------------------------|
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| DeepSeek Harness (DSH) | .dsh/skills/ | ~/.dsh/skills/ |
| OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ |
| Codex CLI | .agents/skills/ | ~/.agents/skills/ |
| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ |

🔄 Superpowers 分支维护

这 14 个流程技能是上游分支，而非手工维护的副本：

scripts/sync-superpowers.sh            # 最新的上游 HEAD
scripts/sync-superpowers.sh v6.4.0     # 特定标签

该脚本会保留本仓库的本地新增内容（skills/using-superpowers/references/dsh-tools.md、using-superpowers/SKILL.md 中的分支来源说明），并打印差异以供审查。请勿手动编辑分支技能正文——参见 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 文件
每个技能文件夹必须在其根目录下包含一个带有有效 YAML frontmatter 的 SKILL.md 文件：

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）。
- 流程技能：分支自 obra/superpowers v6.3.0，作者 Jesse Vincent / Prime Radiant，MIT 许可证——完整声明见 THIRD-PARTY-NOTICES.md。DSH 工具映射（references/dsh-tools.md）为本地新增内容，并非上游内容。