## Why fork 后项目与脚手架之间没有清晰的「可定制面」约定,业务代码容易混入框架目录,导致上游升级时 merge 冲突频繁、无法干净同步。需要把「框架只读 / 业务落点 / 数据驱动扩展点」固化为 spec,作为 fork 升级的契约。 ## What Changes - `shared/platform` 新增「脚手架可定制面」需求:三条铁律(框架代码只读、业务代码独立落点、定制走扩展点)。 - `docs/guide.md` 补「升级同步(git upstream + merge)+ 可定制面」章节。 ## Capabilities ### Modified Capabilities - `shared/platform`: 新增「脚手架可定制面」约定。 ## Impact - 无代码变更;仅 spec + 文档。