用途:MicroPatch 用于把 fork 相对上游项目的定制改动,整理成带版本号的语义化规范,使功能在上游更新后仍能存在并正确工作,即使原始 diff、rebase 或合并流程已不可靠。它适用于已有 fork 想沉淀定制,或想让已记录的定制在新上游版本上继续生效。
主要能力:每个 MicroPatch 独立成文件夹,包含 micropatch.md,可选 hints.diff(仅作提示,不可机械应用)和 files/(存放大型新增文件)。micropatch.md 至少包含 What It Is、Intent、Scope and Non-Goals、What It Does、Dependencies and Assumptions、Implementation Reference、Anchors、Definition of Done、Notes for Future Re-application 等章节,并带 version 及可选元数据。
使用方式:技能有两种模式。Create 模式把现有 fork 的定制提炼为一个或多个 MicroPatch;Apply 模式把已记录的 MicroPatch 重新应用到更新或全新的上游代码库。执行前应阅读 references/create.md、references/apply.md、references/rules.md,并参考 examples/。若用户两者都要,先创建或完善 MicroPatch,再应用。
适用场景:fork 功能需要跨上游版本长期保留;上游结构变化导致旧补丁失效;需要明确功能契约与验收标准。
限制:MicroPatch 不是原始补丁文件,不保证自动干净应用;上游大幅变化时需按当前代码结构重新实现,而非塞回旧代码。若上游已实现部分功能,不应重复。hints.diff 与 micropatch.md 冲突时以 micropatch.md 为准。成功与否由 Definition of Done 判定。具体安装命令、收费与平台信息暂未提供。