@antprofuse/saddle-islands-backend 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 +15 -0
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -7,6 +7,12 @@ description: 基于 Spec、正式physical输入、后端契约、DB、共享外
|
|
|
7
7
|
|
|
8
8
|
先完整阅读本轮冻结的 saddle-islands-workflow 及本 Skill 原始包。按 workflow 的传播规则消费已提交并推送的 Git 包，核仓库、完整 commit、版本和逐文件摘要；同批保持一致，运行中不静默替换。npm 仅作发布备份，不要求安装 latest 或等待 registry。缺失正文或引用文件须修复交接，不能凭版本号相同认定内容一致。 官方 Saddle 包仍消费发布方提供并与项目锁一致的精确版本；官方框架拥有技术 API 与运行时约束，本 Skill 不替代它。
|
|
9
9
|
|
|
10
|
+
## 本轮输入与交付定位
|
|
11
|
+
|
|
12
|
+
任务指定的业务输入目录是Owner预先冻结的正式输入包。先读其中 `input.json`，按其索引读取 `source/` 的Spec、视觉及physical输入，以及 `generated/` 的目录、协议和预检资料；只消费本阶段需要的内容。来源和工具版本按包内身份与执行环境索引核对，不用工作分支中另一版本Spec覆盖该包。缺少必要项时反馈明确缺口，不自行重做上游生成或猜测位置。
|
|
13
|
+
|
|
14
|
+
工作分支包含仓内输入与本阶段正式交付物；按本Skill职责理解并增量修订，Git成果提交并推送至指定分支。任务执行记录写入指定本地目录，仅供Owner检查点审核，普通执行阶段默认不读取该记录区。正式设计和测试交接以工作分支及明确的内容输入为准，不从过程报告拼接需求。执行环境索引定位实际Skill、工具、依赖及本阶段的门禁scope；缺失入口不得凭包名假定已注入。统一协同细则读取本轮workflow的 `references/task-template-contract.md`。
|
|
15
|
+
|
|
10
16
|
## 阶段执行合同
|
|
11
17
|
|
|
12
18
|
开始前确认正式输入、设计、独立测试定义、公共工具版本及已有有效结果已就绪。交付是产品改动与本轮实际测试的完整增量结果，包含复用依据、退回问题及影响集合。单Agent兼任时也须先完成上一阶段交接，再按产品职责执行；不能按实现现状改测试期望。
|
|
@@ -49,3 +55,12 @@ description: 基于 Spec、正式physical输入、后端契约、DB、共享外
|
|
|
49
55
|
消费本轮冻结的saddle-islands-design后端契约格式，以及独立工具集随附的语义身份规范。契约 identity/id 由设计工具生成，研发/测试不得重新命名或自行实现摘要。读取同版本只追加登记表，校验全部当前契约及可信 Git 基线；不同页面语义起点独立契约，同起点可聚合。旧项目未批准迁移时保留原交付，不混用当前格式规则。
|
|
50
56
|
|
|
51
57
|
对当前契约，operations/<id>/、模块和静态 operation_type 都原样使用契约 id，MobileGW调用的target.interfaceId与之相等，binding.operationType保持正式网关入口名；不能将网关operation与后端契约ID混为一谈。日志身份来自正式路由声明的匹配结果，不读取客户端额外 contractId。Saddle 当前入口观察 operation 使用 interfaceId：只有确认匹配注册入口的请求才能归属于该契约；未知路由、解析前失败不得假归属。下游日志若 operation 表示外部方法，保持其语义，通过原始请求关联回入口身份，不能覆盖为契约 ID。实际公共日志缺少关联时报告框架能力缺口，不伪造 API 或侵入运行时。
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
## 统一交付门禁
|
|
61
|
+
|
|
62
|
+
交付前必须使用本轮指定的公开工具入口执行交付门禁；门禁未通过，不得作成功交付。保留实际结果到任务执行记录目录，失败按责任修复后重新执行。具体检查项及参数由冻结工具版本提供，见 `tools/docs/iteration.md`，任务不重复列举或自行裁剪检查项。
|
|
63
|
+
|
|
64
|
+
## 迭代范围与无变更交付
|
|
65
|
+
|
|
66
|
+
阶段适用于新业务研发、已有业务的小范围变更和无业务变化的复核。按本轮目标与输入差异决定工作量；节点存在不等于必须修改代码、重建设计或重写测试，也不自动要求全量验证。优先复用仍有效成果和证据，对变更及其影响范围研发、验证。判定无需修改时交付依据、对应版本及必要检查结果，不能仅凭文件已存在认定完成；用户明确要求完整复核或全量测试时按该范围执行。无Git变更仍执行阶段交付门禁，基线与候选可以相同。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@antprofuse/saddle-islands-backend",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.2",
|
|
4
4
|
"description": "基于 Spec、正式physical输入、后端契约、DB、共享外部协议和独立后端测试实现 Saddle 业务后端，维护契约到唯一后端入口的工程脉络。框架技术规则另消费官方 Saddle Skill，不重新设计协议或实现 Java 下游。",
|
|
5
5
|
"license": "MIT OR Apache-2.0",
|
|
6
6
|
"files": [
|