<!-- title: wayfinder与wizard：本周新Skill周报 -->

# wayfinder与wizard：Matt新上线Skill双拆解，本周生态还有这三股暗流

## 概述

本期周报盯住三件事：一是 skills.sh 总榜前八被 mattpocock/skills 一个仓库占了六席（全仓累计 280 万安装），而他本周的增量火力全在新品类——规划型 Skill「wayfinder」和人类向导型 Skill「wizard」双双冲进 24 小时趋势榜前 40；二是增长/营销类 Skill（reddit-automation）以单日 1.68 万安装挤进趋势第 11 名，而其 GitHub 仓库只有 2 个 Star，安装量与 Star 彻底脱钩，分发重心已转向 skills.sh；三是厂商进场继续扩容，Neon（数据库）和 Orca（多 Agent 开发环境）本周上架自家的第一批 Skill。本文对 wayfinder、wizard 做逐段拆解，其余新面孔按评测表横评。

## 一、榜单速览：总榜固化，趋势榜换血

先看 skills.sh 全时段安装总榜 Top 8（数据取自 2026-08-31 页面）：

| 排名 | Skill | 来源仓库 | 累计安装 |
|---|---|---|---|
| 1 | find-skills | vercel-labs/skills | 320万 |
| 2 | grill-me | mattpocock/skills | 100万 |
| 3 | grill-with-docs | mattpocock/skills | 85.9万 |
| 4 | frontend-design | anthropics/skills | 83.5万 |
| 5 | improve-codebase-architecture | mattpocock/skills | 82.7万 |
| 6 | tdd | mattpocock/skills | 79.9万 |
| 7 | agent-browser | vercel-labs/agent-browser | 75.4万 |
| 8 | setup-matt-pocock-skills | mattpocock/skills | 73.6万 |

仓库级累计安装更能说明生态集中度：open.feishu.cn 全家桶 1510 万、microsoft/azure-skills 720 万、mattpocock/skills 280 万、skills-101/superpowers 190 万。总榜头部已高度固化。

变化发生在 24 小时趋势榜：ai-video-generation（skills-101/superpowers）以 2.26 万/日居首，anti-ui-slop（uizze.com）1.84 万/日第二梯队，而真正的新面孔是——wait-what（5.0K/日，第36）、wizard（4.9K/日，第37）、to-questionnaire（4.9K/日，第38）、loop-me（3.8K/日，第41）、setup-ts-deep-modules（3.7K/日，第49）。前四个全部来自 mattpocock 仓库的 productivity 与 in-progress 目录，说明这个仓库的增量仍在加速，而不是吃老本。

一个反直觉信号：reddit-automation 日装 1.68 万，但其仓库 flowkit-labs/skills 只有 1 个 commit、2 个 Star。安装发生在 skills.sh 的 CLI 管道里，根本不经过 GitHub 点星。对 Skill 作者而言，「Star 数」正在失去作为热度指标的意义。

## 二、评测对比表

| Skill | 功能完整度(25%) | 设计质量(25%) | 实战效果(20%) | 上手难度(15%) | 社区活跃(15%) | 加权总分 |
|---|---|---|---|---|---|---|
| wayfinder | 5 | 5 | 4 | 3 | 5 | **4.5** |
| wizard | 4 | 5 | 4 | 4 | 4.5 | **4.3** |
| wait-what | 3 | 4.5 | 3.5 | 5 | 4.5 | **4.0** |
| to-questionnaire | 4 | 4 | 3.5 | 5 | 4 | **4.0** |
| setup-ts-deep-modules | 4 | 4 | 3.5 | 3 | 4 | **3.7** |
| orca-cli | 3.5 | 3.5 | 3.5 | 3 | 4 | **3.5** |
| neon / neon-postgres | 3.5 | 3.5 | 3.5 | 4 | 3.5 | **3.6** |
| reddit-automation | 3 | 3 | 3 | 5 | 2 | **3.1** |
| loop-me | 3 | 3 | 3 | 4 | 4 | **3.3** |

