wayfinder SKILL.md skillA
wayfinder from vinvcn/mattpocock-skills-zh-cn is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add vinvcn/mattpocock-skills-zh-cn/wayfinder@git:20261008.5be0dc1Pins git:20261008.5be0dc1 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- vinvcn/mattpocock-skills-zh-cn
- Path
skills/engineering/wayfinder/SKILL.md- Versions recorded
- 5
- Latest version
- git:20261008.5be0dc1, committed Oct 8, 2026
- First version recorded
- Jul 23, 2026
- Size
- 11,651 bytes
- Repository stars
- 5,110
- License
- MIT
把单个 agent session 装不下的一大块工作规划成 issue tracker 上的 decision tickets shared map，并逐一解决，直到通往 destination 的路清晰。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
一个松散想法出现了：它太大，单个 agent session 装不下，而且被 fog 包围；从这里到 **destination** 的路还看不见。Wayfinding 的目标是找到这条路，而不是朝 destination 猛冲。这个 skill 会把路径绘制成 repo issue tracker 上的 **shared map**，然后逐个处理 **decision tickets**（它们承载需要决策才能解决的问题，而不是要执行的 build slices），直到路线清晰。 不同 effort 的 destination 不同，而为它命名是 charting 的第一个动作；它塑造每个 ticket。它可能是一份要 hand off 并迭代的 spec、一个必须在 planning 前确定的 decision，或 data-structure migration 之类原地完成的 change。Map 与领域无关：engineering work、course content，或任何符合这个形状的事项都可以。 ## 只规划，不动手 Wayfinder 默认用于 **planning**：每个 ticket 解决一个 decision；当别人动手前已经没有任何事情需要决定、路径完全清晰时，map 才算完成。想直接做工作的冲动通常表示你已经到达 map 边缘，该 hand off 了。Effort 可以在 **Notes** 中覆盖这个默认值，把 execution 纳入 map；否则只产出 decisions，不产出 deliverables。 ## 用名称引用 每张 map 和每个 ticket 都是 issue，因此都有一个 **name**：它的 title。在所有给人看的内容里，包括叙述和 map 的 Decisions-so-far，都用 name 引用它，不要只写裸 id、number 或 slug。一堵 `#42, #43, #44` 很难读；name 一眼就能看懂。Id 和 URL 不会消失，它们被包在 name 的 link 里面，但不单独替代 name。 ## 共享地图 Map 是这个 repo issue tracker 上一个带 `wayfinder:map` label 的单独 issue，是 canonical artifact。它的 tickets 是 map 的 child issues。 Map 是 **index**，不是 store。它列出已经做出的 decisions，并指向保存细节的 tickets；一个 decision 只存在一个地方，也就是它的 ticket。因此 map 不复述细节，只给 gist 和 link。 …
Read the whole file at its exact version.
How to install
mdr add vinvcn/mattpocock-skills-zh-cn/wayfinder@sha256:1c221cb5bdf73a04The line at the top of this page pins the label git:20261008.5be0dc1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_ice2s7ima4if32a4)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Jul 23, 2026 and Oct 8, 2026, about one every 19 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261008.5be0dc1 latest | 2026-10-08 | 5be0dc1 | 11,651 B | A | view · diff |
| git:20261008.f659bb3 | 2026-10-08 | f659bb3 | 11,647 B | A | view · diff |
| git:20260921.49ef591 | 2026-09-21 | 49ef591 | 11,668 B | A | view · diff |
| git:20260811.b46e155 | 2026-08-11 | b46e155 | 11,483 B | A | view · diff |
| git:20260723.a9147dc | 2026-07-23 | a9147dc | 11,506 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (11651 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
vinvcn/mattpocock-skills-zh-cn · 5,110 stars · license MIT · pushed 2026-10-20 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_ice2s7ima4if32a4 GET https://markdownregistry.com/api/v1/resolve?ref=vinvcn/mattpocock-skills-zh-cn/wayfinder GET https://markdownregistry.com/api/v1/blob/1c221cb5bdf73a04197b892f728072a00e822a956e21a91a8cd77ef64c80fe8c
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.
More from vinvcn/mattpocock-skills-zh-cn
Every file in vinvcn/mattpocock-skills-zh-cn