create-yss-spec 3.5.2 → 3.5.4

package/template/.template-spec/templates/examples/plan-spec/complex-source.md

@@ -0,0 +1,12 @@
+# 业务输入
+
+> 全部为虚构输入，仅用于模板和诊断验证；不是产品事实或批准。
+
+| ID | 原始规则 |
+|---|---|
+| C1 | 仅草稿允许提交，其他状态拒绝重复提交且不改变状态。 |
+| C2 | 提交成功后进入待审核；审批通过后进入已生效。 |
+| C3 | 驳回后回到草稿，并保留驳回原因。 |
+| C4 | 并发审批仅首个合法状态转换生效，后续请求提示状态已变化。 |
+| C5 | 审批服务超时后的恢复策略未知，未确认前不承诺自动重试。 |
+| C6 | 不改变历史已生效单据，不增加补偿自动撤销。 |

package/template/.template-spec/templates/examples/plan-spec/complex-valid.md

@@ -0,0 +1,38 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 审批状态流程
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 仅草稿可提交；其他状态拒绝重复提交且状态不变 | P0 | .template-spec/templates/examples/plan-spec/complex-source.md :: id:C1 | AC-001 | 无 |
+| FR-002 | 提交成功进入待审核；审批通过进入已生效；驳回回草稿并保留原因 | P0 | .template-spec/templates/examples/plan-spec/complex-source.md :: id:C2；.template-spec/templates/examples/plan-spec/complex-source.md :: id:C3 | AC-002, AC-003 | 无 |
+| FR-003 | 并发审批仅首个合法转换生效，后续提示状态变化 | P0 | .template-spec/templates/examples/plan-spec/complex-source.md :: id:C4 | AC-004 | 无 |
+
+## 非功能需求
+
+not-applicable：本样本未新增独立非功能目标。
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001 | 单据为已生效 | 重复提交 | 拒绝，状态不变 | 拒绝 | 无 |
+| AC-002 | FR-002 | 草稿满足其他提交条件 | 提交后由审核员通过 | 依次进入待审核、已生效 | 状态变化 | 无 |
+| AC-003 | FR-002 | 待审核单据 | 审核员驳回并填写原因 | 回到草稿且原因可查看 | 恢复 | 无 |
+| AC-004 | FR-003 | 两位审核员并发操作同一待审核版本 | 首个通过，第二个驳回 | 首个转换生效，第二个显示状态已变化 | 边界 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 审批超时恢复策略未知，需确认失败恢复方式 | .template-spec/templates/examples/plan-spec/complex-source.md :: id:C5；不承诺自动重试 | 业务负责人（虚构角色） | 冻结前 | Spec 起草者 / 待确认 |
+
+## 非目标范围
+
+不改变历史已生效单据，不增加补偿自动撤销。来源：.template-spec/templates/examples/plan-spec/complex-source.md :: id:C6

package/template/.template-spec/templates/examples/plan-spec/expectations.json

@@ -0,0 +1,46 @@
+{
+  "fictional": true,
+  "human_trial": "pending",
+  "families": [
+    {
+      "id": "ordinary",
+      "source": "ordinary-source.md",
+      "valid": "ordinary-valid.md",
+      "defective": "ordinary-defective.md",
+      "expected_defect_codes": [
+        "DUPLICATE_ID",
+        "DANGLING_REFERENCE",
+        "REFERENCE_MISMATCH",
+        "INPUT_UNREADABLE"
+      ],
+      "defective_exit_code": 2,
+      "preservation_review": "原始规则、否定、量词、例外、非目标与未知项逐项核对；不作为真实业务批准"
+    },
+    {
+      "id": "complex",
+      "source": "complex-source.md",
+      "valid": "complex-valid.md",
+      "defective": "complex-defective.md",
+      "expected_defect_codes": [
+        "AC_MISSING",
+        "SOURCE_LOCATOR",
+        "NA_REASON"
+      ],
+      "defective_exit_code": 0,
+      "preservation_review": "原始规则、否定、量词、例外、非目标与未知项逐项核对；不作为真实业务批准"
+    },
+    {
+      "id": "high-risk",
+      "source": "high-risk-source.md",
+      "valid": "high-risk-valid.md",
+      "defective": "high-risk-defective.md",
+      "expected_defect_codes": [
+        "REQUIRED_FIELD",
+        "UNKNOWN_TARGET",
+        "TARGET_STATUS"
+      ],
+      "defective_exit_code": 0,
+      "preservation_review": "原始规则、否定、量词、例外、非目标与未知项逐项核对；不作为真实业务批准"
+    }
+  ]
+}

package/template/.template-spec/templates/examples/plan-spec/high-risk-before.md