## 三、深拆 wayfinder：把「大活」拆成一张挂在 issue tracker 上的决策地图

安装方式（作者推荐二选一，不要同时装两份）：

```bash
# 方式A：Claude Code 官方插件市场，托管式、自动更新
claude plugins install mattpocock-skills

# 方式B：skills.sh 可编辑拷贝，可选单一 skill
npx skills@latest add mattpocock/skills
```

wayfinder 解决的问题是：一个想法大到单次 agent 会话装不下，且路径本身还没看清。它的答案不是「写个更长的计划文档」，而是把规划物直接架在你仓库的 issue tracker 上。先看 frontmatter：

```yaml
---
name: wayfinder
description: Plan a huge chunk of work (more than one agent session can hold)
  as a shared map of decision tickets on your issue tracker, and resolve
  them one at a time until the way to the destination is clear.
disable-model-invocation: true
---
```

三行各干一件事，值得逐行说。

**第一行 `disable-model-invocation: true`** 是整个仓库「user-invoked / model-invoked 二分法」的执行点。README 里作者说得很清楚：编排型 skill（orchestrator）只能由用户显式召唤；纪律型 skill（如 grilling、tdd）允许模型在任务匹配时自动挂载。规划是重操作——要建 issue、要定 scope——模型若能自作主张启动它，一次普通问答就会演变成一堆新建 issue。触发权设计是 SKILL.md 里最容易被忽视却最影响体验的一行。

**第二行 description** 一句话同时回答三个问题：何时用（too big for one session）、产出什么（a shared map of decision tickets）、何时结束（the way is clear）。没有形容词，全是可判定的边界条件。

**正文的第一性概念**是一套游戏化词汇表：destination（目的地）、map（地图）、ticket（决策工单）、frontier（当前可走的边界）、fog of war（战争迷雾）。这不是修辞装饰。作者在 grill-with-docs 里反复论证「共享语言能省 token、让代码库更可导航」，而 wayfinder 是他自己践行这套理论的样本——模型和人类共用同一套 RTS 游戏里现成的心智模型，解释成本趋近于零。

**最关键的一句架构决策**：`The map is an index, not a store.` 地图 issue 只做索引，每条决策的详情只存在于它的 ticket 里，地图只放摘要加链接。信息单点存储，杜绝了「地图和工单各写一份、两周后互相矛盾」的经典腐化。配套的还有「Refer by name」条款：给人类看的一切叙述必须用工单标题，不许甩 `#42, #43, #44` 这种裸编号——「一墙数字没法读，名字一眼能读」。

**Ticket 的四类型学**是它区别于普通「拆任务」工具的核心：

| 类型 | HITL/AFK | 绑定的子 Skill | 使用时机 |
|---|---|---|---|
| Research | AFK | research | 需要工作目录之外的知识 |
| Prototype | HITL | prototype | 关键问题是「该长什么样/怎么表现」 |
| Grilling | HITL | grilling + domain-modeling | 默认类型，纯对话决策 |
| Task | 两者皆可 | 无 | 决策前必须发生的体力活（注册服务、迁移数据） |

注意 Grilling 一行写着「Always call the Skill tool twice」——wayfinder 自己不实现访谈逻辑，直接组合仓库里已有的 grilling 和 domain-modeling。Skill 调 Skill 的组合式架构，而不是每个 skill 重新发明一遍流程。更狠的是 HITL 纪律条款：*「a grilling agent that answers its own questions has broken this」*——agent 代替人类回答自己的问题即判定违规。这一句防住了 AI 访谈最常见的作弊模式。

**并发设计**是它最像「基础设施」的部分。工单的认领就是 assignee 字段——先认领再干活，其他并行会话看到有人认领就跳过；阻塞关系用 tracker 原生 dependency，好处是 frontier 直接渲染在 GitHub/Linear 自己的 UI 里，人类不开地图也能看出哪些工单现在可拿。正文末尾明说：`expect other sessions to be editing the tracker concurrently`。issue tracker 在这里被当作多 agent 会话之间的协调总线，而不是让 agent 自己维护一份会腐烂的本地状态文件。

