North-Star 是 Plate 面向可复用架构与公共 API 设计的「宪法级」准则,属于上游决策层,负责架构法规、公共 API 形态、分层、性能/可扩展性选择与反模式目录。资料未提供安装命令或具体代码。
适用场景:引入或变更可复用公共 API;设计构建器/工厂模式、插件/扩展注册模式、运行时/服务边界、缓存/投影/协议层/服务接缝;在易用性与性能形态之间取舍;重命名或重分层可复用 API 家族;归属或架构层不明确时。
不适用场景:仅应用内便捷封装、一次性迁移辅助、公共模式已定型只需实现插件机制、仅涉及公开文档措辞、或属于 git/流程工作而非可复用 API 设计。
路由规则:涉及可复用公共/编辑器平台 API 或运行时/服务边界架构时先用 north-star;在可复用 API 设计与实现间含混时先向上路由到 north-star;应用内便捷封装、公共模式已定型后的插件执行则交由 plate-plugin-creator。
归属划分:north-star 负责可复用架构准则、公共 API 形态、运行时/服务边界模式、分层与归属法规、性能/可扩展性法规、反模式目录;执行伴随技能负责插件文件放置、包装器与类型机制等实现;应用本地糖归本地。
文件组织:宪法层含 laws.md、decision-ladder.md、performance-selection-rules.md、update-policy.md;模式层含 pattern-catalog.md、anti-patterns.md。
工作流:先跑决策阶梯与确定归属和层,查模式目录,扫描重复的 resolve()/apply() 形态并区分匹配器逻辑与功能语义,在敲定更美观 API 前先跑性能选择协议,检查反模式,若引入或实质变更可复用公共模式则遵循更新策略,随后把实现机制交由具体执行技能。
匹配器抽取启发式:多包重复相同匹配前奏时倾向抽为核心里原语(触发门控、折叠选区门控、块起始/前置文本/相邻字符查找、分隔符/前缀/正则匹配、范围或载荷构造等与功能无关的编辑器状态检查);重复语义变换(节点创建、标记切换、列表变换、链接校验或插入、公式插入、代码块插入等)仍留在功能包。核心负责匹配原语与共享输入状态访问,功能包负责语义 apply 行为。
重申契约:引入或实质变更可复用公共 API、运行时边界、构建器/工厂模式或扩展契约的每个通道,须包含「north-star updated」或「north-star reaffirmed: <章节名>」,须命名治理章节。二元审查清单:是否命名归属、命名层、判定可复用与本地、命名治理章节、热路径相关时是否应用性能协议。
与其他技能关系:plate-plugin-creator 为插件编写执行伴随;docs-creator 为公开文档伴随;react 为 React 实现伴随。资料未提供收费、平台或具体使用命令等信息。