1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Wizard（Mattpocock Skills） |
| 作者/维护者 | Matt Pocock（Total TypeScript 创办人，曾任职 Vercel、Stately） |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/engineering/wizard |
| 许可证 | MIT（数据来自 GitHub API） |
| 所属仓库 Stars / Forks | 238,250 / 20,269（数据来自 GitHub API；该数字属整个合集仓库，不代表本技能自身热度） |
| 最近提交 | 2026-08-19（数据来自 GitHub API，仅本子技能目录） |
| 安装方式 | Claude Code 官方插件市场一键安装；其余 agent 通过通用安装器 npx skills@latest add |
2. 功能介绍与亮点
Wizard 是一个“生成向导的向导”：它不直接执行操作，而是产出一个交互式 bash 脚本，带着人类一步步走完那些只能由人手工完成、又懒得每次跟 AI 重新解释一遍的流程——比如开通第三方服务凭据、配置 CI Secrets、在陌生的第三方控制台里点来点去，或是一次性的迁移/切换。
核心亮点：
- 先梳理再生成：使用前会先读取项目里的
.env、.env.example、docker-compose*、框架配置和.github/workflows/*里的每一处secrets.*/vars.*引用，据此推断出向导需要产出哪些值，再和用户确认阶段顺序，而不是凭空编造步骤。 - 复用统一的脚手架：所有向导共享同一份
template.sh，自带分阶段进度提示、确认关卡、跨平台 URL 打开（含 WSL）、隐藏式密钥输入、.env幂等写入、gh secret/gh variable写入等能力，作者本人只需专注写清每个阶段该做什么。 - 生成后不擅自执行：脚本生成后会用
bash -n与shellcheck做静态校验，并明确要求“不要自己跑一遍”（因为它会打开浏览器、等待人工输入），把最终执行权交还给人。 - 默认一次性：向导默认是临时产物，用完即可删除；只有用户明确想要一条可重复的配置路径时才提交进仓库。
3. 适用场景
所属分类：DevOps 与基础设施。
适用于：项目初始化时要给多个第三方服务开通凭据并写入 .env/CI Secrets；把一份手工迁移/切换清单变成可复现的脚本交给团队新人执行；需要反复带非技术协作者走完某个陌生控制台操作流程的场景。受益人群集中在需要频繁给项目搭建基础设施、又不想每次都口头重新解释一遍操作步骤的工程师与团队负责人。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 已上架 Claude Code 官方插件市场，claude plugins install mattpocock-skills 或会话内 /plugin install mattpocock-skills 即可，随作者更新自动同步 |
| Codex | ⚠️ 需适配 | 通过通用安装器 npx skills@latest add mattpocock/skills 安装；仓库自述“原生 Codex 插件在路线图上”（尚未原生），但本子技能目录自带 agents/openai.yaml 专门适配元数据 |
| OpenClaw | ⚠️ 需适配 | 同一 npx skills 安装器官方支持列表明确列出 OpenClaw（专属路径 ~/.openclaw/skills/），需通过安装器选取而非原生内置 |
| Hermes Agent | ⚠️ 需适配 | 同上，安装器官方列出 Hermes Agent 专属路径 ~/.hermes/skills/ |
5. 推荐理由
大量项目搭建阶段都卡在同一类问题上：给第三方服务开通凭据、配置 CI Secrets、在陌生控制台里点来点去——这些步骤只能人做，但每次都要跟 AI 重新解释一遍流程本身就很消耗。Wizard 把“讲清楚该做什么”这件事一次性沉淀成一份可复用、可分享给团队的交互式脚本，脚本执行前会先做静态校验、执行权始终留给人类，兼顾了效率与可控性。它已通过三方安全审计平台（Gen Agent Trust Hub、Socket、Snyk）全部 Pass，且在 skills.sh 上装机量超过 25 万，是同类“手工配置引导”场景里证据最扎实的选择。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 所属合集仓库整体 238,250 stars，该数字属整个合集，不代表本技能自身热度；本技能自身在第三方安装平台 skills.sh 上的装机量约 25.6 万，属独立可核验的分发证据 |
| 可用性 | 7 | SKILL.md 文档完整、流程清晰，近期仍在维护；但 GitHub 上有 7 条仍处于 open 状态的功能性缺陷报告（如密钥输入在部分终端插入转义字符、EOF 时可能死循环、写入 .env 时未加引号会被空格/特殊符号打断），需要用户自行留意规避 |
| 安全性 | 9 | 纯提示词/模板生成类技能，本身不执行任何 shell 命令或网络请求；生成的脚本仅供人工审阅后自行运行，且内置 bash -n/shellcheck 静态校验步骤；三方安全审计平台（Gen Agent Trust Hub、Socket、Snyk）均为 Pass |
安全检查清单：① 技能自身不执行 shell 命令，仅生成供人工审阅的脚本文本 ② 技能运行时不联网外发数据 ③ 不要求任何 API key/凭据存储在技能自身 ④ 未见可疑指令或隐蔽外发迹象 ⑤ 作者信誉良好（Total TypeScript 创办人，公开身份） ⑥ License 明确为 MIT ⑦ 最近一次针对本子技能目录的提交为 2026-08-19，维护活跃
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与 Wizard 的差异 |
|---|---|---|
| Genie Setup Wizard | 面向单一产品 Genie 的固定五阶段接入向导，帮助开发者把 Genie 集成进自己的项目 | 只服务 Genie 这一款特定产品的接入流程，步骤是预先写死的；Wizard 则是通用的“向导生成器”，能针对任意第三方服务或迁移场景现场生成专属脚本，不绑定任何单一产品 |
| skill-creator（Anthropic 官方） | 通过交互式问答帮用户搭建新的 Agent Skill 目录结构 | 产出物是一个新的 Skill 定义本身；Wizard 产出物是面向人类操作者的可执行 bash 脚本，两者服务的对象完全不同（前者服务 Agent 生态，后者服务人工操作流程） |
8. 用户评价
该技能所属仓库整体在开发者社区有较高关注度（Devtalk 论坛上一篇《Anyone tried mattpocock/skills for Claude Code? Here is what I found after a week》的实测帖点名推荐了同仓库的 /grill-with-docs、/tdd、/diagnose、/caveman 四个技能），但该帖及其他可检索到的第三方讨论均未具体点名评价 Wizard 本身，本技能目前在第三方平台尚无具名用户评价。
9. 其他补充
同仓库另有 setup-matt-pocock-skills（负责一次性初始化整套技能配置）与 Wizard 分工不同：前者配置的是“这套技能怎么用”，Wizard 生成的是“某个具体手工流程怎么走”，二者互不重叠。
10. 安装使用方式
- Claude Code：
claude plugins install mattpocock-skills，或在会话内输入/plugin install mattpocock-skills；安装后运行一次/setup-matt-pocock-skills完成初始化。 - Codex / OpenClaw / Hermes Agent 等其他 agent：
npx skills@latest add mattpocock/skills，安装过程中勾选wizard（建议同时勾选setup-matt-pocock-skills）。 - 安装后无需重启，直接在对话中输入
/wizard并描述要完成的手工配置或迁移任务即可触发。
11. 注意事项
- 生成的脚本默认不会被技能自身执行，需要用户手动运行；用户应在运行前自行通读脚本内容。
- 已知存在若干功能性缺陷（如密钥输入在部分终端环境下的转义字符问题、
.env写入在特殊符号场景下未加引号），首次在陌生环境使用前建议先小范围试运行。 - 面向 Claude Code 以外的 agent 需通过通用安装器额外安装，不是开箱即用的原生插件。