用途
editor-spec 是 udecode/plate 仓库中处理编辑器行为规格(spec)的工作流。它的目标是把关于编辑器行为的想法或改动,转化为真正的 Plate 规范,而不是停留在聊天讨论中。它同时适用于两种场景:为新出现或新正式化的编辑器表面定义规范,以及在现有文档、胜出参考或协议行出错或不完整时更新既有规范。
主要能力
该工作流把编辑器行为的权威来源、可读规范、穷尽场景与当前门禁状态分别对应到不同文档:权威来源对应 markdown-standards.md,可读规范对应 markdown-editing-spec.md,穷尽场景对应 editor-protocol-matrix.md,门禁状态对应 markdown-parity-matrix.md,证据历史对应 markdown-editing-reference-audit.md。它要求在做规范决策前先阅读这些文档以及研究层的相关说明。
在工作方式上,它要求先做研究决策,默认通过 research-wiki 选择并运行合适的研究模式;当主题已存在于研究中、只需刷新或清理矛盾时使用 research-maintain;当主题较广、证据缺失或陈旧、权威问题较大时使用 research-full。它还要求使用证据阶梯,把证据记录为 agree、partial、gap、tension 或 diverge,并明确不得因为某个行为“看起来标准”就将其标记为已锁定。
使用方式
该工作流要求按固定顺序编辑文档:先补标准(standards),再补可读规范(readable law),然后是协议行(protocol rows)、一致性门禁(parity gate)、路线图(roadmap),最后才在必要时补审计(audit)。每次有意义的 editor-spec 处理都应返回权威决策、更新的文件、胜出地图或规范的变化、一致性是否改变、审计历史是否改变,以及仍缺乏证据的部分。
在节点模型方面,它要求在编写 UX 规范之前先锁定节点模型与亲和性类别,并给出模型类别(block non-void、block void atom、inline non-void span、inline void atom、leaf mark、text token、overlay / no node)与亲和性类别(directional、hard、outward、none / n-a)。在模型明确之前不得规定 hover、click、backlink、工具栏行为。
适用场景与限制
它适用于现有当前特性行为的更新、现有当前特性的新交互类别、新增当前特性家族或新正式化的当前表面、延迟或未来特性、新的权威或胜出者转移,以及仅架构层面的规范问题。它也要求对功能家族进行分类,例如 markdown 原生语法、markdown 模式架构与笔记链接导航、块编辑器原生元素、表格与线性文档编辑、协作或仅编辑器、样式与布局、跨表面交互。
限制方面,该资料未提供该技能的收费、价格、平台或具体代码示例信息,暂未提供。它强调不应默认走 deep-interview 或 ralplan,只有在用户意图模糊、范围边界不清、缺少成功标准等情况下才升级到 deep-interview,只有在规范工作演变为真实实现或发布计划、存在多条可行架构路径等情况下才升级到 ralplan。它还要求不得让当前文件放置位置左右长期设计,并应为契约选择最佳的长期归属位置,包括 core 与共享插件与特性包与渲染层之间的选择。