@antprofuse/saddle-islands-workflow 0.1.0 → 0.1.2

package/SKILL.md

@@ -28,9 +28,15 @@ description: 协调Islands正式输入、工程设计、独立测试和小程序
 
 正式physical绑定和上游生成协议作为输入消费，不默认恢复独立adapt或人工外部协议设计阶段。真实语义缺口回报责任方，不向执行者下放未知设计或要求试到能跑。
 
+各阶段按可重入的迭代研发执行：读取指定分支当前内容，复用有效成果并修订必要输出；不默认全新生成或清空。仓内输入输出由阶段Skill解释，节点不重复枚举“已有”目录，只绑定阶段分支及精确版本和Owner额外准备的输入。
+
+任务节点只声明明确输入及版本、所用Skill与阶段、范围和Git分支或共享目录交付目标。通用执行、门禁、复盘和交付细则由Skill与工具说明承载，不在节点重复维护；上游产物的精确提交由检查点确认后交接。
+
 ## 工具与规则消费
 
-通用工具来自独立工具集，使用其公开入口；本Skill及其他角色Skill不包含执行、观察、断言和报告实现。Owner交接实际可取得的工具包、明确命令、适用输入及输出，不重新规定已经工具化的内部细节。缺失能力由公共维护者修复，不让消费者另写同功能脚本。
+生成任务图时读取[全局参数与节点模板合同](<references/task-template-contract.md>)。参数在迭代级定义，节点以Markdown展示渲染结果；不可把结构化JSON直接作为节点描述。
+
+通用工具来自独立工具集，使用其公开入口；本Skill及其他角色Skill不包含执行、观察、断言和报告实现。Owner交接实际可取得的工具包及公开说明、适用输入及输出，不重新规定已经工具化的内部细节。缺失能力由公共维护者修复，不让消费者另写同功能脚本。
 
 Skill与工具分别冻结仓库、完整commit、版本、制品和文件摘要，并核兼容关系。使用已提交推送且可验证的Git分发包；npm可以作为备份，不要求等待中心传播。独立Skill包含所需的使用规范与参考，公共命令和接口说明随独立工具提供；不要求使用者阅读体系研发docs。不能只拷正文或用版本号相同冒充内容一致。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@antprofuse/saddle-islands-workflow",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "协调Islands输入、工程设计、独立测试与产品研发，明确职责、公共工具消费及增量交付。",
   "license": "MIT OR Apache-2.0",
   "files": [

package/references/stage-templates.md

@@ -0,0 +1,176 @@
+# 阶段Markdown模板
+
+下列模板供发起者渲染任务描述。仅格式和已有阶段职责固定，不预设设计数量或测试结果。路径来自全局参数和阶段元数据；节点不能自行扩大写入范围。可选分组信息另列字段。
+
+## 公共上下文
+
+- 仓库：`{git.url}`
+- 基线分支：`{git.branch}`
+- 基线提交：`{git.commit}`
+- 业务目录：`{bizdir}`
+- 业务源版本：`{source.commit}`
+- 业务源根目录：`{sourceRoot}`
+- 共享根目录：`{sharedRoot}`
+- Skill版本清单：`{skills.manifest}`
+- 工具目录：`{tools.root}`
+
+迭代授权、来源边界等说明使用文本段落。
+
+## 契约设计
+
+### 输入
+
+- 工作分支：`{workBranch}`
+- 业务输入目录：`localPath:{sourceRoot}/{bizdir}`
+- 官方测试目录文件：`localPath:{generated.catalog}`
+- 上游协议目录：`localPath:{generated.protocolDir}`
+- 输入预检结果：`localPath:{preflight.result}`
+
+### 执行
+
+使用 `saddle-islands-design` 完成契约设计阶段。
+
+- Skill入口：`{skills.design.path}`
+
+### 交付
+
+- 契约目录：`gitBranchPath:{bizdir}/code/backend-contract`
+- 数据库设计目录：`gitBranchPath:{bizdir}/code/db`
+- 身份登记文件：`gitBranchPath:{bizdir}/code/identity-registry.json`
+- 任务信息目录：`localPath:{sharedOutputDirectory}`
+- 交付门禁：`iteration diff-review`
+
+Git交付路径相对仓库根解析；成果须提交并推送到工作分支。本地任务信息目录直接写入，不提交Git。
+
+交付前必须执行交付门禁；门禁未通过，不得作成功交付。
+
+## 小程序测试研发
+
+### 输入
+
+- 工作分支：`{workBranch}`
+- 业务输入目录：`localPath:{sourceRoot}/{bizdir}`
+- 设计交付版本：`{accepted.design.commit}`
+- 官方测试目录文件：`localPath:{generated.catalog}`
+
+### 执行
+
+使用 `saddle-islands-minifish-test` 完成小程序测试研发阶段。
+
+- Skill入口：`{skills.minifish-test.path}`
+
+### 交付
+
+- 测试目录：`gitBranchPath:{bizdir}/code/minifish-tests`
+- 任务信息目录：`localPath:{sharedOutputDirectory}`
+- 交付门禁：`iteration diff-review`
+
+Git交付路径相对仓库根解析；成果须提交并推送到工作分支。本地任务信息目录直接写入，不提交Git。
+
+交付前必须执行交付门禁；门禁未通过，不得作成功交付。
+
+## 后端测试研发
+
+### 输入
+
+- 工作分支：`{workBranch}`
+- 业务输入目录：`localPath:{sourceRoot}/{bizdir}`
+- 设计交付版本：`{accepted.design.commit}`
+- 上游协议目录：`localPath:{generated.protocolDir}`
+
+### 执行
+
+使用 `saddle-islands-backend-test` 完成后端测试研发阶段。
+
+- Skill入口：`{skills.backend-test.path}`
+
+### 交付
+
+- 测试目录：`gitBranchPath:{bizdir}/code/backend-tests`
+- 任务信息目录：`localPath:{sharedOutputDirectory}`
+- 交付门禁：`iteration diff-review`
+
+Git交付路径相对仓库根解析；成果须提交并推送到工作分支。本地任务信息目录直接写入，不提交Git。
+
+交付前必须执行交付门禁；门禁未通过，不得作成功交付。
+
+## 小程序研发
+
+### 输入
+
+- 工作分支：`{workBranch}`
+- 业务输入目录：`localPath:{sourceRoot}/{bizdir}`
+- 测试交付版本：`{accepted.minifishTest.commit}`
+
+### 执行
+
+使用 `saddle-islands-minifish` 完成小程序研发阶段。
+
+- Skill入口：`{skills.minifish.path}`
+
+### 交付
+
+- 产品目录：`gitBranchPath:{bizdir}/code/minifish`
+- 任务信息目录：`localPath:{sharedOutputDirectory}`
+- 交付门禁：`iteration diff-review`
+
+Git交付路径相对仓库根解析；成果须提交并推送到工作分支。本地任务信息目录直接写入，不提交Git。
+
+交付前必须执行交付门禁；门禁未通过，不得作成功交付。
+
+## 后端研发
+
+### 输入
+
+- 工作分支：`{workBranch}`
+- 业务输入目录：`localPath:{sourceRoot}/{bizdir}`
+- 测试交付版本：`{accepted.backendTest.commit}`
+- 上游协议目录：`localPath:{generated.protocolDir}`
+
+### 执行
+
+使用 `saddle-islands-backend` 完成后端研发阶段。
+
+- Skill入口：`{skills.backend.path}`
+
+### 交付
+
+- 产品目录：`gitBranchPath:{bizdir}/code/backend`
+- 任务信息目录：`localPath:{sharedOutputDirectory}`
+- 交付门禁：`iteration diff-review`
+
+Git交付路径相对仓库根解析；成果须提交并推送到工作分支。本地任务信息目录直接写入，不提交Git。
+
+交付前必须执行交付门禁；门禁未通过，不得作成功交付。
+
+## 阶段检查点
+
+### 输入
+
+- 阶段工作分支：`{stage.workBranch}`
+- 阶段任务信息目录：`localPath:{stage.sharedOutputDirectory}`
+
+### 审核
+
+按workflow核阶段成果、工具消费、Skill改进需求及交付目录。确认后固定下游输入；发现问题交对应责任方修复复验。
+
+### 交付
+
+- 下游输入登记目录：`localPath:{acceptedInputsDirectory}`
+- 审核记录目录：`localPath:{checkpointOutputDirectory}`
+
+## 最终交付检查点
+
+### 输入
+
+- 小程序工作分支：`{minifish.workBranch}`
+- 后端工作分支：`{backend.workBranch}`
+- 阶段交付信息目录：`localPath:{deliverablesDirectory}`
+
+### 审核
+
+按workflow完成两端总审，确认阶段结论及体系改进已交接，并持久保存必要证据。合入依用户授权。
+
+### 交付
+
+- 持久交付目录：`localPath:{persistentDeliveryDirectory}`

package/references/task-planning-review.md

@@ -10,14 +10,18 @@
 - 在放行并行任务前核清共同入口、真实请求边界、可调用公共接口、工具与规则版本。未决业务选择列出依据供用户决策，不派开放任务靠执行者猜。
 - 按写入冲突决定并行：区域测试在文件和准备接口互不冲突时可并行；同一页面产品实现采用单写者。公共设施、全局索引有唯一维护者，各区域独立文件和分支，集成后以精确版本交接。
 - 产品任务以本轮完整需求和case集合为输入，不指定按目录或case顺序逐一研发。已有工程先运行本轮范围测试，以失败及需求变化定位工作，按共因统一修复；改后验证失败项和受影响的已通过项。单写者仅限制多个产品节点的并发写入，不限制节点内部统筹全部需求。普通case失败不应阻断其他独立case的失败收集，公共设施失效则先修共因。
-- 给执行者实际可访问的规则和工具，不把Owner已读过/Skill源码已改当成成员已获得。工程Skill按已推送Git原包传播并核实际内容；Owner规划规则不必整篇复制给执行者，但本轮交付要求必须明确注入任务。
+- 给执行者实际可访问的规则和工具，不把Owner已读过/Skill源码已改当成成员已获得。工程Skill按已推送Git原包传播并核实际内容；Owner规划规则不必整篇复制给执行者，本轮特有交付目标写入任务，通用交付要求由Skill承载。
 - 任务应有范围内修复权限，普通测试红灯分清产品或设施责任，不因为一次失败就阻塞或新增节点。真正源冲突与缺少不可替代输入才升级。
 
 ## 新任务继承公共能力，而非依赖旧Agent记忆
 
-每个新CoTask、新迭代和新成员的输入必须自足：Owner从当前工程核实已存在的公共准备、编译运行、断言、证据关联与报告能力，写明本轮需要使用的实际入口/最小命令、冻结版本或源码位置、输入输出合同和唯一维护者。不能只写“使用公共工具”，也不能依赖旧会话、成员记忆或已结束任务的临时共享路径。通用消费义务由对应Skill承载，项目入口清单来自本轮代码，不能把旧项目路径复制成通用规则。
+Owner先消化上游输入的不确定性：核定源版本，完成必要的编译、协议或目录生成及异常归因，准备实际可取的研发分支和生成物。首个设计阶段也基于明确分支与既定设计范围执行，不承担上游可用性探索。阶段内正常设计与实现判断仍归对应角色。正式交付物进入指定Git分支，运行证据、问题反馈和复盘进入指定共享目录。
 
-任务指示以“使用哪个公共工具、处理哪些输入、交付什么结果”为中心。已经工具化的资源编码、报告布局、截图关联、执行生命周期等内部细节由工具合同拥有，Owner和消费者不在任务中重新规定实现方案。验收核工具实际调用及输出满足目标，不把逐项重审工具内部实现作为每批前置；只有发现具体能力缺口或异常时，才由公共维护者分析修正。新增展示要求先核已有工具选项，避免看似更详细的任务指示与工具默认行为冲突。
+任务分发只驱动阶段，不再编写一份研发手册。每个节点明确三件事：输入对象及精确版本、使用哪个Skill完成哪个阶段、交付到哪个Git分支或共享目录。存在业务分组时补充具体范围；不同节点可共用一份明确的版本清单，但不能仅写“自行看计划”而省略本节点输入对象。上游尚未完成时，写明所依赖的阶段产物，由检查点交接确认后的精确提交。
+
+阶段职责、工具使用策略、门禁、结果判定、交付内容与复盘规则由对应Skill承载；公开命令和参数由工具说明承载。任务只提供这些资料可访问的冻结位置，不复制通用规则或逐条工具命令。Git分支和共享目录是交付承载位置，节点明确实际需要的目标即可，不为每个任务另造交付文件格式。
+
+新Agent应能从节点直接找到业务输入、对应Skill和公开工具资料，并依此完成阶段。发现只有任务里的临时指令才能保证正确执行时，区分业务特有约束与通用规范缺口：前者保留在任务，后者修到Skill或工具，不继续堆长节点。
 
 消费者先核入口可访问、满足当前交付目标；缺能力时给公共维护者具体缺口和使用场景，不自行复制算法或建立平行报告工具。已有工具即使工作正常，绕过它也属于消费与规划缺陷。Owner交付时核实际执行入口、输入身份和可访问产物，不以版本声明、文件存在或外观相似替代实际消费证据。
 
@@ -35,7 +39,7 @@
 
 ## 节点完成与Owner复盘
 
-任务定义要求短篇过程复盘，字段见[复盘模板](<task-retrospective.md>)。报告写任务共享证据区，最终由Owner持久归档，不能混入业务代码仓。无问题可以明确写无，不为模板制造问题。
+阶段交付包含短篇过程复盘，字段见[复盘模板](<task-retrospective.md>)。报告写任务共享证据区，最终由Owner持久归档，不能混入业务代码仓。无问题可以明确写无，不为模板制造问题。
 
 Owner收尾时结合报告和真实执行记录核对：
 - 总历时与关键路径，安装/有效建设/验证/等待/返工分开；并行节点时长不能直接相加当总历时。
@@ -55,9 +59,9 @@ Owner收尾时结合报告和真实执行记录核对：
 
 规划要列出“已证问题 → 本轮改变 → 检查证据”，不能只附历史复盘链接。优先处理关键路径：若耗时主要是逐case构建启动，采用经验证的批量并行工具；覆盖编写可以按区域并行，统一产品后由一个验收节点调用工具，不为分区运行重复安排agent。并发度、资源及生命周期验证属于测试设施，具体方法由测试Skill维护。
 
-交接使用小型摘要加独立明细引用：唯一SHA、范围原ID、case manifest、准备接口与精确工作目录；运行原件不要多层重复嵌入。公共API给最小可运行用法，消费者不靠命名猜接口。原始完整输入仍保留，摘要不能删掉字段来源与边界。
+交接使用小型摘要加独立明细引用：唯一SHA、范围原ID、case manifest、准备接口与精确工作目录；运行原件不要多层重复嵌入。公开工具说明提供最小可运行用法，节点只交接其冻结位置，消费者不靠命名猜接口。原始完整输入仍保留，摘要不能删掉字段来源与边界。
 
-任务定义写入冻结后运行、公共改动兼容旧定义、复用依赖、失败按共因归并及最终统一报告等本轮适用要求。节点复盘核对是否还有源码漂移补跑、重复安装、输入截断补读和不必要串行等待；没有计时证据时不编造收益。通用规则发布并验证实际安装后再交消费者，本轮具体SHA和路径留在任务输入，不写死进通用Skill。
+冻结输入、兼容旧定义、依赖复用、失败共因归并及报告规则由本Skill及工具合同统一承载，任务仅声明本轮输入和交付目标。节点复盘核对是否还有源码漂移补跑、重复安装、输入截断补读和不必要串行等待；没有计时证据时不编造收益。通用规则发布并验证实际安装后再交消费者，本轮具体SHA和路径留在任务输入，不写死进通用Skill。
 
 ## 在研发前发现接入问题
 

package/references/task-template-contract.md

@@ -0,0 +1,60 @@
+# 全局参数与节点模板合同
+
+参数、五阶段与检查点渲染由独立工具 `iteration render` 提供；目录差异检查由 `iteration diff-review` 提供。阶段字段及路径以随包元数据为准，Markdown模板用于审阅表达方式。
+
+## 参数归属
+
+迭代发起者用workflow Skill管理全局参数，[参数schema](<../resources/iteration.schema.json>)定义字段类型、必填性和扩展范围，[阶段元数据](<../resources/stage-meta.json>)定义五阶段输入和输出路径。Git地址、准备分支、冻结提交、仓库内业务目录bizdir、共享输出根为必填全局参数；节点不能重新填写或覆盖。每个阶段的工作分支在迭代实例中统一分配，上游交付由检查点解析为确定提交。
+
+阶段元数据定义Skill、阶段说明、输入类型、允许输出目录和文件。模板主体固定，实例只提供全局参数及少量业务分组等扩展。输出位置是必填的派生结果，不得遗漏，也不得让执行者自行选择。
+
+设计阶段的默认写入范围为：
+
+- `{bizdir}/code/backend-contract/`：后端契约。
+- `{bizdir}/code/db/`：必要逻辑表契约。
+- `{bizdir}/code/identity-registry.json`：身份登记单文件权限，不开放整个code目录。
+
+该范围依据设计与后端测试Skill的当前交付约定；不限定产物数量，也不为不存在的产物创建空目录。特殊项目布局须在迭代级明确配置并供审，不能用节点自由描述暗中扩大权限。
+
+## Markdown渲染
+
+所有字段按 `- 字段名：值` 渲染为Markdown列表，一行一个字段，不用表格，也不把多个字段拼成一段。说明工作策略、职责或审核判断时使用普通文本段落。该格式适用于全局参数、执行节点和检查点。
+
+全局参数只在公共上下文定义，节点不重复定义Git仓库、全局基线与bizdir。阶段路径由全局参数展开；阶段交接版本是节点输入，不与全局基线混淆。
+
+完整模板见[各阶段Markdown模板](<stage-templates.md>)。模板中的列表是真正独立的字段，不用一个“阶段输入”长句代替。无分组省略分组字段，仓内现状不另列“已有”字段；目录权限与文件权限分开。
+
+相同参数、元数据版本及已验收输入须得到相同描述。执行前不能留下未解析依赖或占位符。节点只绑定明确的工作分支及已确认版本，另列Owner准备的冻结源、编译或生成产物。不重复枚举该分支内的契约、数据库设计、测试与产品目录；仓内输入输出语义由阶段Skill拥有。
+
+## 交付路径检查
+
+阶段交付和合入前，对明确基线与候选提交的完整Git差异检查允许路径，生成按目录统计的Markdown表及文件明细。统计新增、修改、删除、重命名文件和增删行；重命名同时检查旧、新路径，删除同样受权限约束。最终集成检查已接受阶段权限的并集。
+
+业务路径须限定在bizdir内，共享路径限定在共享根内，拒绝路径穿越或符号链接逃逸。目录按路径段匹配，文件只精确匹配；读取权限不等于写入权限。越界变更须处理，不能自动扩白名单。即使目录合法，缓存、依赖、临时日志和过程报告等仍按对应Skill产物规则排除。
+
+目录检查减少人工核范围的负担，不替代用户对diff内容的审阅。通用执行逻辑归独立工具集，不在Skill藏实现。
+
+
+## 可重入的迭代阶段
+
+所有阶段都是迭代研发，不假定全新开始。执行者从指定分支的当前内容出发，按Skill读取仓内输入、核对正式来源并建设或修订输出；复用仍有效成果，处理失效内容。阶段重入时先核已完成工作及输入版本，不能因重入默认清空或重复生成，也不能把旧产物存在当作已验证。
+
+任务描述不使用“已有契约”“已有测试”等仓库状态字段，不复制Skill中的目录说明。阶段交接只需明确分支、已接受提交与额外准备物；外部输入不能靠执行者猜。输出权限仍由阶段元数据保留，交付路径检查使用这些权限，不因简化任务输入而放宽写入范围。
+
+工作分支同时承载仓内输入和阶段研发成果，不再分别建模输入分支与交付分支。节点在输入处列一次工作分支；交付处列产物权限与任务信息目录。检查点固定实际交付提交，分支名不替代版本。
+
+每个执行阶段统一执行 `iteration diff-review` 交付门禁；目前唯一判定是交付变更路径是否超出阶段允许范围，越界不得交付。不把其他内容审查要求或文件类型检查擅自加入此门禁，后续扩展另行明确。
+
+
+## Git与本地交付通道
+
+Git交付目录/文件字段使用仓库相对路径，并标明Git归属；成果必须提交并推送到工作分支，以确定提交交接。不得将普通本地写入视为Git交付完成。
+
+本地任务信息目录字段使用实际绝对路径，直接写入报告、证据与反馈，不提交Git。平台共享目录也是本地写入通道，不是Git目录；是否可共享、何时清理由平台合同决定。最终持久目录亦须明确本地归属。
+
+当前统一目录门禁只检查Git提交之间的变更路径。不得把本地报告目录加入Git写入白名单，也不将本地目录检查暗中加入此门禁。
+
+阶段模板只要求必须执行交付门禁，未通过不得作成功交付；具体检查项属于工具合同。目前实现仅检查Git目录范围，这是工具版本事实，不是对未来阶段要求的限制。
+
+
+路径来源标记写在值上，字段名保持简短：`gitBranchPath:` 表示当前工作分支的仓库根，例如数据库设计目录为 `gitBranchPath:{bizdir}/code/db`；`localPath:/` 表示本地绝对路径。标记仅用于Markdown展示，schema和工具内部仍保存真实相对/绝对路径，不能把展示字符串直接当文件系统路径。提交推送与本地写入规则保持不变。

package/resources/iteration.schema.json

@@ -0,0 +1,183 @@
+{
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "metaVersion": {
+      "const": 1
+    },
+    "git": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "url": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        },
+        "branch": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        }
+      },
+      "required": [
+        "url",
+        "branch",
+        "commit"
+      ]
+    },
+    "bizdir": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\\\)[^\\x00-\\x1f`{}]+$"
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "root": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        }
+      },
+      "required": [
+        "root",
+        "commit"
+      ]
+    },
+    "sharedRoot": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\x00-\\x1f`{}]+$"
+    },
+    "skillsRoot": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\x00-\\x1f`{}]+$"
+    },
+    "toolsRoot": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\x00-\\x1f`{}]+$"
+    },
+    "frameworkSkill": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\x00-\\x1f`{}]+$"
+    },
+    "generated": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "catalog": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        },
+        "protocol": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        },
+        "preflight": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^\\x00-\\x1f`{}]+$"
+        }
+      },
+      "required": [
+        "catalog",
+        "protocol",
+        "preflight"
+      ]
+    },
+    "stages": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z][A-Za-z0-9_-]*$"
+          },
+          "stage": {
+            "type": "string",
+            "enum": [
+              "design",
+              "minifish-test",
+              "backend-test",
+              "minifish",
+              "backend"
+            ]
+          },
+          "sharedOutput": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^(?!/)(?!.*(?:^|/)\\.{1,2}(?:/|$))(?!.*\\\\)[^\\x00-\\x1f`{}]+$"
+          },
+          "acceptedInput": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[^\\x00-\\x1f`{}]+$"
+          },
+          "inputCommit": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{40}$"
+          },
+          "group": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[^\\x00-\\x1f`{}]+$"
+          },
+          "workBranch": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[^\\x00-\\x1f`{}]+$"
+          }
+        },
+        "required": [
+          "id",
+          "stage",
+          "sharedOutput",
+          "acceptedInput",
+          "workBranch"
+        ]
+      }
+    },
+    "persistentDeliveryDirectory": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^\\x00-\\x1f`{}]+$"
+    }
+  },
+  "required": [
+    "schemaVersion",
+    "metaVersion",
+    "git",
+    "bizdir",
+    "source",
+    "sharedRoot",
+    "skillsRoot",
+    "toolsRoot",
+    "frameworkSkill",
+    "generated",
+    "stages",
+    "persistentDeliveryDirectory"
+  ],
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Saddle–Islands iteration parameters"
+}

package/resources/stage-meta.json

@@ -0,0 +1,183 @@
+{
+  "version": 1,
+  "stages": {
+    "design": {
+      "label": "契约设计",
+      "skill": "saddle-islands-design",
+      "inputs": [
+        [
+          "业务输入目录",
+          "{source.root}/{bizdir}"
+        ],
+        [
+          "官方测试目录文件",
+          "{generated.catalog}"
+        ],
+        [
+          "上游协议文件",
+          "{generated.protocol}"
+        ],
+        [
+          "输入预检结果",
+          "{generated.preflight}"
+        ]
+      ],
+      "outputDirectories": [
+        [
+          "契约目录",
+          "{bizdir}/code/backend-contract"
+        ],
+        [
+          "数据库设计目录",
+          "{bizdir}/code/db"
+        ]
+      ],
+      "outputFiles": [
+        [
+          "身份登记文件",
+          "{bizdir}/code/identity-registry.json"
+        ]
+      ]
+    },
+    "minifish-test": {
+      "label": "小程序测试研发",
+      "skill": "saddle-islands-minifish-test",
+      "inputs": [
+        [
+          "业务输入目录",
+          "{source.root}/{bizdir}"
+        ],
+        [
+          "设计交付登记",
+          "{acceptedInput}"
+        ],
+        [
+          "官方测试目录文件",
+          "{generated.catalog}"
+        ]
+      ],
+      "outputDirectories": [
+        [
+          "测试目录",
+          "{bizdir}/code/minifish-tests"
+        ]
+      ],
+      "outputFiles": []
+    },
+    "backend-test": {
+      "label": "后端测试研发",
+      "skill": "saddle-islands-backend-test",
+      "inputs": [
+        [
+          "业务输入目录",
+          "{source.root}/{bizdir}"
+        ],
+        [
+          "设计交付登记",
+          "{acceptedInput}"
+        ],
+        [
+          "上游协议文件",
+          "{generated.protocol}"
+        ]
+      ],
+      "outputDirectories": [
+        [
+          "测试目录",
+          "{bizdir}/code/backend-tests"
+        ]
+      ],
+      "outputFiles": []
+    },
+    "minifish": {
+      "label": "小程序研发",
+      "skill": "saddle-islands-minifish",
+      "inputs": [
+        [
+          "业务输入目录",
+          "{source.root}/{bizdir}"
+        ],
+        [
+          "测试交付登记",
+          "{acceptedInput}"
+        ]
+      ],
+      "outputDirectories": [
+        [
+          "产品目录",
+          "{bizdir}/code/minifish"
+        ]
+      ],
+      "outputFiles": []
+    },
+    "backend": {
+      "label": "后端研发",
+      "skill": "saddle-islands-backend",
+      "inputs": [
+        [
+          "业务输入目录",
+          "{source.root}/{bizdir}"
+        ],
+        [
+          "测试交付登记",
+          "{acceptedInput}"
+        ],
+        [
+          "上游协议文件",
+          "{generated.protocol}"
+        ]
+      ],
+      "outputDirectories": [
+        [
+          "产品目录",
+          "{bizdir}/code/backend"
+        ]
+      ],
+      "outputFiles": []
+    }
+  },
+  "checkpoint": {
+    "inputs": [
+      [
+        "阶段工作分支",
+        "{workBranch}"
+      ],
+      [
+        "阶段任务信息目录",
+        "{stageOutput}"
+      ]
+    ],
+    "review": "按workflow审查阶段成果、工具消费、Skill改进需求及交付目录。通过后确认下游输入版本；未通过交对应责任方修复复验。",
+    "outputs": [
+      [
+        "下游输入登记目录",
+        "{sharedRoot}/inputs/accepted"
+      ],
+      [
+        "审核记录目录",
+        "{sharedRoot}/deliverables/{id}-review"
+      ]
+    ]
+  },
+  "delivery": {
+    "inputs": [
+      [
+        "阶段交付信息目录",
+        "{sharedRoot}/deliverables"
+      ]
+    ],
+    "review": "按workflow完成交付总审，确认各阶段检查点结论及体系改进已交接，持久保存必要报告。合入另按用户授权。",
+    "outputs": [
+      [
+        "持久交付目录",
+        "{persistentDeliveryDirectory}"
+      ]
+    ]
+  },
+  "deliveryGate": {
+    "label": "交付门禁",
+    "command": "iteration diff-review",
+    "scope": "交付前必须执行交付门禁；门禁未通过，不得作成功交付。"
+  },
+  "gitDeliveryInstruction": "Git成果提交并推送到工作分支；任务信息直接写入指定本地目录。"
+}