技能介绍

解决什么问题

技能仓库中的 SKILL.md、references/、CHANGELOG.md 与上游包、规范或文档会随时间漂移。人工更新常漏三类信号：上游已发布的变更、技能尚未覆盖的新概念，以及从真实使用中反复出现的误区。等到 CI 失败、技能描述过期或合并后泄漏隐私才处理，成本更高。

核心能力与工作流

预读阶段并行读取 skills/<skill>/SKILL.md、references/ 下所有文件和可能存在的 CHANGELOG.md，记录 metadata.version、metadata.upstream、最后验证日期与最后 Git 改动。
并行启动三个调研角度：上游 releases/commits/PRs、当前规范或文档、真实使用中的坑。若可用 mcp__pond__pond_search，它只作为待验证线索；未安装则明确跳过 usage 角度。
核验不停留在二手摘要：每条 findings 都要回到今天读到的 primary source 确认，coverage gap 还需用 grep 排除同义改写，避免把已存在能力误判为缺失。
输出结构化报告：包 diff、metadata.upstream 建议、CHANGELOG 条目、原子化编辑行、新概念覆盖表或明确 none、bootstrap 建议。随后进入 GATE 1；未获 yes / yes all / 指定行 / drop / changes 等明确答复前，不调用 Edit 或 Write。
应用修改时更新 metadata.upstream（拒绝浮动 tag）、按仓库规则升 metadata.version、追加 Keep a Changelog 条目；若 bootstrap_needed 则补种子 CHANGELOG。
在仓库根目录跑定义好的校验命令；本仓库通常是 just check，它还会重新生成 README.md。
提交前做隐私/泄漏扫描，覆盖 skills/<skill>/ 与生成的 README.md：密钥、个人数据、内部仓库名、主机名、ticket ID、本地路径、pond session ID 都可能成为硬阻断项。
打印 diff 后进入 GATE 2；只有明确确认才提交。默认分支上 push 并关注 CI；特性分支上 push 后开 PR。禁止 --no-verify、--amend、force-push，除非本次显式授权。

适用边界与注意点

适合需要定期跟踪上游、文档或社区反馈的可维护技能；对无上游的写作/工作流技能，也应只补 CHANGELOG 与基础状态，而不是伪造 metadata.upstream。session 在两道闸门之间中断后不能断点续跑，必须重新执行 /update-skill。报告先于修改，任何 revision 都重新发 GATE 1，不会静默落盘。