使用 pnpx 全局安装 mattpocock/skills，保留全部可发现 Skills，再通过 Codex 配置单独关闭与 Superpowers 重复的项目。

一、安装前检查

确认已经安装 Node.js 和 pnpm：

1
2
3
node --version
pnpm --version
pnpx --version

如果 pnpx --version 不支持，但 pnpm --version 正常，也可以使用 pnpm dlx。当前 pnpm 官方将 pnpx、pnpm dlx 和 pnx 视为等价入口。pnpm 官方文档

二、查看仓库内可安装的 Skills

建议先查看当前版本的 Skill 清单：

1
pnpx skills@latest add mattpocock/skills --list

仓库会持续更新，所以实际数量可能变化。

三、全部安装给 Codex

执行：

1
2
3
4
5
pnpx skills@latest add mattpocock/skills \
  --global \
  --agent codex \
  --skill '*' \
  --yes

注意：zsh 中的 * 必须加引号，否则可能被当前目录文件展开。

参数含义：

  • --global：对所有项目可用
  • --agent codex：只配置给 Codex
  • --skill '*'：安装所有可发现的 Skills
  • --yes：跳过交互确认

这里的“全部”指安装器识别到的正式可发现 Skills，一般不包括仓库中的废弃、隐藏或开发中目录。仓库安装说明

四、确认安装结果

查看已安装列表：

1
pnpx skills@latest list --global --agent codex

检查实际文件位置：

1
2
3
find /Users/sherry/.agents/skills /Users/sherry/.codex/skills \
  -name SKILL.md 2>/dev/null \
  | sort

通常会安装到：

1
/Users/sherry/.agents/skills/

部分安装器版本也可能在：

1
/Users/sherry/.codex/skills/

或者在两个目录之间建立符号链接。后面的禁用配置必须使用实际存在的路径。

可以单独检查本次涉及的 Skills：

1
2
3
find /Users/sherry/.agents/skills /Users/sherry/.codex/skills \
  -type f -name SKILL.md 2>/dev/null \
  | rg '/(tdd|diagnosing-bugs|code-review|implement|writing-great-skills|grill-me|grilling)/SKILL\.md$'

五、关闭与 Superpowers 明显重复的 Skills

打开 Codex 全局配置：

1
nano /Users/sherry/.codex/config.toml

假设 Skills 位于 /Users/sherry/.agents/skills，在文件末尾加入：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# mattpocock/skills：Superpowers 已提供 TDD
[[skills.config]]
path = "/Users/sherry/.agents/skills/tdd/SKILL.md"
enabled = false

# mattpocock/skills：Superpowers 已提供系统化调试
[[skills.config]]
path = "/Users/sherry/.agents/skills/diagnosing-bugs/SKILL.md"
enabled = false

# mattpocock/skills：Superpowers 已提供代码审查流程
[[skills.config]]
path = "/Users/sherry/.agents/skills/code-review/SKILL.md"
enabled = false

# mattpocock/skills：Superpowers 已提供计划执行和子代理开发
[[skills.config]]
path = "/Users/sherry/.agents/skills/implement/SKILL.md"
enabled = false

# mattpocock/skills：Superpowers 已提供 writing-skills
[[skills.config]]
path = "/Users/sherry/.agents/skills/writing-great-skills/SKILL.md"
enabled = false

Codex 官方支持使用 [[skills.config]] 按 SKILL.md 的绝对路径禁用本地 Skill。Codex Skills 文档

如果查询结果显示文件位于 /Users/sherry/.codex/skills，则把上面的路径统一改为：

1
/Users/sherry/.codex/skills/技能名/SKILL.md

六、处理“头脑风暴”部分重叠

下面三个和 Superpowers 的 brainstorming 有一定重叠：

1
2
3
grill-me
grilling
grill-with-docs

但 grill-with-docs 还能维护项目术语、CONTEXT.md 和 ADR，因此不算完全重复。

推荐保留：

1
2
grilling
grill-with-docs

只关闭普通版 grill-me：

1
2
3
[[skills.config]]
path = "/Users/sherry/.agents/skills/grill-me/SKILL.md"
enabled = false

不要在保留 grill-with-docs 的情况下关闭 grilling，因为前者可能使用后者作为底层访谈流程。

如果完全只想使用 Superpowers 的头脑风暴流程，可以三个都关闭：

1
2
3
4
5
6
7
8
9
10
11
[[skills.config]]
path = "/Users/sherry/.agents/skills/grill-me/SKILL.md"
enabled = false

[[skills.config]]
path = "/Users/sherry/.agents/skills/grilling/SKILL.md"
enabled = false

[[skills.config]]
path = "/Users/sherry/.agents/skills/grill-with-docs/SKILL.md"
enabled = false

七、建议继续启用的差异化 Skills

这些没有被 Superpowers 完整覆盖，建议保持启用：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
ask-matt
setup-matt-pocock-skills
domain-modeling
codebase-design
improve-codebase-architecture
prototype
research
resolving-merge-conflicts
to-spec
to-tickets
triage
wayfinder
handoff
teach
grill-with-docs
grilling

八、重启 Codex

配置修改完成后：

  1. 完全退出 Codex。
  2. 重新打开 Codex。
  3. 新建一个任务。

旧任务可能已经加载了修改前的 Skills，不适合作为验证依据。

九、每个项目执行一次初始化

进入需要使用这些 Skills 的项目，新建任务并输入：

1
$setup-matt-pocock-skills

它会配置：

  • Issue Tracker：GitHub、GitLab 或本地 Markdown
  • Triage 标签
  • CONTEXT.md 和 ADR 的位置
  • docs/agents/ 下的相关配置文件

如果项目同时存在 CLAUDE.md 和 AGENTS.md，建议在调用时明确说明：

1
2
3
4
$setup-matt-pocock-skills

当前使用 Codex，请把生成的 Agent skills 配置写入 AGENTS.md，
不要只写入 CLAUDE.md；保留两个文件中的既有内容。

初始化会修改当前项目文件，因此应在真正准备使用这些工程流程的项目中运行，而不是随便找一个空目录运行。

十、验证启用和禁用状态

重启后，可以显式调用保留的 Skill：

1
$ask-matt

或：

1
$grill-with-docs

查看禁用配置是否正确：

1
2
3
rg -n -A 2 -B 1 \
  'tdd|diagnosing-bugs|code-review|implement|writing-great-skills|grill-me' \
  /Users/sherry/.codex/config.toml

十一、以后恢复某个 Skill

例如重新启用 tdd，有两种方法：

把：

1
enabled = false

改成：

1
enabled = true

或者删除对应的整个配置块：

1
2
3
[[skills.config]]
path = "/Users/sherry/.agents/skills/tdd/SKILL.md"
enabled = false

然后重启 Codex。

十二、更新和卸载

更新全部：

1
pnpx skills@latest update --global

查看全局安装：

1
pnpx skills@latest list --global --agent codex

删除单个 Skill：

1
2
3
4
pnpx skills@latest remove \
  --global \
  --agent codex \
  tdd

推荐最终状态是：

  • Superpowers：负责头脑风暴、TDD、系统调试、计划执行和代码审查。
  • mattpocock/skills：负责领域建模、架构分析、规格拆分、Issue 管理、研究、交接和教学。
  • mattpocock 中五个明确重复项保持 enabled = false。
  • grill-me 关闭，grill-with-docs 和 grilling 保留。