@@ -0,0 +1,32 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 权限查看基线
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 具有审批权限的审核员可查看本部门单据 | P0 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H1 | AC-001 | 无 |
+
+## 非功能需求
+
+not-applicable：本样本未新增独立非功能目标。
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001 | 具有权限且单据属于本部门 | 查看单据 | 可见单据内容 | 成功 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+
+## 非目标范围
+
+不主动清除客户端已返回历史内容；权限传播目标未知。虚构冻结基线，用于差异比较，不构成真实批准。

package/template/.template-spec/templates/examples/plan-spec/high-risk-defective.md

@@ -0,0 +1,39 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 权限查看变更
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 具有审批权限的审核员可查看本部门单据 | P0 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H1 | AC-001 | 无 |
+| FR-002 | 撤销审批权限后的后续查看请求拒绝且不显示单据内容 | P0 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H2 | AC-002 | 无 |
+
+## 非功能需求
+
+| ID | 需求 | 适用条件/负载 | 指标及单位 | 目标 | 确认状态 | 验证方法 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|---|---|---|---|
+| NFR-001 | 权限撤销传播时效 |  | 传播延迟 / 毫秒 | 未知 | 已确认 |  | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H4 | AC-002 | 无 |
+| NFR-002 | 日志不包含单据正文 | 本次拒绝路径日志 | 检查：不存在单据正文 | 日志无单据正文 | 已确认 | 检查拒绝日志样本 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H5 | AC-003 | 无 |
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001 | 具有权限且单据属于本部门 | 查看单据 | 可见单据内容 | 成功 | 无 |
+| AC-002 | FR-002, NFR-001 | 当前服务已读到撤销后的权限状态 | 发起后续查看 | 拒绝且不返回单据内容；传播窗口仍待确认 | 拒绝 / 状态变化 | Q-001 |
+| AC-003 | NFR-002 | 请求被拒绝 | 检查该请求的日志 | 日志不存在单据正文 | 拒绝 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 权限传播延迟目标未知；采集传播记录后由负责人确认 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H4；冻结前补齐，不补造阈值 | 安全负责人（虚构角色） | Spec 冻结前 | 工程契约 / 待确认目标 |
+
+## 非目标范围
+
+不主动清除已返回客户端的历史内容。来源：.template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H3。不承诺即时全局失效；当前行为候选，按既有决定协议确认。

package/template/.template-spec/templates/examples/plan-spec/high-risk-source.md

@@ -0,0 +1,11 @@
+# 业务输入
+
+> 全部为虚构输入，仅用于模板和诊断验证；不是产品事实或批准。
+
+| ID | 原始规则 |
+|---|---|
+| H1 | 既有冻结基线：具有审批权限的审核员可查看本部门单据。 |
+| H2 | 候选变化：撤销审批权限后，后续查看请求拒绝，不显示单据内容。 |
+| H3 | 已返回客户端的历史内容不在本期主动清除。 |
+| H4 | 权限传播延迟目标未知，等待安全负责人确认；不承诺即时全局失效。 |
+| H5 | 本次拒绝路径日志不得包含单据正文；使用日志检查进行验证。 |

package/template/.template-spec/templates/examples/plan-spec/high-risk-valid.md

@@ -0,0 +1,39 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 权限查看变更
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 具有审批权限的审核员可查看本部门单据 | P0 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H1 | AC-001 | 无 |
+| FR-002 | 撤销审批权限后的后续查看请求拒绝且不显示单据内容 | P0 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H2 | AC-002 | Q-001 |
+
+## 非功能需求
+
+| ID | 需求 | 适用条件/负载 | 指标及单位 | 目标 | 确认状态 | 验证方法 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|---|---|---|---|
+| NFR-001 | 权限撤销传播时效 | 权限变更至各校验服务观测期间 | 传播延迟 / 毫秒 | 未知 | 候选 | 分析权限传播记录；目标确认后按窗口测试 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H4 | AC-002 | Q-001 |
+| NFR-002 | 日志不包含单据正文 | 本次拒绝路径日志 | 检查：不存在单据正文 | 日志无单据正文 | 已确认 | 检查拒绝日志样本 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H5 | AC-003 | 无 |
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001 | 具有权限且单据属于本部门 | 查看单据 | 可见单据内容 | 成功 | 无 |
+| AC-002 | FR-002, NFR-001 | 当前服务已读到撤销后的权限状态 | 发起后续查看 | 拒绝且不返回单据内容；传播窗口仍待确认 | 拒绝 / 状态变化 | Q-001 |
+| AC-003 | NFR-002 | 请求被拒绝 | 检查该请求的日志 | 日志不存在单据正文 | 拒绝 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 权限传播延迟目标未知；采集传播记录后由负责人确认 | .template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H4；冻结前补齐，不补造阈值 | 安全负责人（虚构角色） | Spec 冻结前 | 工程契约 / 待确认目标 |
+
+## 非目标范围
+
+不主动清除已返回客户端的历史内容。来源：.template-spec/templates/examples/plan-spec/high-risk-source.md :: id:H3。不承诺即时全局失效；当前行为候选，按既有决定协议确认。

