用途:属于 my-skills-maintenance 的一个分支,用于按需回答“是否有待处理项”,并保持 pending-update issue 的真实性。检测本身由每日 CI 的 Vendor freshness check(无人值守、只读)承担;本分支负责按需读取,以及关闭过期未处理 issue 的场景,修复工作则路由到 my-skills-vendor-sync 技能。
主要能力与覆盖:覆盖边界用例清单 C1–C8。开启的 issue 会列出待处理类别(added / updated / removed kept-local / patched-differs / patched-removed,外加一行最新发布上下文);本分支会重新推导,绝不把 issue 正文当作事实依据(C7)。
使用方式:
- 查找 pending-update issue:gh issue list --state open --label pending-update;若开启则查看其正文。
- 通过全新 dry-run 重新推导:node scripts/vendor-sync.mjs --dry-run;按 my-skills-vendor-sync 技能第 1 步的方式对每个待处理项分类。新鲜度检查本身也会拒绝非 dry-run 的汇总,本分支同样如此。
- 关闭过期项:若无待处理项却仍有开启的 issue,则按 docs/agents/issue-tracker.md 以一次写入将其作为 stale/completed 关闭(#16 情形;C4)。create-on-pending(C1)与 auto-close-on-current(C3)属于 CI 的职责——本分支只关闭 CI 看不到的情况。
- 报告:说明有哪些待处理项及各自在何处修复;用户想动手时路由到 my-skills-vendor-sync 技能。
完成条件:用户获得准确的待处理情况,或经提议并确认的过期关闭已完成。
限制:本技能从不创建 pending-update issue(C1 留在 CI;create 与 open 的竞态属于 CI 每日一分钟窗口,C2)。同步错误不触碰 issue(C5)——dry-run 失败即报告并停止。