@antprofuse/saddle-minifish 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +16 -2
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -7,18 +7,20 @@ description: 消费 Spec、Prototype、adapt、backend-contract 和既有 Minifi
|
|
|
7
7
|
|
|
8
8
|
这是项目工程研发规范，平台 API 以当前 Minifish 官方资料为准；CDP 探针是辅助接入工具，不是完整平台研发规范。
|
|
9
9
|
|
|
10
|
-
开始先安装并完整阅读 `@antprofuse/saddle-workflow@latest
|
|
10
|
+
开始先安装并完整阅读 `@antprofuse/saddle-workflow@latest`；默认其他 Skill 引用也使用 npm @latest；用户明确指定 PR/源码时遵循 workflow 的源码消费规则，记录实际解析版本，本轮不漂移。按其规则确认输入、权限及交接；包不可用不能默默用旧目录替代。
|
|
11
11
|
|
|
12
12
|
## 实现输入与主入口
|
|
13
13
|
|
|
14
14
|
读取当前分支范围内 Prototype、原始测试责任、实体/流程、adapt/ingress 和 backend-contract，并读 minifish-tests 的业务场景、覆盖和运行说明。默认产品目录 code/minifish，已有工程优先；不假设 PUC 域名、页面路径或业务字段。
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
每份后端契约有一个唯一的前端请求实现入口；仅所属页面同一语义起点的载体或 helper 可调用它；不同起点不共用契约。沿正式契约标识保持请求入口与后端注册入口的脉络。具体代码布局按当前正式工程规则，未批准命名提案不自动迁移。
|
|
17
17
|
|
|
18
18
|
页面通过标准平台生命周期接收已定义入参，包括直接带参打开；不以研发内存 session 代替真实入口。业务后端通信走 MobileGW，不另接直连 Saddle URL，不把可信身份放业务 payload。平台特殊字段依据正式平台合同，不凭经验补参数。
|
|
19
19
|
|
|
20
20
|
## 实现和验收
|
|
21
21
|
|
|
22
|
+
- 开始布局前核对测试中的语义承载与整体页面责任：原型模拟的原生导航不等于业务 DOM。按输入及真实平台选择承载，已有原生能力满足的逻辑元素不重复绘制；自定义导航按明确输入实现。
|
|
23
|
+
- 即使测试全绿，发现实际结果与输入冲突也要提交来源、实际结果及错误断言证据给测试建设方；不为迎合错误测试保留错误 UI，也不自行放宽独立验收。普通产品失败应在研发节点内部修复并跑完测试再交付。
|
|
22
24
|
- 原型决定页面消费与交互；后端契约决定请求/响应。金额、时间、null、枚举与失败分支逐项实现，不无依据补值或舍入。
|
|
23
25
|
- 展示逻辑留在前端；不是让后端提供页面拼接文案。数据归属、重复进入、等待与迟到响应按已确定要求处理。
|
|
24
26
|
- 不读取 backend 实现来建立隐性依赖；两侧除正式输入和契约外互为黑盒。
|
|
@@ -26,3 +28,15 @@ description: 消费 Spec、Prototype、adapt、backend-contract 和既有 Minifi
|
|
|
26
28
|
- 发现预期冲突，给出 Spec/契约条款、请求、场景及实际结果；没有依据不选择某个看似合理结果。独立且明确部分继续。
|
|
27
29
|
- 交付前完成工程现有编译/类型/格式检查和全部范围内黑盒，报告实际通过、失败、未运行与覆盖剩余责任。Mock 通过不证明真实后端、真机或发布。
|
|
28
30
|
- 报告、终态截图、trace 和实际结果写仓库外；源码提交、push 及平台上传分别按授权。不得为测试通过直接调页面内部函数、测试 hook 或替换产品页面。
|
|
31
|
+
|
|
32
|
+
## 契约身份交接
|
|
33
|
+
|
|
34
|
+
消费 @antprofuse/saddle-islands-design@latest 的 后端契约格式 和 @antprofuse/saddle-workflow@latest 的语义身份规范。契约 identity/id 由设计工具生成，研发/测试不得重新命名或自行实现摘要。读取同版本只追加登记表，校验全部当前契约及可信 Git 基线；不同页面语义起点独立契约，同起点可聚合。旧项目未批准迁移时保留原交付，不混用当前格式规则。
|
|
35
|
+
|
|
36
|
+
## 原生组件与原型目标
|
|
37
|
+
|
|
38
|
+
处理原型到原生组件的实现或验收时，读取本轮统一的 `saddle-minifish-test` 包或已指定源码中的 `references/native-miniapp-validation.md`，了解测试的原生观察方法；不复制另一份断言规则。逐元素交接源条件、原生承载和可执行观察；先用真实清单内完整 case 验证适配，再按消费者分批迁移。原型 HTML 实现树不作为小程序组件合同，单例通过不代表其他 case 通过。
|
|
39
|
+
|
|
40
|
+
## 原生文字与按钮布局
|
|
41
|
+
|
|
42
|
+
原生button/text可能具有默认高度、内边距或内部文字载体。原型要求居中时，按原生组件布局能力明确实现并验证实际文字位置；不要照搬HTML标签的默认排版。保持已确定的rpx尺寸、字号、字重和颜色，检查文字是否被裁切。若CSS值正确但显示粗细有差异，先核实际字体及测试宿主；字体缺失由公共测试环境解决，不在产品逐元素调字重补偿，也不在发布包夹带测试字体。
|
package/package.json
CHANGED