package/template/.template-spec/templates/examples/plan-spec/ordinary-defective.md

@@ -0,0 +1,36 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 附件提交校验
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 点击提交时检查本单据必需附件，缺少任一项时拒绝且保持草稿 | P0 | .template-spec/templates/examples/plan-spec/missing-source.md :: id:S1；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S2 | AC-001 | 无 |
+| FR-001 | 一次列出全部缺失附件名称，并保留当前页面已填数据 | P0 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S3；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S4 | AC-001 | 无 |
+| FR-003 | 补齐后重新提交并重新校验，齐全且其他条件满足时沿既有流程 | P0 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S5；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S6 | AC-002 | 无 |
+
+## 非功能需求
+
+not-applicable：本样本未新增独立非功能目标。
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001, FR-002 | 草稿缺少两项必需附件且页面有已填数据 | 点击提交 | 拒绝提交；保持草稿；同时列出两项名称并保留当前页面数据 | 拒绝 / 边界 | 无 |
+| AC-002 | FR-099 | 已补齐全部必需附件且其他提交条件满足 | 再次点击提交 | 重新检查并沿既有流程提交 | 恢复 / 成功 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 读取附件清单失败时的行为待确认；安排需求澄清 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S8；关键行为未知，不延期越过冻结 | 产品负责人（虚构角色） | Spec 冻结前 | Spec 起草者 / 待取得真实决定 |
+
+## 非目标范围
+
+不校验附件真实性；不承诺刷新或关闭后的恢复。来源：.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S7。读取清单失败时行为仍未知，验收例子不确定它。

package/template/.template-spec/templates/examples/plan-spec/ordinary-plan.md

@@ -0,0 +1,27 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 附件提交校验 Plan
+
+> 虚构输入；时间、角色及目标均为样本，不代表实际业务承诺。
+
+本期帮助经办人在提交前发现缺失附件；只检查是否齐全，不判定真实性，不承诺刷新恢复。来源见 `.template-spec/templates/examples/plan-spec/ordinary-source.md` S1–S8。
+
+## 成功标准
+
+| ID | 指标定义 | 基线或未知原因 | 目标 | 确认状态 | 观测窗口 | 数据来源 | 验证方式 | 未决项 |
+|---|---|---|---|---|---|---|---|---|
+| SC-001 | 在已登记拒绝场景中一次展示全部缺失名称 | 未知：尚无原型观察记录 | 未知 | 候选 | 下一次人工阅读与原型试用 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S3 | 演示两项同时缺失；记录观察结果后确认目标 | Q-001 |
+
+## 关键取舍
+
+| 决定 / 权威引用 | 真实候选 | 本期选择及理由 | 主要代价 | 重新考虑条件 |
+|---|---|---|---|---|
+| 轻量案例：附件范围 | 仅检查齐全；追加真实性检查 | 本期仅检查齐全；真实性规则未确认 | 无法发现附件内容造假 | 真实性规则及责任人明确后重新立项 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 基线及目标未知，安排人工观察后确认 | 虚构输入无测量证据，不制造目标值 | 产品负责人（虚构角色） | 规划确认前 | 规划审查者 / 待观察记录 |

package/template/.template-spec/templates/examples/plan-spec/ordinary-source.md

@@ -0,0 +1,14 @@
+# 业务输入
+
+> 全部为虚构输入，仅用于模板和诊断验证；不是产品事实或批准。
+
+| ID | 原始规则 |
+|---|---|
+| S1 | 经办人点击提交时检查本单据要求的附件清单。 |
+| S2 | 缺少任一必需附件时拒绝提交，单据仍为草稿。 |
+| S3 | 一次列出全部缺失附件名称。 |
+| S4 | 保留当前页面已填数据；不承诺刷新或关闭后的恢复。 |
+| S5 | 补齐后重新点击提交，重新执行校验。 |
+| S6 | 全部必需附件齐全且其他提交条件满足时，沿既有提交流程。 |
+| S7 | 本期不校验附件内容真实性，不处理刷新恢复。 |
+| S8 | 附件清单读取失败时的行为未知，需在 Spec 冻结前确认。 |

package/template/.template-spec/templates/examples/plan-spec/ordinary-valid.md

