首页 › skills-review › 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 上的决策地图

安装方式(作者推荐二选一,不要同时装两份):

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

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

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

---
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 模板

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

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

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 没有版本管理机制,作者用「双目录同仓」手工解决了平滑迁移。

六、生态全景

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 的工作循环:

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[目的地抵达, 地图完成]

七、多维度排行榜

参考来源

  1. Skills Leaderboard — skills.sh — 全时段安装总榜 Top 8、各仓库累计安装数
  2. Trending AI Agent Skills — skills.sh — 24小时趋势榜全部排名与日安装量
  3. mattpocock/skills — GitHub — user/model-invoked 二分法、仓库结构、安装方式
  4. wayfinder SKILL.md 原文 — frontmatter、fog of war、ticket 类型学逐段引用
  5. wizard SKILL.md 原文 — template.sh 职责切分、四步流程、反幻觉条款
  6. flowkit-labs/skills — GitHub — reddit-automation 功能与安全声明、仓库 Star/commit 数据
  7. stablyai/orca — GitHub — Orca ADE 功能、CLI 命令、许可证
  8. Leonxlnx/taste-skill — GitHub — v1/v2 双安装名升级策略
  9. mattpocock/skills git tree API — 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学通信知识星球海报-扫码加入