**Fog 的判定标准**只有一句话，却极其可执行：*「The test is whether you can state the question precisely now, not whether you can answer it now.」* 能精确表述的问题就建 ticket（哪怕被阻塞着），表述不出来的留在「Not yet specified」区。禁止提前把迷雾切成工单大小的块——迷雾比工单粗，一块迷雾将来可能毕业成三张票，也可能什么都不毕业。

**两条出口流程**：`/wayfinder` 建图（定目的地 → 广度优先第二轮 grilling → 建 map issue → 建票并二次连线阻塞边 → 并行发射 research 子代理 → **停**，建图本身一个决策都不解决）；`/wayfinder <map>` 走图（选票 → 认领 → 解决 → resolution comment + 关票 + 回写地图 → 毕业新雾、清除旧雾）。硬约束是 `never resolve more than one ticket per session`，每张票的 body 按一个 10 万 token 会话的容量来写。

**短板**也说清楚：它依赖你先跑过 `/setup-matt-pocock-skills` 配置 issue tracker（否则退化到本地 markdown，体验打折）；单人小项目用它属于杀鸡用牛刀；chart 阶段连开两轮 grilling，急脾气用户会觉得「我就想要个计划，怎么又面试我」；弱模型容易分不清 fog 和 ticket 的边界，把迷雾全部物化成票。作者自己的定位很诚实——README 里说 improve-codebase-architecture「是一次勘察不是营救」，这话同样适用于 wayfinder。

## 四、深拆 wizard：一个 4KB 的 SKILL.md，配一个 8.6KB 的 bash 模板

```bash
npx skills@latest add mattpocock/skills   # 安装时勾选 wizard
```

wizard 的任务是：生成一个交互式 bash 脚本，陪人类走完只有人类能做的步骤——开通第三方服务、填 CI secrets、走一遍陌生的仪表盘。它的 frontmatter 同样有值得抄的设计：

```yaml
description: Generate an interactive bash wizard that walks a human through
  steps only they can perform. Use when provisioning infrastructure, setting
  up credentials or CI secrets, walking an unfamiliar third-party dashboard,
  or running a one-off migration or cutover. Don't invoke this for steps the
  agent can perform itself.
```

最后的负向触发词——*「agent 自己能做的步骤不要调用本 skill」*——是很多 Skill 作者漏掉的一半。description 不只该说「何时用我」，还要说「何时别用我」，否则模型会在所有配置类任务上误触发。

真正的设计精髓在正文第一段：*「The delightful UX is already solved by template.sh — …Your job is only to scope the procedure and author its stages. The library above the STAGES marker is identical in every wizard; that consistency is the point — never hand-edit it.」*

这是把 Skill 从「教模型写代码」改造成「让模型填空」的范式：8.6KB 的 template.sh 里，stage-by-stage 进度、确认门、跨平台开 URL（含 WSL）、密钥隐藏输入、幂等 `.env` upsert、`gh secret` 写入、收尾摘要——全部现成，模型唯一的工作是把人类流程切成 stages 填进去。模板里 `STAGES` 标记以上的库代码禁止改动，「一致性本身就是目的」。对比那些把全部实现逻辑写在 SKILL.md 里、指望模型每次重新发挥的 Skill，这种「代码库 + 提示词」的职责切分让产出质量的方差小了一个数量级。

流程四步：**Scope**（先读 `.env*`、`docker-compose*`、`.github/workflows/*`，每个 `secrets.*` 引用都是 wizard 必须产出的值，列清单向用户确认）；**Map journey**（每一步写出「仪表盘 → Developers → API keys → Reveal → 复制」级别的路径）；**Author**（拷模板、替换 stages、设 `TOTAL_STAGES`）；**Verify**（`bash -n` 语法检查后交付）。

