用途:在 my-skills 仓库中把对上游的一处偏差记录为 patches/<source>/ 下的一条机器可校验记录(位于 skills/ 之外,不会被扫描或分发),使 CI 能由固定 blob 加记录中的 hunks 重建本地文件并做字节比对。格式规范以 patches/README.md 为准,本分支负责写入与验证记录,覆盖边界清单 D1–D10。
何时写入或更新:合并重塑补丁时(my-skills-vendor-sync)重写记录的 summary 与 ## Diff;恢复被修改的 stray 时(my-skills-stray-recovery)先记录再改合并副本;补丁被上游采纳时改写为行为记录或删除;补丁被丢弃时 git rm 该记录。记录放在 patches/<source>/,镜像目标文件的本地路径;同一文件的兄弟记录用 after: 边表示堆叠 hunks,遵循 frontmatter 模式与 unified diff 形式,使用 LF。完成标准:记录含唯一 id、仓库相对 file、有效 verification、summary,且 diff 校验型记录恰有一个标准 unified diff 的 ## Diff 块;行为型记录则带 ## Static assert 与 ## Live check。
机械验证:运行 node scripts/verify-patch-records.mjs,按 after: 顺序用 git apply 重建固定 blob 与各 diff 记录的 hunks,并与本地文件字节比对,对格式错误、缺失目标或不匹配会显式失败;多补丁文件需全部记录齐备且一致才通过。运行 node --test scripts/*.test.mjs 执行脚本测试套件(含验证器的离线测试)。完成标准:验证器输出 ALL CHECKS PASS 且测试套件全绿。
生命周期随保留或丢弃决定:丢弃则 git rm 记录及其保护的文件(若也丢弃);保留则在把副本迁到 skills/self/ 后改写为自撰(patches/self/,行为型)。完成标准:记录集合与同步绝不可覆盖的文件集合(file: skip set)一致,无过期项。my-skills-vendor-sync 第 4 步与行为记录的 ## Live check 配方需人工重跑,本验证器是 CI 覆盖的断言。限制:资料未提供更多安装、收费或平台信息。