@@ -0,0 +1,36 @@
+---
+content_profile: plan-spec-v1
+---
+
+# 附件提交校验
+
+> 虚构输入；仅为确定性 fixture，不代表已批准业务。
+
+## 功能需求
+
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | 点击提交时检查本单据必需附件，缺少任一项时拒绝且保持草稿 | P0 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S1；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S2 | AC-001 | 无 |
+| FR-002 | 一次列出全部缺失附件名称，并保留当前页面已填数据 | P0 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S3；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S4 | AC-001 | 无 |
+| FR-003 | 补齐后重新提交并重新校验，齐全且其他条件满足时沿既有流程 | P0 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S5；.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S6 | AC-002 | 无 |
+
+## 非功能需求
+
+not-applicable：本样本未新增独立非功能目标。
+
+## 验收标准
+
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001, FR-002 | 草稿缺少两项必需附件且页面有已填数据 | 点击提交 | 拒绝提交；保持草稿；同时列出两项名称并保留当前页面数据 | 拒绝 / 边界 | 无 |
+| AC-002 | FR-003 | 已补齐全部必需附件且其他提交条件满足 | 再次点击提交 | 重新检查并沿既有流程提交 | 恢复 / 成功 | 无 |
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | 读取附件清单失败时的行为待确认；安排需求澄清 | .template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S8；关键行为未知，不延期越过冻结 | 产品负责人（虚构角色） | Spec 冻结前 | Spec 起草者 / 待取得真实决定 |
+
+## 非目标范围
+
+不校验附件真实性；不承诺刷新或关闭后的恢复。来源：.template-spec/templates/examples/plan-spec/ordinary-source.md :: id:S7。读取清单失败时行为仍未知，验收例子不确定它。

package/template/.template-spec/templates/local-parent-ticket-template.md

@@ -26,14 +26,18 @@ Status: ready-for-human
 | publication | local / pending |
 | pending_publication_to | none / github / gitlab |
 
-## 生命周期状态
+## 生命周期查询
 
-| 字段 | 值 |
-|---|---|
-| stage | `<current-stage>` |
-| lifecycle_status | routing / running / paused-human-gate / blocked / completed |
-| ticket_role | needs-triage / needs-info / ready-for-agent / ready-for-human / wontfix |
-| gate_summary | `<approved / blocked / not-applicable summary>` |
+Checkpoint：`docs/.scratch/<feature>/checkpoint.yaml`（填写实际存在的路径）。
+
+阶段、阻塞、门禁摘要与下一工作单元从同一 checkpoint 按需查询；本票只保存 Ticket 五态、业务说明与资产入口。
+
+```sh
+scripts/lifecycle-status --root . --checkpoint docs/.scratch/<feature>/checkpoint.yaml
+scripts/stage-tracking check --root . --checkpoint docs/.scratch/<feature>/checkpoint.yaml
+```
+
+查询不写文件，也不授予执行权限。批准依据仍读取下方会签记录。
 
 ## 资产与证据
 
@@ -50,16 +54,20 @@ Status: ready-for-human
 
 会签记录写在 `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml`。会签桶内门禁标为 `approved` 前必须通过 `scripts/verify-approval-record`。
 
-| 门禁 | 记录路径 | 会签角色 | 状态 |
-|---|---|---|---|
-|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `.template-spec/agents/digital-human-roles.yaml` | pending / approved / blocked / not-applicable |
+| 门禁 | 记录路径 | 会签角色 |
+|---|---|---|
+|  | `docs/.scratch/<feature>/gates/<gate-id>-approval.yaml` | 见 `.template-spec/agents/digital-human-roles.yaml` |
 
-## 阻塞关系
+会签结果读取记录原件；阻塞关系与下一工作单元读取上述 checkpoint，不在本票重填状态表。
 
-- 无 / 被 `<ticket-path>` 阻塞
+## Comments
 
-## 下一工作单元
+## 拆分与就绪
 
-`<next-work-unit>`
+| 维度 | 资产与证据入口 |
+|---|---|
+| 业务拆分 | <business-ticket-set.yaml / 业务正式化记录> |
+| 实现拆分 | <issues/ 与 Ticket 正式化记录> |
+| 实现就绪 | <当前合同批准、仓库准备与就绪检查引用> |
 
-## Comments
+如声明业务集合已同步，在 frontmatter 增加 business_ticket_set_ref 与 business_ticket_set_digest（当前集合原字节），不复制票据正文。

package/template/.template-spec/templates/spec-delta-template.md

@@ -16,11 +16,13 @@
 
 ## 2. 行为差异
 
-| 类型 | 行为 | 当前状态 | 目标状态 | 影响范围 |
-|---|---|---|---|---|
-| ADDED |  |  |  |  |
-| MODIFIED |  |  |  |  |
-| REMOVED |  |  |  |  |
+| 类型 | 行为 | 当前状态 | 目标状态 | 影响范围 | 关联 FR/NFR/AC |
+|---|---|---|---|---|---|
+| ADDED |  |  |  |  |  |
+| MODIFIED |  |  |  |  |  |
+| REMOVED |  |  |  |  |  |
+
+关联使用稳定 ID 并注明旧 / 新基线文件；删除项保留旧 ID，不复用。可附 `inspect-plan-spec diff` 的诊断和原始字节差异，缺少旧基线时明确“无法比较”。该辅助证据不判定语义等价、不延续批准、不缩小验证范围。
 
 说明：
 

