用途:这是 my-skills 聚合仓库所有维护流程的单一入口,取代已退役的 consolidate-strays 与 my-skills-vendor-sync。一个技能分六个分支,每个分支的步骤存放在按需加载的 reference 中。
主要能力(按分支):解决待处理更新时执行同步、三方合并已打补丁文件、更新 pin(references/vendor-sync.md);合并或恢复游离技能(references/stray-recovery.md);记录补丁偏离(references/patch-record.md);检查新鲜度、读取或关闭待更新 issue(references/freshness.md);分发到规范存储或退役技能(references/distribute.md);把基线升级滚动进使用方的 CODING_STANDARDS.md(references/standards-update.md)。若请求跨分支(如先同步再分发),按 vendor-sync → distribute 顺序执行,不得并行。
共享规则:先从 ~/.agents/.my-skills-repo 读取一行仓库锚点 $REPO,不要假设当前目录即仓库;需验证目录存在、git -C "<path>" remote get-url origin 以 /my-skills 结尾、且拥有 scripts/vendor-sync.mjs;失效或缺失则询问新位置(或提议从 GitHub 重新克隆)并写回锚点。所有 git 写入、gh issue 操作和 store 变更都需先向用户提议并等待明确同意;默认运行为只读。验证方式为脚本测试 node --test "$REPO"/scripts/*.test.mjs 与一次全新的 dry-run;任何 issue 操作前 git status --porcelain 需干净。编辑技能内容前先加载 writing-for-agents。概念命名使用 GLOSSARY 术语。每个分支结束都以同一组提议收尾:commit → push → issue 关闭/分发,作为一个提案等待确认,未经同意不做任何远端或破坏性操作。
使用方式:每次运行先执行强制性的游离检查 dry-run:node "$REPO/scripts/consolidate-strays.mjs",通读完整报告(默认只读),每个 store 技能会被归类为 current、new stray 或 modified stray。出现游离则先加载 references/stray-recovery.md 处理(采纳、恢复或明确拒绝),否则下一步分发会覆盖它;零游离才进入所请求分支。standards-update 分支例外,它不触碰 skills/ 和 store。
限制:资料未提供该技能的安装方式、收费情况、支持平台与运行环境要求;实际执行依赖本地仓库锚点有效且脚本存在,无效锚点会报错而非静默通过。