@antprofuse/saddle-islands-design 0.1.21 → 0.1.24
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
CHANGED
|
@@ -5,7 +5,7 @@ description: 消费 Islands Spec 与自洽 adapt，设计后端契约、逻辑
|
|
|
5
5
|
|
|
6
6
|
# Saddle Islands 设计
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
先完整阅读本轮冻结的 saddle-workflow 及本 Skill 原始包。按 workflow 的传播规则消费已提交并推送的 Git 包，核仓库、完整 commit、版本和逐文件摘要；同批保持一致，运行中不静默替换。npm 仅作发布备份，不要求安装 latest 或等待 registry。缺失正文或引用文件须修复交接，不能凭版本号相同认定内容一致。
|
|
9
9
|
|
|
10
10
|
当项目明确由上游Spec工具生成既有gRPC协议时，该协议是只读输入；本Skill只设计前后端契约与DB，不另建业务proto、不添加Saddle专有option。协议缺口回报上游，Java实现与部署不纳入范围。下述external-contract-proto模块仅适用于用户明确委托本阶段设计外部协议的项目。
|
|
11
11
|
|
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
## 推演顺序
|
|
6
6
|
|
|
7
7
|
1. 核对指定 Spec/Prototype 的交互、展示与结果需求。覆盖分母和链路算法由后续测试阶段产出，不在契约设计阶段提前生成。Spec其他内容用于解释实体与业务，不据此扩展接口范围；不要求Spec预先声明物理服务接口。
|
|
8
|
-
2. 先读取
|
|
8
|
+
2. 先读取 本轮冻结的 saddle-workflow 原始包 的语义身份规范，用公共工具生成并登记 identity/id，证明唯一页面语义起点；不同起点独立契约，同起点内聚合。找到实际页面动作，沿业务逻辑走到下次用户参与或交付结果的边界。中间无需用户补充输入的关联读取可以归并一次调用；不按实体数、Logic数或Dependency数机械拆接口，也不强制所有业务只有一个查询。
|
|
9
9
|
3. 输入逐字段追溯实体属性（含adapt扩展）、正式外部入口字段或正式命名事务入口参数（transactionInput）。后端不能从系统取得才向前端索要；系统当前用户不出现在input或context。入口字段可直接向后传递，不强制归属实体属性。
|
|
10
10
|
4. 输出是具体线上字段的实体投影，不是让前后端各自解释的抽象Row。说明本次实体实例根和关联路径，不能仅凭字段同名认定来源正确。不为仅传递对象制造uid、token或身份映射。
|
|
11
11
|
5. 选择最小充分的结果结构：对象+可空成员已完整表达时无需case；存在真实互斥形状时用联合。完整枚举来自声明，不来自样例。确认的跨字段、实例归属及空值语义写入invariants，不以过程说明代替正式约束。
|
|
@@ -10,6 +10,8 @@
|
|
|
10
10
|
|
|
11
11
|
## 必需的顶层结构
|
|
12
12
|
|
|
13
|
+
以下示例中的业务、域、页面、接口ID和来源名称仅展示格式，必须按当前项目正式输入与身份工具生成结果替换；不是默认配置或对特定业务的限制。后续来源示例同样如此。
|
|
14
|
+
|
|
13
15
|
```yaml
|
|
14
16
|
id: api_91d5e0b55164bb5b60240fa030519c23
|
|
15
17
|
identity:
|
|
@@ -35,7 +37,7 @@ types: {}
|
|
|
35
37
|
|
|
36
38
|
## 契约身份与唯一页面起点
|
|
37
39
|
|
|
38
|
-
使用
|
|
40
|
+
使用 `本轮冻结的 saddle-workflow 原始包` 的 包内 `references/semantic-identity.md`及 scripts/semantic_identity.py，设计阶段生成，研发直接消费。不自行重写摘要。
|
|
39
41
|
|
|
40
42
|
identity 必须且仅有 kind/business/domain/page/trigger 五个字符串，kind 固定 backend_contract。归一化及校验由公共工具执行；id 为 `api_` 加32位小写十六进制摘要。页面和触发标识必须有真实 Spec 依据，不通过文案重新翻译。
|
|
41
43
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 运行时协议依据
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
框架Skill使用用户指定或当前项目锁对应的官方精确版本，完整记录发布方来源、版本和摘要；不查询latest来隐式升级既有项目。完整阅读该版实际提供的协议与消费、验证参考文件和模板，不能假定各版本路径相同。官方包与旧资料冲突以已选定实包为准；协议变化单独反馈。包不可取得时不手写替代。工程Skill传播遵循workflow的Git原始包规则，不能把官方框架私改后冒充官方版本。
|
|
4
4
|
|
|
5
5
|
## 固定模板和共享目录
|
|
6
6
|
|