原型作者检查清单
在提交一个新原型或大改动之前,先过一遍这张清单。
这不是一张形式化模板。
它的作用是帮你在动手前或提交前,快速判断自己是否已经偏离了 Proto UI 当前更看重的方向。
一、我真的需要新的原型吗?
Section titled “一、我真的需要新的原型吗?”- 我面对的是新的交互主体,而不只是新的风格吗?
- 现有原型和现有
asHook真的都不够吗? - 我做的不是把已有能力重新拼一遍吗?
如果这里有明显的“否”,先回到 为什么你通常不需要新写一个原型?。
二、边界是否切对了?
Section titled “二、边界是否切对了?”- 这个对象是否真的构成独立的交互主体?
- 我有没有把本该拆开的 part 继续塞在同一个原型里?
- 我有没有把没有独立信息通路责任的局部结构硬拆成新原型?
如果这里不确定,回到 原型边界。
三、我写的是交互语义,还是宿主实现?
Section titled “三、我写的是交互语义,还是宿主实现?”- 我有没有把宿主私有行为写死在 prototype 里?
- 我有没有过早依赖某个框架特有的组织方式?
- 我是不是把某种 adapter 层的补全责任误写回原型了?
四、如果这是复合原型,family 是否清楚?
Section titled “四、如果这是复合原型,family 是否清楚?”- anatomy family 的 role 是否明确?
- cardinality 和 relation 是否合理?
- root、part、shared 的职责是否分开了?
- context 里放的是共享语义,而不是一堆杂项吗?
五、如果这是风格库,它是否真的建立在 base 之上?
Section titled “五、如果这是风格库,它是否真的建立在 base 之上?”- 我是在叠加
variant、size、style token、rule 吗? - 我是不是重新定义了本应复用的基础交互?
- 我有没有优先从现有
base原型或asHook长出来?
六、别人未来是否还能复用它?
Section titled “六、别人未来是否还能复用它?”- 这段能力是否值得抽成
asHook? - 暴露出去的 state / method 是否具有稳定意义?
- 这份实现是否会迫使别人重复写一遍类似逻辑?
七、后续验证是否已经有方向?
Section titled “七、后续验证是否已经有方向?”- 这个原型最关键的行为边界是什么?
- 哪些部分未来需要被契约化?
- 哪些行为值得进入 contract tests?
Proto UI 不要求你一开始就补齐全部验证,但它要求你至少知道哪些地方未来必须被验证。