package/template/.template-spec/templates/spec-template.md

@@ -1,4 +1,5 @@
 ---
+content_profile: plan-spec-v1
 pipeline: <feature-id>
 stage: open
 status: ready-for-human
@@ -9,6 +10,10 @@ owner: ai
 
 填写前读取[中文写作规范](../process/document-writing.md)和 [Spec 对照](examples/lifecycle-writing-examples.md#2-spec让规则可以转成验收)。保留原规则、例外和不确定性；输入缺失时记录待确认项。
 
+## 业务 Ticket 草案
+
+集合：`docs/.scratch/<feature>/business-ticket-set.yaml`。Spec 综合同时起草，Design 校准同一组 ID；集合只存引用及覆盖处置，正文按业务 Ticket 模板填写。此处只引用路径，避免 Spec 与集合摘要循环。
+
 ## 功能父 Ticket
 
 <Local：`docs/.scratch/<feature>/parent-ticket.md`；GitHub / GitLab：Issue URL / 编号>
@@ -29,28 +34,29 @@ owner: ai
 
 需求写明主体、触发条件和可观察结果；关联验收标准。不要用“完善、友好、高效”代替规则。
 
-| ID | 需求 | 优先级 | 备注 |
-|---|---|---|---|
-| FR-001 | | P0/P1/P2 | |
+| ID | 需求 | 优先级 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|
+| FR-001 | <主体、触发、结果及例外> | P0/P1/P2 | <项目根相对路径> :: id:<已有条目ID> | AC-001 / 待补 Q-001 | 无 / Q-001 |
 
 ## 非功能需求
 
 命中时填写工作负载或适用条件、目标值及单位、验证方式与依据；尚未确认的目标保留为未决项，不补造性能承诺。
 
-| 类别 | 需求 | 目标 |
-|---|---|---|
-| 性能 | | |
-| 可靠性 | | |
+没有适用非功能约束时写 `not-applicable：<原因>`，不保留空行。验证方法允许测试、检查、分析、演示，不强迫定性约束数值化。
+
+| ID | 需求 | 适用条件/负载 | 指标及单位 | 目标 | 确认状态 | 验证方法 | 来源引用 | 验收引用 | 未决项 |
+|---|---|---|---|---|---|---|---|---|---|
+| NFR-001 | <填写> | <填写> | <量化口径或定性判断依据> | <填写或未知> | 候选 / 已确认 | <填写> | <项目根相对路径> :: heading:<准确章节名> | AC-002 / 待补 Q-001 | 无 / Q-001 |
 
 ## 验收标准
 
 关联需求 ID，按实际影响覆盖成功、拒绝、边界和恢复。保留“全部”“仅当”等限定；测试数据不能反向扩展业务规则。
 
-```gherkin
-假如 <上下文>
-当 <操作>
-那么 <可观察结果>
-```
+| ID | 需求引用 | 前提 | 触发 | 可观察结果 | 场景类型 | 未决项 |
+|---|---|---|---|---|---|---|
+| AC-001 | FR-001 | <填写> | <填写> | <填写或待确认 Q-001> | 成功 / 拒绝 / 边界 / 状态变化 / 恢复 | 无 / Q-001 |
+
+可在表后补充 Gherkin 示例；正式 ID 在表中登记。FR/NFR/AC 在同一功能内稳定，重排不重新编号，删除后不复用。来源使用项目根相对路径及已有 ID；无 ID 时引用准确章节名，不伪造锚点。详见 [表达约定与诊断](../process/plan-spec-quality.md)。
 
 ## 产品总体设计 / 功能架构
 
@@ -100,11 +106,13 @@ owner: ai
 
 ## AI / 人工审查点
 
+以下三行仅为示例，起草时替换为实际影响面；审查与会签以既有角色政策为准，示例不会新增门禁。
+
 | 范围 | Agent 权限 | 是否需要人工审查 | 备注 |
 |---|---|---|---|
-| 支付逻辑 | 记录验证证据 | 是 | |
-| 原生 SQL | 记录验证证据 | 是 | |
-| 公共基础库 API | 记录验证证据 | 是 | |
+| 示例：支付逻辑 | 记录验证证据 | 是 | |
+| 示例：原生 SQL | 记录验证证据 | 是 | |
+| 示例：公共基础库 API | 记录验证证据 | 是 | |
 
 ## 非目标范围
 
@@ -113,3 +121,11 @@ owner: ai
 ## 风险
 
 记录已知风险和未决项的影响、责任人、解决时点及接收方；尚未明确原因时保留现象和验证方法。
+
+## 未决项
+
+| ID | 问题 | 判断依据 | 责任人 | 解决时点 | 接收方 / 解决证据 |
+|---|---|---|---|---|---|
+| Q-001 | <未知事项及补齐动作> | <影响与延期理由> | <负责人> | <解决时点> | <接收方> |
+
+未决项不会因验收示例而转成已确认行为；适用条件不命中时保留原因。`content_profile` 可选，仅声明创作格式，不代表生命周期 schema 或批准状态。

package/template/.template-spec/templates/vertical-slice-ticket-template.md

@@ -1,5 +1,9 @@
 ---
+kind: vertical-slice-ticket
 status: ready-for-human
+business_ticket_set_ref: docs/.scratch/<feature>/business-ticket-set.yaml
+business_ticket_refs: [BT-001]
+acceptance_refs: [AC-001]
 requirement_version: v1
 ---
 

package/template/AGENTS.md

@@ -36,8 +36,8 @@
 
 - 先按 `.template-spec/process/harness-process-tailoring.md` 判定影响面和最近可信阶段，再由 `yss-product-lifecycle` 执行 `.template-spec/process/lifecycle-registry.yaml`；阅读导航见 `.template-spec/process/lifecycle-artifact-map.md`。
 - 命中门禁必须完成；仅未命中时记录带原因的 `not-applicable`，不得生成空文档或混淆门禁、产物、工作单元、证据。安全 / 权限写入普通 Spec、契约、架构、验收和 seam，按实际影响触发门禁。
-- 新功能和较大变更先进入 Plan；`grill-with-docs`、`to-spec`、`to-tickets`、`implement` 仅为用户显式兼容入口。API 变更先形成 OpenAPI 3.1 Draft，审查后 Freeze，再实现。
-- Spec Delta 只记冻结基线的高风险行为差异。OpenAPI Freeze 或无 API 影响记录后拆窄垂直切片，禁止仅按技术层横拆。
+- 新功能和较大变更先进入 Plan；`to-spec`、`to-tickets`、`implement` 仅为用户显式兼容入口。API 变更先形成 OpenAPI 3.1 Draft，审查后 Freeze，再实现。
+- Spec 综合同时起草业务 Ticket 集，Design 校准同一组 ID；业务正式化后战略交接或技术分析，协议见 `.template-spec/process/business-tickets.md`。业务票不授予实现资格。Spec Delta 只记冻结基线的高风险行为差异。OpenAPI Freeze 或无 API 影响记录后拆窄垂直切片，禁止仅按技术层横拆。
 - `seam-deferred` 必须记录风险、责任人、后续 Ticket、验证计划和目标版本或发布日期。
 
 ## 6. Ticket 与状态

package/template/CONTEXT.md

@@ -9,6 +9,10 @@ context_schema_version: 1
 
 只有在计划、分诊、调试或架构讨论中明确沉淀出稳定语言时，才新增术语。
 
+## 消费规则
+
+探索仓库、起草 Spec / Ticket、架构设计和实现前读取根目录唯一的 CONTEXT.md，并按当前影响面读取 docs/adr/。合同缺失时先恢复，不能临时另建词汇表。Spec、Ticket 标题、测试、架构说明和总结使用已确认的中文术语；与冻结术语或 ADR 冲突时先明确冲突。稳定术语由 domain-modeling 维护，临时猜测留在决策前沿。生命周期引用保存结构化 snapshot 与双摘要，不使用 Markdown 伪锚点。
+
 ## 流程术语
 
 模板源与生命周期协作概念放在本节。`英文标识` 填 `—`，不回溯补译。
@@ -42,6 +46,7 @@ context_schema_version: 1
 | 阶段工作项 | Plan、Spec、Design 中有明确负责人、验收和证据的工作记录；当前进度由 checkpoint.stage_tracking 持有，按需独立落盘。 | — | 不等同于业务 Ticket 或可实现垂直切片，不授予 ready-for-agent。 |
 | Ticket | 在追踪平台上承载功能生命周期或可实现工作单元的通用追踪对象。 | — | GitHub Issues / GitLab Issues 是具体平台对象名称；领域资产统一称为 Ticket。 |
 | 功能父 Ticket | 汇总一个功能从 Plan 或最近可信接入阶段到契约冻结的阶段状态、资产链接、审查结论和阻塞项的 Ticket。 | — | 不作为 Agent 直接实现的垂直切片。 |
+| 业务 Ticket | Spec 起草、Design 校准的用户行为和可验收结果；集合保存引用、覆盖和依赖。 | — | 不依赖实现工程，不授予 ready-for-agent；可由研发细化为多个实现 Slice。 |
 | 垂直切片 Ticket | 契约冻结后生成的可独立验证实现单元，记录范围、阻塞关系、验收标准和验证证据。 | — | 只有通过必要门禁并具备直接实现条件时才能标记 `ready-for-agent`。 |
 | `ready-for-human` | 表示 Spec、设计、契约草案或其他资产仍需会签（指定数字人或生物人）。 | — | 此状态不表示可以直接进入实现；也不等于某个数字人角色。 |
 | `ready-for-agent` | 表示垂直切片已通过必要门禁并具备直接实现条件的流程状态。 | — | 不得用于 Spec 初稿、原型、OpenAPI Draft 或其他未冻结资产。 |
@@ -62,7 +67,7 @@ context_schema_version: 1
 | Fresh Verification | 完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。 | — | 不等同于“之前跑过”或实现者自述。 |
 | `implementation-ready` | 模板维护实现和命中影响面的快速核验已经完成，但尚未冻结正式审查候选。 | — | 是模板维护默认出口；不等同于 `ready-for-agent`、已审查或可发布。 |
 | `review-ready` | 模板维护显式选择独立审查时的就绪状态；旧候选协议要求 candidate 核验、首次完整验证和摘要冻结。 | — | Reviewer 必须消费同一候选摘要；候选字节变化后旧审查失效。 |
-| `release-ready` | 模板维护已完成维护者自检和发布前完整 Fresh Verification；显式选择独立审查时还须闭合该审查。 | — | 仍不替代 `gate.release-ready` 所需的生物人发布裁决。 |
+| `release-ready` | 模板维护已完成维护者自检和发布前完整 Fresh Verification；显式选择独立审查时还须闭合该审查。 | — | 交付验收使用 `gate.delivery-accepted`；实际合并、发布仍须单独取得生物人授权。 |
 | 实现验证命令 | 前端测试 / 构建优先 `pnpm`，后端校验 / 测试 / 编译优先 `./mvnw`。 | — | 不要默认 `npm`、`yarn` 或裸 `mvn`；仓库确实缺少 pnpm 或 Maven Wrapper 时记受控例外。 |
 | 脚手架架构选择 | 新建后端工程在工程基线中对 `domain-driven` 与 `layered-mvc` 的结构化选择；Agent 提供证据化推荐，用户确认后由生命周期批准并供脚手架合同消费。 | — | 不是新门禁，也不是生成器内的交互参数；缺失、未确认或摘要漂移时阻断生成。 |
 | 测试质量基线 | 项目实例明确采纳的覆盖率阈值、关键流程清单和受控例外。 | — | 模板推荐值本身不构成可执行门禁；未定义关键流程时，不得声称其 E2E 覆盖率达到 100%。 |

package/template/DESIGN.md

@@ -77,6 +77,23 @@ spacing:
   xxl: 48px
 
 components:
+  workspace-header:
+    height: 48px
+    backgroundColor: "{colors.surface}"
+    typography: "{typography.body}"
+  workspace-sidebar:
+    width: 240px
+    backgroundColor: "{colors.surface}"
+  workspace-sidebar-collapsed:
+    width: 64px
+  workspace-tabs:
+    height: 32px
+    backgroundColor: "{colors.surface}"
+  workspace-detail:
+    width: 384px
+    backgroundColor: "{colors.surface}"
+  workspace-title:
+    typography: "{typography.heading-md}"
   separator:
     backgroundColor: "{colors.border}"
     height: 1px
@@ -226,7 +243,7 @@ components:
 
 YSS is an enterprise UI system for dense, scannable work surfaces: tables, forms, filters, workflows and operational feedback. This file is the normative source for visual tokens and component visual variants. Product behavior remains in Spec, interaction specifications and state matrices.
 
-The default theme adopts Data Quality global tokens on the Ant Design v6 design foundation: light mode, primary #3371ff, body 14px, controls 32/24/40px, radii 6/4/8px and card padding 20px. Compact and dark modes are opt-in. Data Quality runs Vue 3 + Ant Design Vue 4.2.6 + YSS UI; that runtime version is distinct from the design foundation. Client-specific JSP themes and page-local glass effects are not defaults. Prototypes use HTML/CSS/JavaScript with local token CSS. Production applications use the target implementation contract and lockfile; prototype visuals do not establish production component API compatibility.
+The production default theme adopts Data Quality global tokens on the Ant Design v6 design foundation: light mode, primary #3371ff, body 14px, controls 32/24/40px, radii 6/4/8px and card padding 20px. Production compact remains opt-in. New high-fidelity prototypes default to light compact using the named variants below; comfortable remains available. Existing page changes preserve their approved density and layout. Dark assets are historical references, unverified against the current specification, and are outside the default prototype route. Data Quality runs Vue 3 + Ant Design Vue 4.2.6 + YSS UI; that runtime version is distinct from the design foundation. Client-specific JSP themes and page-local glass effects are not defaults. New high-fidelity prototypes primarily use prebuilt shadcn-vue + Vue 3 with local token CSS. React authoring libraries and generation routes are retired; sealed React evidence is read-only legacy. Native HTML/CSS/JavaScript remains the lightweight route. Use registered components for product controls and task-specific compositions; upstream Blocks do not override these tokens or approved behavior. Production applications use the target implementation contract and lockfile; prototype visuals do not establish production component API compatibility.
 
 ## Colors
 
@@ -238,7 +255,9 @@ Use the system font stack, 14px body text and 400/600 weights. Use `caption` onl
 
 ## Layout
 
-Use a 4px spacing grid and the spacing tokens above. Use the default 32px control variant directly in HTML prototypes. The explicit compact variant uses 28px; small and large controls use 24px and 40px. When production uses an Ant Design theme algorithm, keep its seed `controlHeight` at 32px and apply compact once; never seed 28px and compact again. Page, container and overlay surfaces form the base three-layer model. On narrow screens, toolbars and filters reflow or collapse; table overflow is restricted to the table container.
+New enterprise prototypes use an application shell with module navigation, grouped sidebar, closable page Tags and a full-width work area. Page Tags are navigation controls with a subtle primary tint and border for the current page, separate activation and close buttons, and no Tab underline. Reserve Tabs for views within a page; their active state uses primary text and an indicator without a filled pill. The existing workspace-tabs roles continue to size and color the Tag strip. Collapsed sidebar items remain centered with a visible current-page marker and inverse Tooltips; tooltip bodies and arrows share the same surface. Shell dimensions come from the workspace component roles above. At 1200px and above the sidebar starts expanded; from 768px to 1199px it starts collapsed; below 768px navigation uses a modal Sheet. A selected list detail occupies the workspace-detail role on wide desktop and a Sheet below 1200px; no empty detail column is reserved. Forms retain a bounded reading width within the fluid workspace. Use one main vertical work-area scroll, an independent detail scroll where needed and localized table overflow. Workspace page titles use workspace-title; avoid repeating a large decorative title above task controls. These are prototype defaults, not an automatic migration of approved or production pages.
+
+Use a 4px spacing grid and the spacing tokens above. New prototypes use the named compact control variant (28px) on desktop, the ordinary variant (32px) on narrow screens, and body typography (14px) throughout. Comfortable uses the ordinary control and card variants. Compact uses card-compact padding on desktop and spacing.sm on narrow screens. Small and large control variants remain 24px and 40px. These named prototype variants are not the full production tokens.compact.json algorithm result; do not apply a compact algorithm to them. When production uses an Ant Design theme algorithm, keep its seed `controlHeight` at 32px and apply compact once; never seed 28px and compact again. Page, container and overlay surfaces form the base three-layer model. On narrow screens, toolbars and filters reflow or collapse; table overflow is restricted to the table container.
 
 ## Elevation & Depth
 
@@ -250,12 +269,12 @@ Controls use `rounded.md` (6px); cards and overlays use `rounded.lg` (8px); comp
 
 ## Components
 
-The component keys above describe default visual variants and explicitly named optional sizes, not business states. Default controls use a 32px computed height, 14px body type, pale semantic feedback surfaces and visible focus rings. Required implementation states include hover, focus, active, disabled, loading, error, empty, readonly, no-permission, conflict and success. Define those behavior and acceptance details in the lifecycle state-matrix and prototype evidence assets.
+The component keys above describe default visual variants and explicitly named optional sizes, not business states. The ordinary control variant uses a 32px computed height; prototype density selects the named variant as described in Layout. All variants retain body typography, pale semantic feedback surfaces and visible focus rings. Validate actual target size and spacing, keyboard operation and focus; control height alone does not establish accessibility. Required implementation states include hover, focus, active, disabled, loading, error, empty, readonly, no-permission, conflict and success. Define those behavior and acceptance details in the lifecycle state-matrix and prototype evidence assets.
 
 ## Do's and Don'ts
 
 - Do consume tokens through ConfigProvider, CSS variables or the target component library theme.
-- Do use the verified derived dark/compact token snapshot for HTML; production theme algorithms remain implementation-specific.
+- Do use local CSS projected from this specification for prototypes; production theme algorithms remain implementation-specific. Dark snapshots are historical and require new derivation and validation before adoption.
 - Do verify desktop (`1440x900`), mobile (`390x844`) and impacted intermediate viewports.
 - Do provide visible feedback for save, submit, publish, export and retry actions.
 - Don’t use marketing hero layouts, large gradients or decorative cards in operational pages.