两条纪律条款值得单独圈出来。反幻觉：*「Where you don't actually know the current UI or the exact command, say so and ask the user or check the docs — never invent steps that may not exist.」*——明确授权模型承认不知道，这比让它编一个看似合理的点击路径好得多。生命周期：*「A wizard is ephemeral by default — built for one run…deleted when the job's done.」*——默认用完即删，只有用户要可重复的安装路径时才提交进仓库。一次性脚本污染仓库是 agent 时代的常见病，这句就是疫苗。

## 五、本周其他新面孔

**wait-what（mattpocock/skills，5.0K/日）**——本次趋势榜上最便宜的话题。它的 SKILL.md 全文只有 325 字节，仓库 git 树里实测可见。功能：当一句话没听懂时打出 `/wait-what`，agent 用你缺的那部分上下文、按 `CONTEXT.md` 的共享词汇重新讲一遍。它证明了一件事：Skill 的价值密度可以低到字节级，靠的是 description 的语义卡位和与仓库其他 skill（共享语言体系）的配合。新手写第一个 Skill，照着这个体量起步完全够。

**to-questionnaire（mattpocock/skills，4.9K/日）**——把「我一个人决定不了的事」变成一份 Markdown 问卷，交给唯一能回答的人异步填写。作者强调它 grill 的是「怎么发问卷」（发给谁、要什么形式的回复）而不是问卷主题本身。与 grill 系列互补：grill 面试你自己，to-questionnaire 跨越组织边界去面试别人。

**loop-me / setup-ts-deep-modules（in-progress 目录，3.8K/3.7K 日装）**——两者都躺在仓库的 `skills/in-progress/` 里就已上榜。后者甚至带了一个 3.7KB 的 `dependency-cruiser.config.cjs` 配置文件随 Skill 分发。把 WIP 直接上架、让真实安装量替你做 beta 测试，这个发布节奏值得所有 Skill 作者参考——前提是你像 mattpocock 一样有 6 万订阅读者当测试池。

**reddit-automation（flowkit-labs/skills，1.68万/日，趋势第11）**——自称 doany.ai 出品，功能是找到「正在主动搜寻你卖的此类东西」的 Reddit 帖子，起草读起来像热心社区成员而不是广告的回复。README 专门写了安全声明：纯文档型 Skill，不往 shell 里灌远程脚本、不读环境变量、每条回复都留给人类手动发帖。1 个 commit、2 个 Star 对 1.68 万日装的悬殊比值，是本周最值得记的生态信号。 caution：仓库 README 里的安装命令写的是 `npx skills add doany-skills/skills --skill reddit-automation -g`，与实际仓库地址 flowkit-labs/skills 不一致，安装时以 skills.sh 页面给的命令为准。

**orca-cli（stablyai/orca，2.5K/日）**——Orca 是一个开源（MIT）的多 Agent 并行开发环境：每个 agent 跑在独立 git worktree 里，桌面/手机/VPS 三端，支持任意终端 CLI agent。它上架的 skill 教 agent 用 Orca 的 CLI 驱动自己：`orca worktree create`、`snapshot`、`click`、`fill`。这代表了「产品自带 Skill」的第三种姿势：不是用 Skill 展示功能（如飞书），也不是把自家云服务变成 agent 的手脚（如 Azure、Neon），而是让 agent 成为自己产品的自动化层——按 skills.sh 惯例安装为 `npx skills add stablyai/orca`（单 skill 用 `--skill orca-cli`，此为 CLI 惯例推断，以页面为准）。

**neon / neon-postgres（neondatabase/agent-skills，各 2.5K/日）**——Serverless Postgres 厂商 Neon 的首批 Skill，与飞书（1510万）、微软 Azure（720万）同一阵营：把云产品的操作知识做成 agent 可挂载的程序性知识。数据库厂商进场，意味着 Skill 军备竞赛从 UI 工具蔓延到了基础设施层。

**taste-skill v2（leonxlnx/taste-skill，3.8K/日）**——本周一个值得抄的升级策略：`design-taste-frontend` 原地升到 v2（实验版，重写为「读 brief → 推断设计语言 → 调三个旋钮」的架构），同时把 v1 完整保留为独立安装名 `design-taste-frontend-v1`。安装名不变、老用户重跑安装即升级、依赖旧行为的可以显式钉死 v1。SKILL.md 没有版本管理机制，作者用「双目录同仓」手工解决了平滑迁移。

