mattpocock-skills 项目演进全解从 1.0.0 到 1.2.3 的技能集架构、重构与发布历程【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills导读本文以mattpocock-skills仓库的 CHANGELOG.md 为主线系统梳理了这套 Skills for Real Engineers 智能体技能集从 v1.0.0 到 v1.2.3 的完整演进脉络。你将看到技能如何从命令式工具演化为双端点Claude Code 插件 skills.sh分发体系理解 User-invoked / Model-invoked 调用模型、Claude Codex 双 harness 元数据方案、技能晋升与合并重命名等关键架构决策并掌握各版本中诊断、评审、规划、原型等核心技能的底层实现细节从而在阅读仓库源码skills/ 目录时快速建立全局认知。CHANGELOG 在项目中的定位CHANGELOG.md 是本仓库唯一正式的版本变更记录采用Changesets驱动的发布流程package.json中配置了changesets/cli与changesets/changelog-github每次发布通过npm run version执行changeset version随后由 scripts/sync-plugin-version.mjs 把package.json中的版本号同步写入.claude-plugin/plugin.json该脚本以正则仅替换 version 字段保持键序与格式不变--check模式用于 CI 校验两个版本号是否一致。这意味着 CHANGELOG 中的每一条记录都对应真实 PR 与源码变更而非泛泛的版本号列表。当前仓库版本为1.2.3见 package.json本文按时间倒序逐一拆解每个版本的技术内涵。一、v1.2.3安全红线与 harness 无关化1. diagnosing-bugs 强制脱敏Redactskills/engineering/diagnosing-bugs/SKILL.md 是本仓库中最具分量的工程技能之一它在 v1.2.3 引入了全新的Redact章节该技能要求 Agent 向用户展示命令、输出与捕获产物因此必须先脱敏一切机密——用REDACTED占位符替代循环构建应围绕环境变量展开使凭证始终留在环境中而非展示内容里捕获产物如 HAR 文件带有认证头只应引用携带信号的少数几行。若脱敏后的输出不足以诊断必须明确说明并询问用户。这一改动同时触发了该技能各阶段的完成标准Phase 1 的完成判据由 粘贴调用及其输出 改为以脱敏形式展示并进一步要求用户提供脱敏后的捕获产物。配套的 skills/engineering/diagnosing-bugs/scripts/hitl-loop.template.sh 也补充说明capture会把值回显到终端因此它记录观察结果而登录操作仍是step步骤。2. 子代理分派指令的 harness 无关化code-review、codebase-design、improve-codebase-architecture三个技能此前在子代理分派指令中硬编码了 Claude Code 的工具与 Agent 类型名称。v1.2.3 将这些名称全部移除使流程步骤在 Codex 及其他 harness 上同样可执行——这呼应了仓库的跨 harness 战略详见后文 v1.2.0 的 Codex 元数据方案。3. wizard 移除时间估算[v1.2.3 变更] 将wizard技能的模板中TOTAL_MINUTES与剩余时间显示移除进度只按阶段stage计数stage函数只接收名称。查看 skills/engineering/wizard/template.sh 可以看到TOTAL_STAGES0默认值、printf %s %s stages%s\n\n的阶段计数显示逻辑以及文件底部# STAGES: author this section标记后每个人类步骤对应一个stage()调用的结构——时间估算的删除让模板更聚焦于阶段进度而非耗时承诺。二、v1.2.2writing-for-agents 回归 Codex 可调用v1.2.2 只有一个变更却极具诊断价值writing-for-agents技能此前在 skills/productivity/writing-for-agents/agents/openai.yaml 中设置了policy.allow_implicit_invocation: false这导致 Codex 将该技能从模型可见技能列表中过滤掉——其 description 无法触发技能只有显式$writing-for-agents提及才生效。修复方式是删除该配置同时更新了过时的interface.display_name与interface.short_description仍残留旧的writing-great-skills名称并在 README.md 与 skills/productivity/README.md 中将该技能从User-invoked列表移至Model-invoked列表。这里揭示了双 harness 调用模型的机制差异Claude Code 用disable-model-invocation: true阻止模型自动调用Codex 的对应物则是policy.allow_implicit_invocation: false。两者语义等价但实现位置不同前者在 SKILL.md 的 frontmatter后者在agents/openai.yaml一处遗漏就会让技能在某个 harness 上隐身。三、v1.2.0双 harness 架构、技能晋升潮与重大重构v1.2.0 是本仓库历史上内容最密集的版本包含 5 个 Minor Changes 和 5 个 Patch Changes。1. Codex 元数据一套技能集两个 harnessPR #551 为每个技能的SKILL.md旁边新增了agents/openai.yaml携带 Codex UI 元数据interface.display_name、interface.short_description。所有用户主动调用的技能都标记了policy.allow_implicit_invocation: false——这是 Claude Code 的disable-model-invocation: true在 Codex 中的对应物作用是让 Codex 将其排除在隐式调用之外同时保留显式$skill调用。仓库还通过AGENTS.md作为CLAUDE.md的符号链接让 Codex 读取相同的仓库指令。这样一套源文件两个 harness 各自消费无需生成两份拷贝。2. to-questionnaire 与 wizard 晋升为正式技能to-questionnaire晋升至 Productivity 桶将一个你无法独自回答的决策转化为面向唯一能回答之人的 Markdown 问卷。它的核心设计是拷问发送而非主题普通 grilling 会话审讯主题但这里恰好是你无法回答的部分因此访谈只问问卷发给谁、你需要拿回什么并把每个问题对准两者之间的缺口。该技能与 skills/productivity/to-questionnaire/SKILL.md 对应并在ask-matt中作为/grill-me的逆向路线拷问别人而非自己。wizard晋升至 Engineering 桶且设为model-invoked生成一个交互式 bash 脚本引导人类完成只能由人工执行的步骤——第三方配置、一次性迁移、A→B 状态转换。模板 UX 已由 skills/engineering/wizard/template.sh 完整解决逐阶段进度、确认门、跨平台 URL 打开含 WSL、隐藏式密钥输入、幂等的.envupsert、gh secret/gh variable写入含优雅降级、收尾跳过摘要。STAGES标记之上的部分是固定库从不手工编辑技能的唯一职责是界定流程并编写各阶段。它属于 Engineering 而非 Productivity因为它要读取.env*、docker-compose*、框架配置以及.github/workflows/中的每个secrets.*/vars.*引用来界定范围、写入 CI 密钥并用bash -n与shellcheck校验输出。关键设计点model-invoked 只会增加 Agent 的触达能力手动输入/wizard依然照常工作。其 description 被写成触发指针产物形态 四个触发分支供应基础设施、配置凭证或 CI 密钥、走陌生的第三方控制台、一次性迁移或切换 一个显式非触发条件Agent 自己能做的步骤绝不调用。3. prototype 重塑单一可分享 HTML 原型即一等证据PR #763 将 skills/engineering/prototype/SKILL.md 重塑为两个核心观念演示 一个可分享的 HTML 文件逻辑分支现在产出单文件自包含产物纯 HTML/CSS/JS无构建、无服务器非开发者双击即可打开用自己的领域语言操作带标签的状态面板、始终可用的自由操作按钮、一组标签页化的引导式走查每个场景带其下按序要按的按钮。可移植的纯逻辑模块仍可提取进真实代码HTML 外壳才是可丢弃的部分。原型 主要证据primary source可丢弃不再是删除。原型回答完问题后被捕获为可运行证据提交到主分支之外的临时分支prototype/name并在实现 issue 上留下上下文指针——主分支只保留已验证的决策而探索过程始终可追溯。结论判定 问题仍持久化在 issue/ADR/commit 中。4. Claude Code 插件从复制文件到订阅托管包PR #536 是本仓库分发模型的分水岭技能集作为原生 Claude Code 插件上架到官方市场可订阅为受管只读包claude plugins install mattpocock-skills或会话内执行/plugin install mattpocock-skills无需手动添加市场——官方市场默认已配置。.claude-plugin/plugin.json携带完整插件元数据版本、描述、作者、许可证、关键词与显式的正式技能列表skills.sh仍是通用安装器也是 Codex 等 harness 目前唯一路径。原生 Codex 插件被推迟原因是为什么以 Claude Code 插件形式发布的架构决策记录。值得注意的是插件订阅与 skills.sh 复制两种方式哲学不同前者随发布自动更新后者把技能文件复制进项目供你自由改造——两者只能选其一同时安装会导致每个技能出现两份。5. wait-what一个词纠正模型啰嗦PR #751 新增 skills/productivity/wait-what/SKILL.md当一条消息没被理解时输入它Agent 会用补充上下文、ASD-STE100 简化技术英语以及CONTEXT.md中的统一语言重新表述。机制就在于这个名字——描述输出的名字如/tldr会让模型裁剪词句而丢失更多信息描述听者状态的名字同时索要两个半场更少的词 你缺失的上下文。它还复用你全局CLAUDE.md中已有的引导词使技能、CLAUDE.md与每个CONTEXT.md触达相同的词元。它只修复一条消息不预防下一条——预防需要/grill-with-docs提前共建共享语言。6. wayfinder决策票据 子代理烧尽研究票据PR #763 同时重构了 wayfinder 的核心词汇决策票据decision ticket人们总把 wayfinder 票据读成普通实现票据但 wayfinder 用它承载的是决议即决策的问题。技能描述与开场白现在引入该术语CONTEXT.md将其登记为领域术语避免与避免使用 ticket的既有指导矛盾。研究票据由子代理并行烧尽创建票据后图表会话为每个研究票据派发一个/research子代理并行处理把发现提交到临时的research/name分支并留下上下文指针。研究票据是一个会话一个票据规则的唯一例外。7. 破坏性变更writing-great-skills → writing-for-agentsPR #763 将参考技能重命名并重构为 skills/productivity/writing-for-agents/SKILL.md覆盖范围从技能扩展到 Agent 消费的任何文档技能、AGENTS.md/CLAUDE.md、指针可达的文档。GLOSSARY.md并入SKILL.md技能专属机制frontmatter、model- vs user-invoked、路由技能、按调用切分剥离到新的 SKILL-MECHANICS.md技能改为model-invoked。注意新名无别名旧名已消失需重新安装。同时其裁剪章节新增cache概念单一事实源延伸到文档之外——package.json脚本、配置文件、目录布局、--help输出本身就是权威因此重申它们的文档是查找的缓存只有在查找昂贵时才值得加载。正向目标是缓存 Agent 无法通过查看找到的内容未成文的约定、选择背后的原因、配置不承认的坑而把单文件、单命令的查找留给环境——那里不会过期。8. improve-codebase-architecture 的 YAGNI 过滤PR #533 为 Explore 步骤添加 YAGNI 范围过滤不再均匀扫描整个仓库而是聚焦变化实际落地的区域——若你指定了方向则取方向否则读取最近约 20 条 commit message把探索向活跃开发的路径倾斜。无人触碰的代码中的深化机会是永远不会兑现的重构。9. ask-matt 路由器锐化阶段边界与 wayfinder 路由阶段边界Crossing sessions两行小节被替换为携带全部五个选项的决策树——continue、/clear、/handoff、subagent、/compact推理过程披露在新的 skills/engineering/ask-matt/PHASE-BOUNDARIES.md。三个修正/handoff被高估了它很窄只在有东西必须旅行新 harness、新目录、同事、中途分叉的侧任务时才需要买来的是可移植性。/compact是默认项而非首选它位于决策树底部排在四个更便宜或更精确的问题之后。从那里开始会产生一个对摘要压平内容自信地错误的会话。两个分支原本完全缺失continue是首先应排除的选项它是唯一保持对话作为主要证据而非其摘要的移动subagent处理任何范围紧到可以 AFK 运行的任务。智能区图示也从约 12 万 token 更新到约 15 万 token。wayfinder 路由纠正两个最常犯的错误——过度使用比单次 grilling 更慢更重只留给一个会话装不下的大想法范围明确的特性应走/grill-with-docs与交接时迷路地图清空后 wayfinder 是交接而非构建应并入/to-spec主流程而不是直接把地图循环进/implement。此外/grilling与/resolving-merge-conflicts此前完全缺席路由器现已补入grill-me与grill-with-docs依据是否在工作目录中分叉。10. setup-matt-pocock-skills 友好化PR #502 调整安装体验Triage 标签仅在triage技能已安装时才询问且简化为单个保留默认 triage 标签的建议性问题未安装时整节含 skills/engineering/setup-matt-pocock-skills/triage-labels.md跳过。外部 PR 作为请求面不再作为安装问题模板仍保留标志默认关闭可在 issue-tracker-github.md 等处翻转。领域文档默认单上下文不再询问仅当仓库呈现 monorepo 信号时才提供多上下文选项。本地 Markdown 票据改为每个票据一个文件.scratch/feature/issues/NN-slug.md绝不再用单一合并的tickets.md/to-tickets与本地 tracker 模板保持一致规格文件统一为spec.md以匹配/to-spec。11. grilling 重构从一问一答到按轮次推进PR #593 重写了 skills/productivity/grilling/SKILL.md 的节奏映射决策树后把整个前沿所有前提已定的问题放进单个编号轮次然后根据用户回答重算前沿进入下一轮。同样的 13 个问题约 3 轮即可结束而非 13 轮。环境能回答的事实分派给后台子代理研究从不阻塞轮次。每轮中每个问题以固定形状发射❓ **Q1** - **标题**正文散文或多选后跟独立➡️行的推荐。grill-me、grill-with-docs与triage也按轮推进前沿一问一答的退出方式全局CLAUDE.md中的一行不变。12. 移除六个技能合流与告别PR #752 从仓库移除六个技能。四个退休技能分别被更优技能吸收ubiquitous-language→/domain-modeling构建维护整个领域模型而非一次对话倾倒词汇表design-an-interface→/codebase-design设计两次技术以 DESIGN-IT-TWICE.md 形式内置于该技能qa→/triage与/to-ticketsrequest-refactor-plan→/to-spec与/improve-codebase-architecture另有两个从未打算公之于众的个人技能edit-article与硬编码了作者本机 Obsidian 库路径的obsidian-vaultpersonal/桶随之移除。deprecated/桶保留但已空置in-progress/被如实描述为测试渠道——有意公开、逐技能可装。13. to-prd → to-spec 收尾PR #734 完成重命名收尾spec 成为交付文本中唯一术语。to-spec不再以你可能知道这份文档叫 PRD开头skills/engineering/to-spec/SKILL.md 与其文档页删除括号说明code-review在 frontmatter 描述、双轴摘要与 spec 来源搜索顺序中改用 issue/specGitHub 与 GitLab tracker 模板统一为Issues and specs for this repo live as GitHub/GitLab issues——此前它们更新本地模板时被留在 PRDs 上过期术语因而传播进每个被写入的仓库。四、v1.1.0技能沉淀、评审硬化与规划统一1. ask-matt 路由器全面对齐PR #406 将 skills/engineering/ask-matt/SKILL.md 更新到完整技能集补齐tdd融入主流程作为implement驱动的红绿引擎、diagnosing-bugs新增 Somethings broken 入口、domain-modeling与codebase-design新 Vocabulary underneath 小节、grilling共享访谈原语。prototype充实为独立路线。CLAUDE.md新增维护规则任何技能新增/改名/删除或流程变更都必须触发ask-matt复查。2. code-review 晋升 Fowler 气味基线PR #464 将review重命名为 skills/engineering/code-review/SKILL.md 并晋升到engineering/model-invoked。其核心是双轴评审固定点与HEAD之间的 diff 沿两条独立轴线并行审查两个子代理互不污染上下文Standards是否符合仓库文档化的编码标准Spec是否忠实实现源起 issue/specStandards 轴始终携带气味基线——内置于 SKILL.md 的固定 Fowler 代码气味集《Refactoring》第 3 章约 12 个高信号气味Mysterious Name、Duplicated Code、Feature Envy、Data Clumps、Primitive Obsession、Repeated Switches、Shotgun Surgery、Divergent Change、Speculative Generality、Message Chains、Middle Man、Refused Bequest。两条约束规则保障安全文档化仓库标准覆盖基线每个气味都报告为判断性结论绝非硬性违规。双轴分离的意义在于一个变更可以只过一轴符合所有标准但实现了错误的东西 → Standards 过、Spec 挂精确实现了 issue 要求但破坏项目约定 → Spec 过、Standards 挂。分离报告防止一轴掩盖另一轴。3. grilling 双刃确认门 事实/决策二分确认门Agent 在用户确认共享理解已达成之前不得实施计划把既有完成判据变成显式停止门。description 还招募了预训练的grill引导词增强触发。事实 vs 决策grilling 现在区分_事实_查询——探索代码库与_决策_每个都提交给人类等待回答。旧的一揽子说法——若问题可通过探索代码库回答就探索——在另一个技能于解析票据框架内运行 grilling 时会被误读为可自主回答_决策_的许可。二分后grilling Agent 无法抢跑自答。4. writing-great-skills 的否定与负空间PR #463 为写作技能增加两个相邻的 Steering 失败模式Negation大象——用禁止来引导说出不要做什么会把被禁行为拖进上下文使其_更_可用别想大象解药是提示正面行为Negative Space虚空——对省略所造成的引导的失明每个被拒绝的决策都委托给 Agent 的先验而非保持中立解药是审读草稿的沉默处逐个决定每处省略填上或作为真正的分支保持开放。两者作为独立条目保留诊断与解药不同各自是完整的GLOSSARY.md条目加SKILL.md失败模式要点。5. prototype 改为 model-invokedresearch 技能诞生prototype设为 model-invokedAgent 可自主触达其他技能也可。description 围绕引导词prototype重写——回答设计问题的可丢弃代码——每个分支一个触发状态/逻辑健全性检查或 UI 探索。researchPR #409小型的 model-invoked 技能派发一个后台 Agent依据一手来源官方文档、源码、规范、第一方 API调查问题然后在仓库存放此类笔记之处留下单一引用型 Markdown 文件。它被列为 skills/engineering/research/SKILL.md在ask-matt中路由为 Standalone。6. to-issues 的宽重构处理PR #469 将to-issues拆分为精简的Process与Reference两节并教会它处理宽重构——单个机械变更如重命名列的爆炸半径横跨整个代码库一次编辑破坏数千调用点任何垂直切片都无法全绿。对策是expand–contract切片先扩展旧形式旁新增新形式什么都不破坏再按爆炸半径分批发迁移调用点最后收缩删除旧形式当分批也无法单独保持绿时让它们共享集成分支所有批次共同阻塞最终的集成验证票据。7. 规划技能统一to-prd → to-specto-issues 合并进 to-ticketsPR #464 确立idea → /to-spec → /to-tickets → /implement主线。to-spec成为贯穿术语to-ticketsskills/engineering/to-tickets/SKILL.md把计划、规格或会话拆为一组票据——tracer-bullet 垂直切片每个声明其阻塞边。同一产物因 tracker 不同而有两种读法本地文件每票据一个.scratch/feature-slug/issues/NN-slug.md按依赖序编号阻塞先以文本写边真实 trackerGitHub、Linear写原生阻塞链接任意阻塞完成的票据都在前沿上可多 Agent 并行。发布优先使用 tracker 的原生子 issue 与原生阻塞边## Parent/## Blocked by正文节作为回退。8. wayfinder 重塑目的地引导词 原生阻塞PR #464 将decision-mapping重命名为wayfinder作为规划超过一个 Agent 会话承载的大块工作的技能晋升至 Engineering。重塑内容目的地作为引导词命名目的地是绘图的第一个动作确定范围并塑造每个票据地图新增## Destination字段。计划而非执行地图产出决策而非交付物在无人开始构建前无剩可决时即完成。地图是索引而非存储决策只活在一处——它的票据地图只摘要和链接从不复述。默认协作地图移到仓库 issue tracker成为单一wayfinder:mapissue票据为其子 issue会话低分辨率加载地图按需放大到票据。保持 tracker 无关GitHub、GitLab、本地 Markdown指向由setup-matt-pocock-skills写入的 tracker 文档。按指派认领而非标签会话通过把票据指派给驱动开发者认领——被指派者即认领。原生阻塞优先 tracker 原生依赖关系在前沿 UI 中可视化渲染。迷雾与超范围分离## Not yet specified范围内迷雾随前沿推进毕业与## Out of scope超出目的地的工作永不毕业。第四种task票据类型字面手工工作开通访问、移动数据、注册服务是唯一执行而非决策的类型。HITL / AFK 分类每个票据类型是 HITL人机回环——grilling、prototype或 AFK仅 Agent——researchtask 两者皆可。HITL 票据只能通过现场交流解析等待人类从标签中脱落——自答问题的 grilling Agent 按定义已破坏 HITL。无迷雾提前退出开场广度优先 grilling 未浮现迷雾则旅程小到单会话可承载停止并询问如何继续。配套的 Patch 修复了 wayfinder 硬编码 tracker 文档路径的问题此前破坏整套技能依赖的间接层wayfinder 现在通过### Issue tracker指针解析文档并按名称读取其 Wayfinding operations 小节。9. tdd 重塑为纯参考技能 同义反复测试反模式PR #464 将 skills/engineering/tdd/SKILL.md 重塑为 reference-only红→绿→重构循环由模型已持有的引导词锚定逐步 Workflow 大多在复述循环因此被删除垂直切片 / tracer bullet 并入反模式节。引入seam作为测试位置的引导词只在预先商定的接缝处测试写任何测试前先与用户确认。重构阶段被移除TDD 现在只有红→绿重构属于评审阶段规则移入code-review。新增同义反复测试反模式断言按代码计算方式重算的测试因构造而通过置信度为零——区别于已有的实现耦合反模式以同级方式落地哲学原则期望值必须来自独立事实源、清单门、以及tests.md中 BAD/GOOD 示例对。10. triage 支持外部 PRto-issues 相关路径清理triage扩展为可处理外部 pull request把 PR 视为附带了代码的 issue走相同角色与状态机由 per-repo 设置开关门控。补丁同时修正了to-issues、to-prd、triage的间接层一致性。五、v1.0.x奠基与发布1. v1.0.1teach 技能复用优先skills/productivity/teach/SKILL.md 改为复用优先课程由./assets/中的可复用组件样式表、测验小部件、模拟器、图示辅助构建。复用是默认行为Agent 编写课程前先读./assets/从既有组件构建任何新的可复用内容都提取为组件而非内联。2. v1.0.0首个正式版本ask-matt路由器用户主动调用的路由器为你的处境指出正确的技能或流程。破坏性它路由本仓库其他用户主动调用技能因此要求这些技能已安装。共享设计技能新增 skills/engineering/codebase-design/SKILL.md深模块词汇module、interface、depth、seam、adapter以及在小接口后放置大量行为的原则与 skills/engineering/domain-modeling/SKILL.md主动构建并打磨项目领域模型对照词汇表压力测试术语保持CONTEXT.md与 ADR 最新。improve-codebase-architecture、tdd、grill-with-docs均改依赖这两个共享技能。破坏性这些技能现在依赖新技能必须一并安装。技能增删移除caveman重复且从未打算公开与zoom-out实践中未使用diagnose重命名为/diagnosing-bugswrite-a-skill被writing-great-skills及其GLOSSARY.md取代grilling暴露为 model-invoked。调用分类学确立技能分类从Commands / Skills更名为User-invoked / Model-invoked。用户主动调用的技能只有输入时才可及职责是编排模型调用的技能在任务契合时还可被自动触达承载可复用纪律。用户主动技能可调用模型调用技能但绝不调用另一个用户主动技能。这一分类学贯穿 README.md、各桶 README 与文档是理解整个仓库结构的钥匙。其他新增resolving-merge-conflicts解析进行中 git merge/rebase 冲突的循环无技能依赖review技能收紧fail-fast 引用检查、单一事实源规则、no-op 删减。六、从 CHANGELOG 看仓库架构主线纵览 1.0.0 → 1.2.3CHANGELOG 透露出几条贯穿性的架构主线双 harness 战略Claude Code 插件受管只读包与 skills.sh可编辑拷贝双分发agents/openai.yaml与 frontmatter 双元数据AGENTS.md与CLAUDE.md双指令文件——一套源文件服务多个 harness。User-invoked / Model-invoked 二分从 v1.0.0 确立分类学到 v1.2.2 修复writing-for-agents的误分类再到 v1.2.0 将wizard与prototype转向 model-invoked 以扩大 Agent 自主触达这条线持续演进。技能收敛与合并多个重复技能ubiquitous-language、design-an-interface、qa、request-refactor-plan、write-a-skill、to-issues、to-prd不断合流到更少、更深的技能中——这与仓库推广的深模块设计哲学自洽。引导词leading word驱动的写作哲学grill、prototype、seam、tight、red、fog of war等预训练概念被反复回收为触发词详见 writing-for-agents/SKILL.md。tracker 无关的间接层所有技能通过setup-matt-pocock-skills写入的### Issue tracker指针解析 tracker 文档wayfinder 曾因绕开此间接层而埋下 bug正反案例都记录了。七、如何跟进后续版本仓库将 CHANGELOG 视为唯一事实源配合三处同步机制scripts/link-skills.sh把技能符号链接进本地 harness 目录~/.claude/skills、~/.agents/skillsgit pull 即可保持安装技能更新scripts/sync-plugin-version.mjs保证插件版本与包版本一致CLAUDE.md的维护规则要求技能增删改后同步ask-matt路由器与文档页。阅读 CLAUDE.md 可掌握仓库的完整维护约定例如promoted 桶engineering/、productivity/中的技能必须出现在顶层 README 与.claude-plugin/plugin.json中且需在docs/bucket/有对应文档页。对正在使用或扩展该技能集的工程师而言CHANGELOG 不只是变更记录更是一份架构决策日志——每个版本的为什么都写在对应的 SKILL.md、模板与 ADR 里值得对照源码逐条消化。【免费下载链接】skillsSkills for Real Engineers. Straight from my .agents directory.项目地址: https://gitcode.com/GitHub_Trending/skills13/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考