## 六、生态全景

```mermaid
mindmap
  root((本周Skills生态))
    工程方法论
      mattpocock全家桶 280万
        wayfinder 规划地图
        wizard 人类向导
        wait-what 325字节
        to-questionnaire 异步问卷
    厂商进场
      飞书 1510万
      Azure 720万
      Neon 数据库新面孔
      Orca 工具链自带
    增长与营销
      reddit-automation 1.68万/日
      anti-ui-slop 1.84万/日
    AI媒体
      ai-video-generation 2.26万/日
      hyperframes 家族
    分发层
      find-skills 320万
      skills.sh CLI
```

wayfinder 的工作循环：

```mermaid
flowchart TD
    A[用户: 一个大想法] --> B[Chart: 定目的地]
    B --> C[广度优先第二轮grilling]
    C --> D{迷雾清晰了吗?}
    D -- 是 --> E[不需要地图, 直接做]
    D -- 否 --> F[建map issue + 决策tickets]
    F --> G[并行发射research子代理]
    G --> H[停止: 建图不解决任何决策]
    H --> I[Work: 选frontier上第一张票]
    I --> J[认领: 写assignee]
    J --> K[按类型解决: research/prototype/grilling/task]
    K --> L[resolution comment + 关票 + 回写地图]
    L --> M{雾毕业出新票?}
    M -- 是 --> I
    M -- 否 --> N[目的地抵达, 地图完成]
```

## 七、多维度排行榜

- **本周最值得装**：wayfinder（正在做大重构/多会话工程的人，一次安装终身受益）
- **设计最值得抄**：wizard（「模板已解决UX，模型只负责填空」范式）
- **新手第一课**：wait-what（325 字节上手，理解 description 语义卡位）
- **最需谨慎**：reddit-automation（仓库与安装命令不一致、无社区背书，装前读一遍它的 SKILL.md 全文）
- **最值得关注的发布策略**：in-progress 目录直接上架 + taste-skill 的 v1/v2 双安装名共存

## 参考来源

1. [Skills Leaderboard — skills.sh](https://www.skills.sh) — 全时段安装总榜 Top 8、各仓库累计安装数
2. [Trending AI Agent Skills — skills.sh](https://www.skills.sh/trending) — 24小时趋势榜全部排名与日安装量
3. [mattpocock/skills — GitHub](https://github.com/mattpocock/skills) — user/model-invoked 二分法、仓库结构、安装方式
4. [wayfinder SKILL.md 原文](https://raw.githubusercontent.com/mattpocock/skills/main/skills/engineering/wayfinder/SKILL.md) — frontmatter、fog of war、ticket 类型学逐段引用
5. [wizard SKILL.md 原文](https://raw.githubusercontent.com/mattpocock/skills/main/skills/engineering/wizard/SKILL.md) — template.sh 职责切分、四步流程、反幻觉条款
6. [flowkit-labs/skills — GitHub](https://github.com/flowkit-labs/skills) — reddit-automation 功能与安全声明、仓库 Star/commit 数据
7. [stablyai/orca — GitHub](https://github.com/stablyai/orca) — Orca ADE 功能、CLI 命令、许可证
8. [Leonxlnx/taste-skill — GitHub](https://github.com/leonxlnx/taste-skill) — v1/v2 双安装名升级策略
9. [mattpocock/skills git tree API](https://api.github.com/repos/mattpocock/skills/git/trees/main?recursive=1) — wait-what 325字节、in-progress 目录结构、setup-ts-deep-modules 附带配置文件

> [!tip] 51学通信知识星球
> **星主：爱卫生**（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。
> **星球定位**：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。
> **当前规模**：5200 篇主题 / 990 个回答，198 元/年。
> **加入福利**：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。
> **AI 加持**：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。

![51学通信知识星球海报-扫码加入](https://wiki.500nian.com/images/zhixingqiu_qrcode.png)