create-yss-spec 1.1.4 → 2.0.0

package/template/docs/process/harness-process-tailoring.md

@@ -1,31 +1,40 @@
 # Harness 流程裁剪指南
 
-本文定义 Harness 工程在不同任务规模下的最小流程、最近可信阶段和升级条件。它补充 `docs/process/lifecycle-artifact-map.md`，不替代其中的 8 个主阶段和 21 个门禁。
+本文定义 `project-instance` 在不同任务规模下的最小流程、最近可信阶段和升级条件。它补充 `docs/process/lifecycle-artifact-map.md`，不替代其中的 8 个主阶段和 21 个条件强制门禁。`template-source` 使用 `AGENTS.md` 中的模板维护流程。
 
-本仓库默认使用 Matt Pocock Engineering Skills 承接需求澄清、PRD、Issue 拆分、实现、TDD、诊断、审查和架构治理。OpenAPI 3.1 继续作为前后端契约资产；OpenSpec-style Spec Delta 只作为中高风险变更的轻量行为差异记录，不再引入额外变更状态机。
+本仓库默认使用 Matt Pocock Engineering Skills 承接需求澄清、Spec、Ticket 拆分、实现、TDD、诊断、审查和架构治理。OpenAPI 3.1 继续作为前后端契约资产；OpenSpec-style Spec Delta 只作为中高风险变更的轻量行为差异记录，不再引入额外变更状态机。
 
 ## 三档流程
 
 | 档位 | 适用场景 | 最小入口 | 最小产物 | 最小验证 | 典型退出标准 |
 |---|---|---|---|---|---|
-| 小改动 | 文案、局部样式、配置微调、无 API / 数据 / 权限影响的低风险修正 | 影响面评估 | issue 备注或简短实施说明 | 相关页面 / 命令 / 文档检查 | 变更范围清楚、验证新鲜、无安全红线 |
-| 中等变更 | 已有功能迭代、已有页面 / API 的局部扩展、非核心流程调整 | 最近可信阶段 | 受影响 PRD / 设计 / OpenAPI / 架构 / Issue 的增量更新；必要时 Spec Delta | 受影响切片测试、契约检查、review | 下游门禁补齐，未受影响资产不重跑 |
-| 新模块 / 高风险变更 | 新产品、新业务域、新模块、跨端协作、服务边界、数据模型、权限、安全或发布回滚变化 | 入口分诊 | Discovery、PRD、设计、OpenAPI、Spec Delta、架构、垂直切片 Issue | TDD、契约验证、独立审查、fresh verification | 完整生命周期关键门禁都有证据 |
+| 小改动 | 文案、局部样式、配置微调、无 API / 数据 / 权限影响的低风险修正 | 影响面评估 | Ticket 备注或简短实施说明 | 相关页面 / 命令 / 文档检查 | 变更范围清楚、验证新鲜、无高风险变更或需人工确认项 |
+| 中等变更 | 已有功能迭代、已有页面 / API 的局部扩展、非核心流程调整 | 最近可信阶段 | 受影响 Spec / 设计 / OpenAPI / 架构 / Ticket 的增量更新；必要时 Spec Delta | 受影响切片测试、契约检查、review | 下游门禁补齐，未受影响资产不重跑 |
+| 新模块 / 高风险变更 | 新产品、新业务域、新模块、跨端协作、服务边界、数据模型、权限、安全或发布回滚变化 | 入口分诊 | Discovery、Spec、设计、OpenAPI、架构、垂直切片 Ticket；修改既有冻结基线时补 Spec Delta | TDD、契约验证、独立审查、fresh verification | 命中的生命周期门禁都有证据，未命中项已标记 `not-applicable` |
+
+## Subagent 裁剪规则
+
+| 档位 | subagent 使用建议 | 任务包要求 |
+|---|---|---|
+| 小改动 | 默认不派 subagent；只有需要独立验证或防止自审时才派 Reviewer / Verifier | 可在 issue 备注或 checkpoint 中轻量记录 |
+| 中等变更 | 可派 Drafter / Reviewer / Verifier 处理受影响资产、契约检查和回归验证 | 必须记录输入、输出、写范围、验收标准和主控采纳结论 |
+| 新模块 / 高风险变更 | 建议按 Explorer / Drafter / Worker / Reviewer / Verifier 并行拆分，但写范围必须不重叠 | 必须使用 `docs/templates/subagent-task-package-template.md` 或等价字段，并在阶段 checkpoint 中汇总 |
 
 ## 最近可信阶段判定表
 
 | 当前输入 / 变更事实 | 最近可信阶段 | 需要补齐的下游 |
 |---|---|---|
-| 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、PRD、产品总体设计 / 功能架构 |
-| 需要技术事实、标准、第三方 API 或框架行为支撑决策 | 2. 机会与 Discovery 或 5. 系统 / 数据架构与工程契约设计审查 | `research` 或等价一手资料记录，并回填到 PRD、OpenAPI、架构或 ADR |
-| 已有清晰 PRD，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / PRD / 功能架构 | PRD Review、产品总体设计 / 功能架构、必要的页面 / 原型 / 交互设计 |
-| 状态机、复杂规则或 UI 方向无法仅靠文字判断 | 3. 业务 / PRD / 功能架构 或 4. 产品设计与需求冻结 | `prototype` 一次性验证结论，并回填到 PRD / 设计 / ADR / Issue |
-| 有 UI 变更但缺页面流、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据或用户确认记录 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型（可在低保真评审通过后由系统 / Agent 自动产出）、AntD CLI 校验证据、用户确认记录、PRD 回填 |
-| API 路径、schema、错误结构、分页或权限发生变化 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft Review、必要时 Spec Delta、系统 / 数据架构反审、Freeze、`to-issues` |
+| 只有模糊想法、业务机会或竞品输入 | 2. 机会与 Discovery | Discovery、`grill-with-docs`、Spec、产品总体设计 / 功能架构 |
+| 需要技术事实、标准、第三方 API 或框架行为支撑决策 | 2. 机会与 Discovery 或 5. 系统 / 数据架构与工程契约设计审查 | `research` 或等价一手资料记录，并回填到 Spec、OpenAPI、架构或 ADR |
+| 已有清晰 Spec，但用户、痛点、MVP 或非目标不稳 | 3. 业务 / Spec / 功能架构 | Spec Review、产品总体设计 / 功能架构、必要的页面 / 原型 / 交互设计 |
+| 状态机、复杂规则或 UI 方向无法仅靠文字判断 | 3. 业务 / Spec / 功能架构 或 4. 产品设计与需求冻结 | `prototype` 一次性验证结论，并回填到 Spec / 设计 / ADR / Ticket |
+| 有 UI 变更但缺页面流、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据或用户确认记录 | 4. 产品设计与需求冻结 | 交互说明、状态矩阵、Prototype Review、Ant Design v6 高保真 HTML 原型（可在低保真评审通过后由系统 / Agent 自动产出）、AntD CLI 校验证据、用户确认记录、Spec 回填 |
+| API 路径、schema、错误结构、分页或权限发生变化 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft Review、必要时 Spec Delta、系统 / 数据架构反审、Freeze、`to-tickets` |
 | 服务边界、集成、部署、性能、可靠性或运维变化 | 5. 系统 / 数据架构与工程契约设计审查 | 系统架构、Design Review、必要时 Spec Delta、Build Architecture Checklist |
 | 持久化、元数据、版本、血缘、搜索、索引或迁移变化 | 5. 系统 / 数据架构与工程契约设计审查 | 数据架构、必要时 Spec Delta、人审点、Repository / MyBatis 前置审查 |
-| OpenAPI 已冻结但还没有垂直切片 Issue | 6. 契约冻结与 Issue formalization | `to-issues`、实施计划、Build Architecture Checklist |
-| 已有垂直切片 Issue，但实现准备不完整 | 7. 垂直切片与 TDD 实现 | 实施计划、YSS skill routing、测试命令、回滚点 |
+| OpenAPI 已冻结但还没有垂直切片 Ticket | 6. 契约冻结与 Ticket 正式化 | `to-tickets`、实施计划、Build Architecture Checklist |
+| 已有垂直切片 Ticket，但实现准备不完整 | 7. 垂直切片与 TDD 实现 | 实施计划、YSS skill routing、实现仓库登记或外部脚手架目标确认、测试命令、回滚点 |
+| 0-1 项目缺 backend / frontend 可用工程 | 7. 垂直切片与 TDD 实现 | 登记 `scaffold_status=required`，确认目标仓库或输出目录，路由 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` |
 | 跨线程、跨仓库、上下文过长或原型分支需要回流 | 7. 垂直切片与 TDD 实现 | `handoff` 或等价交接记录、实现仓库绑定、验证命令 |
 | 只有代码修复或测试失败 | 7. 垂直切片与 TDD 实现 | 可复现命令、失败测试、最小修复、fresh verification |
 | merge / rebase 冲突阻塞交付 | 7. 垂直切片与 TDD 实现 | `resolving-merge-conflicts` 或等价冲突处理记录、重新验证 |
@@ -36,21 +45,24 @@
 任一条件命中时，不得按小改动处理，必须升级到对应最近可信阶段：
 
 - API 契约、OpenAPI schema、错误结构、分页、权限或版本发生变化。
-- 认证、授权、支付、加密、SQL 原生查询、数据库迁移、公共基础库 API 等安全红线被触碰。
+- 认证、授权、支付、加密、SQL 原生查询、数据库迁移、公共基础库 API 等存在高风险变更。
 - 数据模型、Repository / Gateway、持久化边界、审计日志、文件上传下载、临时 URL、版本快照、血缘或查询索引变化。
+- DDL / SQL / 数据库迁移、权限接入或审计日志缺少明确人工确认结论。
+- 当前切片影响 backend / frontend，但既无可复用实现仓库登记，也未确认 0-1 外部脚手架目标。
 - 服务边界、外部系统集成、部署、回滚、可观测性、性能、可靠性或运维约束变化。
 - UI 变更影响用户主流程、权限状态、异常状态、页面导航或 OpenAPI 反推清单。
-- 实现与既有架构、CONTEXT 术语、ADR、PRD 或垂直切片 Issue 出现漂移。
-- 技术事实、标准或第三方 API 判断会影响 PRD、OpenAPI、架构、验收或发布风险，且当前没有一手资料记录。
+- 实现与既有架构、CONTEXT 术语、ADR、Spec 或垂直切片 Ticket 出现漂移。
+- 技术事实、标准或第三方 API 判断会影响 Spec、OpenAPI、架构、验收或发布风险，且当前没有一手资料记录。
 - 当前工作需要跨线程、跨仓库、原型分支回流或上下文交接，但没有 handoff / 等价交接记录。
 - 无法给出 fresh verification 证据。
 
 ## 裁剪原则
 
 - 裁剪的是不相关阶段和产物，不裁剪证据链。
+- 未命中条件门禁时记录 `not-applicable` 及原因，不生成空文档。
 - 中等变更只补受影响阶段及其下游，不回到机会探索。
 - 小改动必须保留影响面评估、验证证据和 Git checkpoint 判断。
-- 小改动默认不创建 Spec Delta；只有扩散到 API、权限、状态机、数据模型、跨端或安全红线时才升级补齐。
+- Spec Delta 只用于修改既有冻结基线的中高风险行为；全新产品 / 模块、小文案、局部样式、配置微调和低风险 Bug 默认不创建。
 - 小改动默认不需要 `research`、`prototype` 或 `handoff`；只有事实依据、设计验证或交接风险会影响后续门禁时才触发。
-- 安全红线只能进入人工审查或草案状态，不能因任务小而跳过。
-- OpenAPI Freeze 后直接进入 `to-issues` 或等价垂直切片拆分；不要求额外变更状态文件。
+- 存在高风险变更时必须记录验证证据、责任人和回滚约束，不能因任务小而跳过。
+- OpenAPI Freeze 后直接进入 `to-tickets` 或等价垂直切片拆分；不要求额外变更状态文件。

package/template/docs/process/harness-work-unit-map.md

@@ -10,16 +10,16 @@
 
 ## 映射表
 
-| PPT 工作单元 | 对应主阶段 | 对应门禁 / 职责点 | 关键产物 | 推荐 Skill / 能力 | 可裁剪 | 自动化潜力 |
+| 工作单元 | 对应主阶段 | 对应门禁 / 职责点 | 关键产物 | 推荐 Skill / 能力 | 可裁剪 | 自动化潜力 |
 |---|---|---|---|---|---|---|
 | 0. 机会 / 问题收集 | 1. 入口分诊；2. 机会与 Discovery | 0. 入口分诊；1. 机会探索 | 分诊结论、Discovery 收敛、MVP 边界 | `yss-product-lifecycle`、`competitive-intelligence`、Discovery 模板 | 小改动可跳过；新产品 / 新模块必需 | 半自动生成分诊清单、竞品情报简报和 Discovery 模板 |
-| 1. 需求澄清 | 3. 业务 / PRD / 功能架构 | 3. 需求澄清 | 澄清记录、用户 / 痛点 / 验收标准 | `grill-with-docs`、`to-prd` | 小文案 / 单点 bug 可轻量化 | 半自动生成澄清问题和缺口清单 |
-| 2. PRD -> 产品总体设计 -> 原型校准 | 3. 业务 / PRD / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. PRD 校准 / 需求冻结 | PRD、产品总体设计 / 功能架构、低保真原型、页面清单、状态矩阵、原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据、用户确认记录、需求冻结 | `yss-design-system`、`product-design:index`、Product Design focused skills（`$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code`）、`antd`、`prototype-review` | 无 UI 可省略后续交互原型；进入 PRD 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时产品原型产出以 `product-design:index` 路由为主，低保真评审通过后不得省略高保真 HTML 原型，可由系统 / Agent 自动产出，产出前后必须使用 `antd` CLI 校验并在产出后获得用户确认；中等变更只补受影响页面 | 半自动检查 PRD 字段、产品总体设计、低保真原型、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据和用户确认记录 |
-| 3. SDD 研发规范基线 | 5. 系统 / 数据架构与工程契约设计审查；6. 契约冻结与 Issue | 8. API 影响分析 / 契约草案；9. 工程基线；13. 契约冻结；14. Issue formalization | API 影响记录、契约草案 / OpenAPI Draft / Freeze、Spec Delta、工程基线、垂直切片 Issue、实施路由、验证证据 | `to-issues`、`yss-router` | 无 API / 无工程边界变化时记录无影响结论；低风险小改动跳过 Spec Delta | 自动检查 OpenAPI Freeze / no API impact / Spec Delta / vertical slice Issue / implementation routing |
-| 4. DDD 领域建模 | 3. 业务 / PRD / 功能架构；5. 系统 / 数据架构与工程契约设计审查 | 2. 业务架构；10. 系统总体架构；11. 数据架构 | CONTEXT 术语、业务能力、领域边界、聚合 / 状态规则 | `domain-modeling`、`yss-domain-modeling`、`yss-domain` | 小改动只校验是否影响既有术语或边界 | 半自动检查术语回填和领域边界审查项 |
+| 1. 需求澄清 | 3. 业务 / Spec / 功能架构 | 3. 需求澄清 | 澄清记录、用户 / 痛点 / 验收标准 | `grill-with-docs`、`to-spec` | 小文案 / 单点 bug 可轻量化 | 半自动生成澄清问题和缺口清单 |
+| 2. Spec -> 产品总体设计 -> 原型校准 | 3. 业务 / Spec / 功能架构；4. 产品设计与需求冻结 | 4. 需求基线 / 功能架构；5. 页面 / 原型 / 交互设计；6. 原型评审；7. Spec 校准 / 需求冻结 | Spec、产品总体设计 / 功能架构、低保真原型、页面清单、状态矩阵、原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据、用户确认记录、需求冻结 | `yss-design-system`、`product-design:index`、Product Design focused skills（`$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code`）、`antd`、`prototype-review` | 无 UI 可省略后续交互原型；进入 Spec 初稿 / 需求基线流程时不得省略产品总体设计及其低保真原型；有 UI 时产品原型产出以 `product-design:index` 路由为主，低保真评审通过后不得省略高保真 HTML 原型，可由系统 / Agent 自动产出，产出前后必须使用 `antd` CLI 校验并在产出后获得用户确认；中等变更只补受影响页面 | 半自动检查 Spec 字段、产品总体设计、低保真原型、状态矩阵、原型评审、高保真 HTML 原型、AntD CLI 校验证据和用户确认记录 |
+| 3. SDD 研发规范基线 | 5. 系统 / 数据架构与工程契约设计审查；6. 契约冻结与 Ticket | 8. API 影响分析 / 契约草案；9. 工程基线；13. 契约冻结；14. Ticket 正式化 | API 影响记录、契约草案 / OpenAPI Draft / Freeze、Spec Delta、工程基线、垂直切片 Ticket、实施路由、验证证据 | `to-tickets`、`yss-router` | 无 API / 无工程边界变化时记录无影响结论；低风险小改动跳过 Spec Delta | 自动检查 OpenAPI Freeze / no API impact / Spec Delta / vertical slice ticket / implementation routing |
+| 4. DDD 领域建模 | 3. 业务 / Spec / 功能架构；5. 系统 / 数据架构与工程契约设计审查 | 2. 业务架构；10. 系统总体架构；11. 数据架构 | CONTEXT 术语、业务能力、领域边界、聚合 / 状态规则 | `domain-modeling`、`yss-domain-modeling`、`yss-domain` | 小改动只校验是否影响既有术语或边界 | 半自动检查术语回填和领域边界审查项 |
 | 5. 架构设计 | 5. 系统 / 数据架构与工程契约设计审查 | 8. API 影响分析 / 契约草案；9. 工程基线；10. 系统总体架构；11. 数据架构；12. 设计审查 | API 影响记录、工程基线、系统概要设计、数据架构、ADR 候选、架构评审 | `codebase-design`、`improve-codebase-architecture`、YSS 架构模板 | 不触碰 API、工程边界、服务边界、数据、NFR、部署时可轻量记录无影响 | 半自动生成 Architecture Review checklist |
-| 6. 垂直切片 Issue | 7. 垂直切片与 TDD 实现 | 15. 实施计划 | 垂直切片 Issue、实现路由、Build Architecture Checklist | `to-issues`、`yss-router`、`implement` | 小改动可用单一 Issue / 实施备注替代 | 半自动检查切片是否端到端而非横向拆层 |
-| 7. 垂直 Issue 详细设计 | 7. 垂直切片与 TDD 实现 | 15. 实施计划 | 切片设计、接口字段映射、回滚点、架构约束绑定 | 实现计划模板、Build Architecture Checklist 模板 | 低风险小改动可合并到实施说明 | 半自动生成字段映射和架构约束回勾表 |
+| 6. 垂直切片 Ticket | 7. 垂直切片与 TDD 实现 | 15. 实施计划 | 垂直切片 Ticket、实现路由、Build Architecture Checklist | `to-tickets`、`yss-router`、`implement` | 小改动可用单一 Ticket / 实施备注替代 | 半自动检查切片是否端到端而非横向拆层 |
+| 7. 垂直切片详细设计 | 7. 垂直切片与 TDD 实现 | 15. 实施计划 | 切片设计、接口字段映射、回滚点、架构约束绑定 | 实现计划模板、Build Architecture Checklist 模板 | 低风险小改动可合并到实施说明 | 半自动生成字段映射和架构约束回勾表 |
 | 8. TDD 并行开发 | 7. 垂直切片与 TDD 实现 | 16. 开发实现 | 失败测试、最小实现、重构记录 | `tdd`、YSS 实现专项 Skill | 文档-only 变更可说明 TDD 例外 | 自动执行测试命令并收集 fresh verification |
 | 9. 测试验证 | 7. 垂直切片与 TDD 实现；8. 验证发布与复盘 | 16. 开发实现；19. 验证发布 | 测试报告、验收映射、fresh verification | fresh verification 记录、验证模板 | 不可裁剪为“未验证”；只能裁剪验证范围 | 自动跑命令、汇总覆盖率和验收映射 |
 | 10. Code Review | 7. 垂直切片与 TDD 实现 | 17. 独立审查；18. 清理简化 | Review Report、MR / PR 评论、清理项 | `code-review`、`code-review-process` | 合并 / 发布前不可跳过；小改动可轻量 review | 半自动生成 review checklist，人工确认风险 |
@@ -28,6 +28,6 @@
 
 ## 不变规则
 
-- 13 个工作单元不能替代 OpenAPI Freeze、Issue formalization、Build Architecture Checklist、安全红线和 fresh verification。
+- 13 个工作单元不能替代 OpenAPI Freeze、Ticket 正式化、Build Architecture Checklist、风险 / 回滚约束和 fresh verification。
 - 裁剪只能减少不相关产物，不能裁剪关键追踪关系和验证证据。
-- 触碰安全红线时必须进入人工审查，不能被自动化门禁放行。
+- 自动化门禁不能替代业务取舍、不可逆变更或责任确认。

package/template/docs/process/implementation-repo-integration.md

@@ -1,12 +1,12 @@
 # 实现仓库接入流程
 
-本文定义研发管理仓库与外部实现仓库的集成方式。当前仓库默认作为研发管理仓库，承载 PRD、OpenAPI、Issue、架构、垂直切片、验证、发布和复盘；前端、后端和其他运行时代码默认保留在独立实现仓库中。
+本文定义研发管理仓库与外部实现仓库的集成方式。当前仓库默认作为研发管理仓库，承载 Spec、OpenAPI、Ticket、架构、垂直切片、验证、发布和复盘；前端、后端和其他运行时代码默认保留在独立实现仓库中。
 
 ## 职责边界
 
 | 仓库类型 | 职责 | 不负责 |
 |---|---|---|
-| 研发管理仓库 | 规格、契约、架构、切片、Issue 同步、验证记录、发布说明和复盘 | 长期拥有前端 / 后端源码、替代实现仓库 CI |
+| 研发管理仓库 | 规格、契约、架构、切片、Ticket 同步、验证记录、发布说明和复盘 | 长期拥有前端 / 后端源码、替代实现仓库 CI |
 | 实现仓库 | 前端 / 后端代码、分支、MR / PR、CI、测试命令、构建和发布流水线 | 定义跨仓库产品规格和生命周期门禁 |
 
 ## 接入路径
@@ -15,8 +15,8 @@
 |---|---|---|
 | 已有后端工程 | `implementation-repo-onboarding` 只读扫描，记录工程基线、测试命令和偏离项 | 实现仓库登记、工程基线审查、验证命令 |
 | 已有前端工程 | `implementation-repo-onboarding` 只读扫描，检查技术栈、OpenAPI client、设计 token 和页面规范 | 实现仓库登记、前端基线审查、验证命令 |
-| 0-1 后端工程 | 先在 Harness change 中记录实现仓库决策，再使用 `yss-ddd-scaffold-generator` 生成外部后端工程 | 后端 Git 仓库、YSS DDD 基线、Harness 登记 |
-| 0-1 前端工程 | 先记录实现仓库决策，再按 `yss-frontend-scaffold-generator` 使用 YSS 前端模板生成外部工程 | 前端 Git 仓库、前端模板基线、Harness 登记 |
+| 0-1 后端工程 | 先在 Harness change 中登记 `scaffold_status=required` 并确认外部脚手架目标，再使用 `yss-ddd-scaffold-generator` 生成后端工程 | 后端 Git 仓库或输出目录、YSS DDD 基线、Harness 登记 |
+| 0-1 前端工程 | 先登记 `scaffold_status=required` 并确认外部脚手架目标，再按 `yss-frontend-scaffold-generator` 使用 YSS 前端模板生成工程 | 前端 Git 仓库或输出目录、前端模板基线、Harness 登记 |
 | 跨仓库垂直切片 | 使用 `cross-repo-implementation-routing` 绑定 Harness change、后端 MR、前端 MR 和验证证据 | 跨仓库切片记录、fresh verification |
 
 ## 实现前工程存在性判定
@@ -24,14 +24,15 @@
 进入业务实现前，必须先判断当前需求受影响的 frontend / backend 运行时代码工程是否已经存在且可复用。该判定必须写入实施计划、实现路由记录或切片 issue，至少回答：
 
 - 当前切片是否影响 frontend、backend，或两者都影响。
-- 对应实现仓库 / 本地工程是否已经存在。
+- 对应实现仓库 / 本地工程是否已经存在；0-1 新项目中 backend / frontend 目录不存在时，登记为 `scaffold_status=required`，不得视为流程失败。
 - 已有工程是否满足当前 OpenAPI、设计系统、YSS DDD 或工程基线要求。
 - 若不存在或不可复用，是否需要初始化 0-1 脚手架，以及初始化到哪个目标仓库或输出目录。
+- 若涉及 DDL / SQL / 数据库迁移、权限接入或审计日志，是否已经拿到对应人工确认结论。
 
 判定结论的路由规则：
 
-- 后端受影响且不存在可用工程：先记录实现仓库决策，再路由 `yss-ddd-scaffold-generator`。
-- 前端受影响且不存在可用工程：先记录实现仓库决策，再路由 `yss-frontend-scaffold-generator`。
+- 后端受影响且不存在可用工程：先登记后端仓库或确认外部脚手架目标，再路由 `yss-ddd-scaffold-generator`。
+- 前端受影响且不存在可用工程：先登记前端仓库或确认外部脚手架目标，再路由 `yss-frontend-scaffold-generator`。
 - 前后端均受影响且均不存在可用工程：先分别完成前后端初始化，再进入垂直切片业务实现。
 - 工程已存在但与当前目录约定或技术基线冲突：先停在 engineering baseline / implementation routing，补齐偏离说明和处理决策。
 
@@ -43,7 +44,7 @@
 - Git URL、默认分支、本地 worktree 或远端 MR / PR 链接。
 - CI 系统、测试命令、构建命令。
 - OpenAPI 接入方式、设计 token 接入方式。
-- 已知偏离项、人审要求和补齐计划。
+- 已知偏离项、人工确认要求和补齐计划。
 
 登记记录可以放在当前 change 的 `design.md`、build entry review、实施计划或 `docs/implementation/` 下的实现记录中，但必须能被垂直切片和阶段 checkpoint 引用。
 
@@ -51,13 +52,14 @@
 
 - `scaffold_status`：existing / required / initialized。
 - `scaffold_skill`：`yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` / none。
-- 初始化理由、目标输出目录或目标仓库，以及是否已经通过基线检查。
+- 初始化理由、目标输出目录或目标仓库、用户是否已确认外部脚手架目标，以及是否已经通过基线检查。
+- DDL / SQL / 数据库迁移、权限接入、审计日志三类人工确认结论；不适用时必须写明不适用原因。
 
 ## 跨仓库切片规则
 
 每个跨前后端切片必须绑定以下信息：
 
-- Harness change：Issue change ID、垂直切片 ID、OpenAPI Freeze 记录。
+- Harness 追踪：功能父 Ticket ID、垂直切片 Ticket ID、OpenAPI Freeze 记录。
 - Backend：repo、branch、MR / PR、测试命令、验证结果。
 - Frontend：repo、branch、MR / PR、测试命令、验证结果。
 - Contract：OpenAPI spec 路径、生成类型或 API client 版本、契约验证命令。
@@ -76,6 +78,18 @@
 
 生成后必须使用 `yss-backend-scaffold-parent` 做工程基线检查，不得把脚手架 sample 代码当作业务实现交付。
 
+后端工程落地后，构建、测试、运行、OpenAPI 生成、CI、Review 和 Release 记录必须使用项目根目录的 Maven Wrapper：
+
+```bash
+./mvnw clean test
+./mvnw clean package
+./mvnw spring-boot:run -pl <service>-bootstrap
+```
+
+新脚手架必须保留并提交 `mvnw`、`mvnw.cmd` 和 `.mvn/` wrapper 资产。实现路由、Ticket、README、验证记录或 CI 中出现裸 `mvn ...` 时，默认判定为规范偏离；只有既有仓库确实无法使用 wrapper 且已在实现路由中记录受控例外时，才允许临时保留。
+
+若后端切片触碰 DDL / SQL / 数据库迁移、权限接入或审计日志，脚手架生成只能提供工程骨架和模板。业务实现前必须在登记记录、实施计划或切片 issue 中写明对应人工确认结论；缺少结论、验证证据或责任人时，不得宣称生产实现完成。
+
 ## 0-1 前端工程
 
 从零创建前端工程时，目标模板固定为：
@@ -95,6 +109,6 @@ http://192.168.167.142:8081/Data-Middleground-Develop-Area/product-code/ai-front
 - Harness 资产完成情况。
 - 各实现仓库 MR / PR 和 CI 状态。
 - 测试命令和 fresh verification。
-- 安全人审点、阻塞项和下一步。
+- 人工审查点、阻塞项和下一步。
 
 不得只在实现仓库 MR / PR 中保留结论；Harness 仓库必须保留可追溯的规格和验证证据。

package/template/docs/process/lifecycle-artifact-map.md

@@ -5,50 +5,64 @@ owner: ai
 
 # 产品研发生命周期产物映射表
 
-本文是本仓库产品研发流程的权威索引。日常执行使用 8 个主阶段；21 个门禁 / 职责点用于审查、路由和补齐缺失资产。小需求、Bug、局部样式或配置调整不重跑完整流程，只从最早受影响资产开始补齐下游门禁。
+本文是 `project-instance` 产品研发流程中主阶段、门禁、产物和退出标准的权威索引。日常执行使用 8 个主阶段；21 个门禁 / 职责点全部按影响面条件强制。未命中触发条件时记录 `not-applicable` 及原因，不生成空文档。`template-source` 使用 `AGENTS.md` 定义的模板维护流程，不适用本表的产品产物链。
 
-本仓库的默认流程已迁移为 Matt Pocock Engineering Skills + YSS + OpenAPI：用 Matt skills 做需求澄清、PRD、Issue 拆分、实现、TDD、诊断、审查和架构治理；用 YSS skills 做业务工程规范；用 OpenAPI 3.1 做前后端契约。中高风险变更可用 OpenSpec-style Spec Delta 补充行为差异、验收场景和测试映射，但不恢复 OpenSpec CLI 或额外变更状态机。
+项目实例的默认流程为 Matt Pocock Engineering Skills + YSS + OpenAPI：用 Matt skills 做需求澄清、Spec、Ticket 拆分、实现、TDD、诊断、审查和架构治理；用 YSS skills 做业务工程规范；用 OpenAPI 3.1 做前后端契约。Spec Delta 只表达相对既有冻结 Spec 基线的高风险行为差异，不用于全新产品或全新模块，也不恢复 OpenSpec CLI 或额外变更状态机。
 
 补充执行资产：
 
 - 13 个对外工作单元与本表的映射见 `docs/process/harness-work-unit-map.md`。
 - 小改动 / 中等变更 / 新模块的流程裁剪和最近可信阶段判定见 `docs/process/harness-process-tailoring.md`。
+- subagent 协同边界、任务包规则和不可委派门禁见 `docs/process/subagent-collaboration.md`，任务包模板见 `docs/templates/subagent-task-package-template.md`。
 - 外部前端 / 后端实现仓库的接入和跨仓库切片绑定见 `docs/process/implementation-repo-integration.md`。
-- 阶段结束的 Issue 同步与 Git checkpoint 记录可使用 `docs/process/templates/stage-checkpoint-template.md`。
+- 阶段结束的 Ticket 同步与 Git checkpoint 记录可使用 `docs/process/templates/stage-checkpoint-template.md`。
 
 ## 8 个主阶段
 
 | 主阶段 | 目标 | 必须产物 | 条件产物 | 下一门禁 |
 |---|---|---|---|---|
-| 1. 入口分诊 | 判断任务类型、风险等级、最近可信阶段和最小技能集 | 分诊结论或 issue 备注 | `yss-product-lifecycle` 路由结果、Git checkpoint 判断 | 是否需要 Discovery / PRD / API / 架构 / Issue |
-| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、`research` 技术 / 标准 / API 一手资料记录、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
-| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、`prototype` 一次性验证结论、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
-| 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型（可由系统 / Agent 在低保真评审通过后自动产出）、AntD CLI 校验证据和用户确认记录；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
+| 1. 入口分诊 | 判断任务类型、风险等级、最近可信阶段和最小技能集 | 分诊结论或 issue 备注 | `yss-product-lifecycle` 路由结果、Git checkpoint 判断 | 是否需要 Discovery / Spec / API / 架构 / Ticket |
+| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、`research` 技术 / 标准 / API 一手资料记录、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 Spec |
+| 3. 业务 / Spec / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级和验收标准 | `docs/requirements/<feature>-spec.md`；`docs/design/<feature>-product-overview-design.md` | 有 UI 影响时的低保真页面草图；`grill-with-docs` 澄清记录、`prototype` 一次性验证结论、业务架构、CONTEXT 术语回填；不进入 Spec 生命周期的小改动可记录不适用原因 | Spec Review / 产品总体设计评审 / 产品设计准备度 |
+| 4. 产品设计与需求冻结 | 基于 Spec 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 Spec 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型（可由系统 / Agent 在低保真评审通过后自动产出）、AntD CLI 校验证据和用户确认记录；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | Spec 校准 / 工程契约与架构设计准备度 |
 | 5. 系统 / 数据架构与工程契约设计审查 | 合并 API 影响分析、契约草案、工程基线、系统架构、数据架构和 Design Review；Draft 仅用于评审，Freeze 前不得作为实现或生成客户端契约 | 系统概要设计或等价架构记录；Design Review 结论；有 API 时：API 影响记录和契约草案 / review-only OpenAPI Draft；有后端结构影响时：工程基线审查 | OpenAPI Draft Review、OpenSpec-style Spec Delta、工程基线审查、无 API 影响记录、数据架构、ADR、架构图 | OpenAPI Freeze 准备度 |
-| 6. 契约冻结与 Issue formalization | 冻结契约并把交付范围转成可执行 Issue，并明确受影响前后端工程是否已存在 | OpenAPI Freeze 记录或无 API 影响记录；垂直切片 Issue 入口 | `to-issues` 输出、实施路由记录、实现仓库 / 脚手架判定、Issue tracker 同步 | 垂直切片准备度 |
-| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`handoff` / 跨仓库交接记录、`implement` / `tdd` 证据、`code-review` 报告、`resolving-merge-conflicts` 记录、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
+| 6. 契约冻结与 Ticket 正式化 | 冻结契约并把交付范围转成可执行 Ticket，并明确受影响前后端工程是否已存在 | OpenAPI Freeze 记录或无 API 影响记录；垂直切片 Ticket 入口 | `to-tickets` 输出、实施路由记录、实现仓库 / 脚手架判定、外部脚手架目标确认、Ticket tracker 同步 | 垂直切片准备度 |
+| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Ticket、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、DDL / SQL / 数据库迁移、权限接入和审计日志人工确认结论、`handoff` / 跨仓库交接记录、`implement` / `tdd` 证据、`code-review` 报告、`resolving-merge-conflicts` 记录、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
 | 8. 验证发布与复盘 | 保留发布、实施、验证和经验沉淀证据 | fresh verification、发布说明、复盘记录 | 实施记录、用户手册、`writing-skills` 压力场景 / 流程修订验证、AGENTS / CONTEXT / ADR 更新 | 下一轮规划 |
 
+## Subagent 协同映射
+
+| 主阶段 | 可委派的 subagent 工作 | 不可委派的主控裁决 | 记录要求 |
+|---|---|---|---|
+| 1. 入口分诊 | Explorer 检查现有资产、Ticket、git 状态 | 生命周期阶段判定、最近可信阶段选择 | 分诊记录或 checkpoint 说明是否使用 subagent |
+| 2. 机会与 Discovery | 竞品、市场、用户流程、技术事实调研 | 是否进入 Spec、MVP / 非目标最终取舍 | Discovery 或 Ticket 中引用调研任务包 |
+| 3. 业务 / Spec / 功能架构 | Spec 草案、功能架构草案、`grill-with-docs` 质询记录 | Spec baseline、Spec Review 最终结论 | Spec / 产品总体设计记录采纳与未采纳结论 |
+| 4. 产品设计与需求冻结 | 页面流、状态矩阵、AntD / YSS 查询、高保真原型、Prototype Review findings | 用户确认、requirement freeze | 原型确认记录和 checkpoint 记录 subagent 产出 |
+| 5. 系统 / 数据架构与工程契约设计审查 | API Draft、Draft Review、系统架构、数据架构、Spec Delta 草案 | OpenAPI Freeze、Architecture Review 最终放行、Spec Delta 必要性最终判断 | Design Review / OpenAPI Review 记录任务包和冲突裁决 |
+| 6. 契约冻结与 Ticket 正式化 | 垂直切片草案、实现仓库 / 脚手架状态检查 | Ticket 范围最终裁剪、Ticket tracker 状态同步 | Ticket 或 implementation routing 记录 subagent 分工 |
+| 7. 垂直切片与 TDD 实现 | 前端、后端、测试、验证按文件 / 模块拆分；独立 code review | 风险 / 回滚约束裁决、Build Architecture Checklist 违反项处理、可合并结论 | implementation routing、review report、verification 记录写范围和独立审查 |
+| 8. 验证发布与复盘 | fresh verification 执行、release note / retro 草案 | 发布、合并、完成结论和 Git checkpoint 范围 | stage checkpoint 记录验证证据和主控采纳结论 |
+
 ## 21 个门禁 / 职责点映射
 
 | 原职责点 | 归属主阶段 | 产物要求 | 是否必需 |
 |---|---|---|---|
 | 0. 入口分诊 | 1. 入口分诊 | 分诊结论、最小技能集、最近可信阶段 | 必需 |
 | 1. 机会探索 | 2. 机会与 Discovery | 机会输入、MVP 边界、非目标范围 | 新产品 / 新模块必需 |
-| 2. 业务架构 | 3. 业务 / PRD / 功能架构 | 业务架构或 PRD 中等价章节 | 新产品 / 新业务域必需 |
-| 3. 需求澄清 | 3. 业务 / PRD / 功能架构 | `grill-with-docs` 结论或等价澄清记录 | 新功能 / 较大改动必需 |
-| 4. 需求基线 / 功能架构 | 3. 业务 / PRD / 功能架构 | PRD；产品总体设计 / 功能架构资产；功能域、模块边界、低保真原型、验收标准 | 进入 PRD 初稿 / 需求基线流程时必需 |
-| 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计 / 功能架构产出的交互说明、页面清单、状态矩阵 | 有 UI 时必需；缺产品总体设计时阻断 |
+| 2. 业务架构 | 3. 业务 / Spec / 功能架构 | 业务架构或 Spec 中等价章节 | 新产品 / 新业务域必需 |
+| 3. 需求澄清 | 3. 业务 / Spec / 功能架构 | `grill-with-docs` 结论或等价澄清记录 | 新功能 / 较大改动必需 |
+| 4. 需求基线 / 功能架构 | 3. 业务 / Spec / 功能架构 | Spec；产品总体设计 / 功能架构资产；功能域、模块边界、验收标准；有 UI 影响时补低保真页面草图 | 进入 Spec 初稿 / 需求基线流程时必需 |
+| 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 基于 Spec 初稿和产品总体设计 / 功能架构产出的交互说明、页面清单、状态矩阵 | 有 UI 时必需；缺产品总体设计时阻断 |
 | 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论；通过后必须产出 Ant Design v6 高保真 HTML 原型，可由系统 / Agent 自动生成；必须记录 AntD CLI 校验证据；产出后必须获得用户确认 | 有 UI 时必需 |
-| 7. PRD 校准 / 需求冻结 | 4. 产品设计与需求冻结 | 需求冻结记录或校准后的 PRD | 必需；无 UI 可轻量化 |
-| 8. API 影响分析 / 契约草案 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft 或无 API 影响记录；Draft 在 Freeze 前仅可评审；中高风险变更补 OpenSpec-style Spec Delta | 有 API 影响时必需；Spec Delta 条件必需 |
+| 7. Spec 校准 / 需求冻结 | 4. 产品设计与需求冻结 | 需求冻结记录或校准后的 Spec | 必需；无 UI 可轻量化 |
+| 8. API 影响分析 / 契约草案 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft 或无 API 影响记录；Draft 在 Freeze 前仅可评审；修改既有冻结基线的中高风险变更补 Spec Delta | 有 API 影响时必需；Spec Delta 条件必需 |
 | 9. 工程基线 | 5. 系统 / 数据架构与工程契约设计审查 | 工程基线 / YSS DDD Review | 新服务 / 新模块 / 后端结构变化时必需 |
 | 10. 系统总体架构 / 方案设计 | 5. 系统 / 数据架构与工程契约设计审查 | 系统概要设计、ADR 候选 | 服务边界、集成、NFR、运维变化时必需 |
 | 11. 数据架构 / 元模型设计 | 5. 系统 / 数据架构与工程契约设计审查 | 数据架构 | 持久化、元数据、版本、血缘、查询 / 搜索变化时必需 |
 | 12. 设计审查 | 5. 系统 / 数据架构与工程契约设计审查 | Design Review 结论 | 进入 Freeze 前必需 |
-| 13. 契约冻结 | 6. 契约冻结与 Issue formalization | OpenAPI Freeze 记录或无 API 影响记录 | 有 API 影响时必需；无 API 时记录结论 |
-| 14. Issue formalization | 6. 契约冻结与 Issue formalization | 垂直切片 Issue、`to-issues` 输出或等价任务记录，并记录受影响前后端工程存在性判定与脚手架初始化决策 | 正式垂直切片前必需 |
-| 15. 实施计划 | 7. 垂直切片与 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、回滚点，以及缺失前后端工程时的脚手架初始化记录 | 正式开发前必需 |
+| 13. 契约冻结 | 6. 契约冻结与 Ticket 正式化 | OpenAPI Freeze 记录或无 API 影响记录 | 有 API 影响时必需；无 API 时记录结论 |
+| 14. Ticket 正式化 | 6. 契约冻结与 Ticket 正式化 | 垂直切片 Ticket、`to-tickets` 输出或等价任务记录，并记录受影响前后端工程存在性判定、`scaffold_status` 与外部脚手架目标确认 | 正式垂直切片前必需 |
+| 15. 实施计划 | 7. 垂直切片与 TDD 实现 | 垂直切片 Ticket、实施计划、Build Architecture Checklist、回滚点，以及缺失前后端工程时的脚手架初始化记录；涉及 DDL / SQL / 数据库迁移、权限接入或审计日志时记录人工确认结论 | 正式开发前必需 |
 | 16. 开发实现 | 7. 垂直切片与 TDD 实现 | TDD 证据、代码实现、契约对齐、架构约束回勾 | 代码变更时必需 |
 | 17. 独立审查 | 7. 垂直切片与 TDD 实现 | Review Report、`code-review` 结论或 MR / PR 评论；发生 merge / rebase 冲突时补 `resolving-merge-conflicts` 记录 | 合并 / 发布前必需 |
 | 18. 清理简化 | 7. 垂直切片与 TDD 实现 | 清理项记录或 review 建议 | 有复用 / 可读性 / 性能问题时执行 |
@@ -63,7 +77,7 @@ owner: ai
 | 竞品情报简报 | `docs/discovery/reports/<feature>-competitive-intelligence.md` | `competitive-intelligence` 输出格式 |
 | 竞品矩阵 | `docs/discovery/reports/<feature>-competitive-matrix.md` | `docs/discovery/templates/competitive-matrix-template.md` |
 | 技术 / 标准 / API 调研 | `docs/discovery/reports/<feature>-research.md` 或 `docs/research/<feature>.md` | `research` 输出格式 |
-| PRD | `docs/requirements/<feature>-prd.md` | `docs/templates/prd-template.md` |
+| Spec | `docs/requirements/<feature>-spec.md` | `docs/templates/spec-template.md` |
 | 业务架构 | `docs/architecture/<feature>-business-architecture.md` | `docs/architecture/templates/business-architecture-template.md` |
 | 功能架构 | `docs/architecture/<feature>-functional-architecture.md` | `docs/architecture/templates/functional-architecture-template.md` |
 | 产品总体设计 | `docs/design/<feature>-product-overview-design.md` | `docs/design/templates/product-overview-design-template.md` |
@@ -81,42 +95,46 @@ owner: ai
 | 数据架构 | `docs/architecture/<feature>-data-architecture.md` | `docs/architecture/templates/data-architecture-template.md` |
 | 架构 / 设计审查 | `docs/architecture/<feature>-architecture-review.md` | `docs/architecture/templates/architecture-review-checklist.md` |
 | OpenAPI Freeze | `docs/api/<feature>-openapi-freeze.md` | `docs/api/templates/openapi-freeze-record-template.md` |
-| 垂直切片 Issue | GitLab / GitHub Issues 或 `docs/requirements/issues/<feature>-slice.md` | `docs/templates/vertical-slice-issue-template.md` |
-| 实现路由 | `docs/requirements/issues/<feature>-implementation-routing.md` | `docs/templates/implementation-routing-template.md` |
-| 跨阶段 / 跨仓库交接 | Issue / MR / PR 评论或 `docs/implementation/<feature>-handoff.md` | `handoff` 或等价交接记录 |
-| 实现仓库登记 | 实施计划 / Issue / `docs/implementation/<feature>-repo-registry.md` | `docs/templates/implementation-repo-registry-template.md` |
-| 跨仓库切片记录 | 垂直切片 Issue / `docs/implementation/<feature>-cross-repo-slice.md` | `docs/templates/cross-repo-slice-template.md` |
-| Build Architecture Checklist | `docs/implementation/<feature>-build-architecture-checklist.md` 或实施计划 / Issue | `docs/templates/build-architecture-checklist-template.md` |
-| 审查报告 | MR / PR 评论或 `docs/requirements/issues/<feature>-review.md` | `docs/templates/review-report-template.md` |
-| Fresh verification | issue / MR / release note 或 `docs/testing/<feature>-verification.md` | `docs/templates/verification-record-template.md` |
+| 垂直切片 Ticket | GitLab / GitHub Issues、local `tickets.md` 或 `docs/requirements/tickets/<feature>-slice.md` | `docs/templates/vertical-slice-ticket-template.md` |
+| 实现路由 | `docs/requirements/tickets/<feature>-implementation-routing.md` | `docs/templates/implementation-routing-template.md` |
+| 跨阶段 / 跨仓库交接 | Ticket / MR / PR 评论或 `docs/implementation/<feature>-handoff.md` | `handoff` 或等价交接记录 |
+| 实现仓库登记 | 实施计划 / Ticket / `docs/implementation/<feature>-repo-registry.md` | `docs/templates/implementation-repo-registry-template.md` |
+| 跨仓库切片记录 | 垂直切片 Ticket / `docs/implementation/<feature>-cross-repo-slice.md` | `docs/templates/cross-repo-slice-template.md` |
+| Build Architecture Checklist | `docs/implementation/<feature>-build-architecture-checklist.md` 或实施计划 / Ticket | `docs/templates/build-architecture-checklist-template.md` |
+| 审查报告 | MR / PR 评论或 `docs/requirements/tickets/<feature>-review.md` | `docs/templates/review-report-template.md` |
+| Fresh verification | Ticket / MR / release note 或 `docs/testing/<feature>-verification.md` | `docs/templates/verification-record-template.md` |
 | 发布说明 | `docs/releases/<version>-<feature>.md` | `docs/templates/release-note-template.md` |
 | 实施记录 | `docs/implementation/<feature>-rollout.md` | `docs/templates/implementation-plan-template.md` |
 | 用户手册 | `docs/user-guide/<feature>.md` | `docs/user-guide/templates/user-guide-template.md` |
 | 复盘 | `docs/process/sprint-retros/<date>-<topic>.md` | `docs/templates/retro-report-template.md` |
-| 流程 / Skill 修订验证 | `docs/process/<topic>-skill-validation.md` 或 PR / Issue 评论 | `writing-skills` 压力场景与验证记录 |
+| 流程 / Skill 修订验证 | `docs/process/<topic>-skill-validation.md` 或 PR / Ticket 评论 | `writing-skills` 压力场景与验证记录 |
+| Subagent 协同规范 | `docs/process/subagent-collaboration.md` | 直接维护 |
+| Subagent 任务包 | Ticket / 阶段文档或 `docs/requirements/tickets/<feature>-subagent-task-package.md` | `docs/templates/subagent-task-package-template.md` |
+| Subagent 协同验证 | `docs/process/subagent-collaboration-validation.md` | 直接维护 |
 | Harness 工作单元映射 | `docs/process/harness-work-unit-map.md` | 直接维护 |
 | Harness 流程裁剪 | `docs/process/harness-process-tailoring.md` | 直接维护 |
-| 阶段 checkpoint | Issue / MR / PR 评论或阶段文档 | `docs/process/templates/stage-checkpoint-template.md` |
+| 阶段 checkpoint | Ticket / MR / PR 评论或阶段文档 | `docs/process/templates/stage-checkpoint-template.md` |
 
 ## 执行规则
 
 - 每次开始前先判断任务类型和最近可信阶段；不要把小文案、局部样式、单点 Bug 套进完整新功能流程。
-- 判断流程裁剪时先引用 `docs/process/harness-process-tailoring.md`；该指南只能减少不相关产物，不能裁剪关键追踪关系、安全人审或 fresh verification。
-- Discovery 可以通过 `competitive-intelligence` 形成竞品情报、竞品矩阵、机会说明、产品功能指引和下游影响清单，但这些只是 PRD、功能架构、产品设计、API 和架构阶段的输入，不冻结后续设计。
-- 技术事实、框架行为、标准、第三方 API 或协议依据需要可追溯时，使用 `research` 或等价一手资料调研记录；其结论是 PRD、OpenAPI、架构或 ADR 的输入，不替代这些阶段资产。
-- 状态机、复杂业务规则或 UI 方向难以文字定稿时，可用 `prototype` 做一次性验证；必须把结论回填到 PRD、设计、ADR 或 Issue，且不得把 throwaway prototype 当作生产实现或高保真 AntD HTML 原型。
+- 判断流程裁剪时先引用 `docs/process/harness-process-tailoring.md`；该指南只能减少不相关产物，不能裁剪关键追踪关系、人工审查或 fresh verification。
+- 使用 subagent 前必须引用 `docs/process/subagent-collaboration.md` 或等价规则，明确主控 Agent、任务包、写范围、不可委派门禁和汇合方式；阶段 checkpoint 必须记录 subagent 使用、冲突处理和主控采纳结论。
+- Discovery 可以通过 `competitive-intelligence` 形成竞品情报、竞品矩阵、机会说明、产品功能指引和下游影响清单，但这些只是 Spec、功能架构、产品设计、API 和架构阶段的输入，不冻结后续设计。
+- 技术事实、框架行为、标准、第三方 API 或协议依据需要可追溯时，使用 `research` 或等价一手资料调研记录；其结论是 Spec、OpenAPI、架构或 ADR 的输入，不替代这些阶段资产。
+- 状态机、复杂业务规则或 UI 方向难以文字定稿时，可用 `prototype` 做一次性验证；必须把结论回填到 Spec、设计、ADR 或 Ticket，且不得把 throwaway prototype 当作生产实现或高保真 AntD HTML 原型。
 - API 相关阶段必须区分“契约草案 / OpenAPI Draft”和“OpenAPI Freeze”：Draft 仅可用于评审和架构反审，Freeze 前不得作为前后端实现或生成客户端的稳定契约。
-- OpenSpec-style Spec Delta 只用于表达行为差异、验收场景和测试映射；它不替代 PRD、OpenAPI、Design Review 或垂直切片 Issue，也不要求创建额外变更目录。
-- API、权限、状态机、数据模型、跨端、新模块或高风险变更应在 Design Review / OpenAPI Freeze 前补充 Spec Delta；小文案、局部样式、配置微调和低风险 Bug 默认跳过。
-- OpenAPI Freeze 后直接进入 `to-issues` 或等价垂直切片拆分，不再要求额外变更目录或状态文件。
-- 进入实现前，必须先判断当前切片受影响的 frontend / backend 运行时代码工程是否已经存在且可复用；若不存在、不可复用或目录约定缺失，必须先记录原因并路由 `yss-ddd-scaffold-generator` 或 `yss-frontend-scaffold-generator` 初始化，再进入业务实现。
-- 进入垂直切片实现前，必须将系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和安全红线转译成 `Build Architecture Checklist`。
+- Spec Delta 只用于表达相对既有冻结 Spec 基线的行为差异、验收场景和测试映射；它不替代 Spec、OpenAPI、Design Review 或垂直切片 Ticket，也不用于全新产品 / 模块。
+- 既有冻结行为的 API、权限、状态机、数据模型、跨端或其他高风险变更，应在 Design Review / OpenAPI Freeze 前补充 Spec Delta；小文案、局部样式、配置微调、低风险 Bug 和全新基线默认跳过。
+- OpenAPI Freeze 后直接进入 `to-tickets` 或等价垂直切片拆分，不再要求额外变更目录或状态文件。
+- 进入实现前，必须先判断当前切片受影响的 frontend / backend 运行时代码工程是否已经存在且可复用；若不存在、不可复用或目录约定缺失，必须先登记 `scaffold_status=required`，补实现仓库登记或确认外部脚手架目标，再路由 `yss-ddd-scaffold-generator` 或 `yss-frontend-scaffold-generator` 初始化后进入业务实现。
+- 进入垂直切片实现前，必须将系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和风险 / 回滚约束转译成 `Build Architecture Checklist`。
 - 跨线程、跨仓库、上下文过长或原型结论回流时，必须留下 `handoff` 或等价交接记录，至少包含来源资产、当前阶段、未决问题、验证命令和下一步责任人。
 - 每个垂直切片完成时必须回勾 `Build Architecture Checklist`，用 `implemented`、`seam-deferred`、`drift`、`violation` 或 `not-applicable` 标记状态，并提供证据或补齐落点。`drift` 触发 Architecture Re-check；`violation` 阻断继续 build。
-- Repository / Gateway / 持久化、权限 / 授权、审计、SQL / DDL / 迁移、文件上传下载、版本快照 / 元数据 / 血缘 / 查询索引、部署 / 回滚 / 运维约束，必须在 checklist 中逐项绑定切片和人审要求。
-- 每个主阶段结束都要做 issue tracker 同步：按用户明确选择或当前仓库主远端路由到 GitLab / GitHub，更新对应 PRD、垂直切片 Issue、里程碑或评论，记录阶段状态、完成范围、验证证据、阻塞项、下一步和安全人审点。
-- 每个主阶段结束都要做 Git checkpoint 判断：列出变更产物、Issue 同步状态、排除无关脏文件，并说明提交 / 推送 / 暂缓原因。
-- 触碰安全红线时，模板中必须标记 `TODO-HUMAN-REVIEW`，Agent 只能生成草案。
+- Repository / Gateway / 持久化、权限 / 授权、审计、SQL / DDL / 迁移、文件上传下载、版本快照 / 元数据 / 血缘 / 查询索引、部署 / 回滚 / 运维约束，必须在 checklist 中逐项绑定切片和人工确认要求。
+- 每个主阶段结束都要做 Ticket tracker 同步：按用户明确选择或当前仓库主远端路由到 GitLab / GitHub，更新对应 Spec、垂直切片 Ticket、里程碑或评论，记录阶段状态、完成范围、验证证据、阻塞项、下一步和人工审查点。
+- 每个主阶段结束都要做 Git checkpoint 判断：列出变更产物、Ticket 同步状态、排除无关脏文件，并说明提交 / 推送 / 暂缓原因。
+- 存在需要人工确认的风险时，模板中必须记录范围、责任人和结论或待补齐事项。
 - 任何“完成 / 可合并 / 可发布”结论必须有 fresh verification 证据。
 - 发生 merge / rebase 冲突时，必须按 `resolving-merge-conflicts` 或等价流程记录双方意图、取舍和重新验证结果。
 - 修改 AGENTS、流程模板或技能说明时，必须按 `writing-skills` 思路补充压力场景或验证说明，避免流程规则只停留在不可执行文字。

package/template/docs/process/product-prototype-workflow.md

@@ -1,27 +1,27 @@
 # 产品原型工作流
 
-本文定义 YSS Harness 中有 UI 功能的最小产品原型链路。目标是用 `grill-with-docs` 问清需求，用 `product-design:index` 统一原型产出入口，用 `antd` CLI 固化 Ant Design v6 事实校验，并由 YSS 生命周期负责评审、用户确认和 PRD / OpenAPI 回填。
+本文定义 YSS Harness 中有 UI 功能的最小产品原型链路。目标是用 `grill-with-docs` 问清需求，用 `product-design:index` 统一原型产出入口，用 `antd` CLI 固化 Ant Design v6 事实校验，并由 YSS 生命周期负责评审、用户确认和 Spec / OpenAPI 回填。
 
 ## 适用范围
 
 - 新产品、新模块或较大 UI 功能。
 - 影响主流程、权限状态、异常状态、页面导航或 OpenAPI 反推清单的 UI 变更。
-- 已进入 PRD 初稿 / 需求基线流程，且存在用户界面的功能。
+- 已进入 Spec 初稿 / 需求基线流程，且存在用户界面的功能。
 
-小文案、局部样式、配置微调或不进入 PRD 生命周期的低风险变更，可在影响面评估中说明不适用。
+小文案、局部样式、配置微调或不进入 Spec 生命周期的低风险变更，可在影响面评估中说明不适用。
 
 ## 标准链路
 
 ```text
 grill-with-docs
--> PRD / 产品总体设计
+-> Spec / 产品总体设计
 -> yss-design-system
 -> product-design:index
 -> Product Design focused skills
 -> antd CLI 校验
 -> prototype-review
 -> 用户确认
--> PRD 校准 / OpenAPI Draft
+-> Spec 校准 / OpenAPI Draft
 ```
 
 ## 职责边界
@@ -34,13 +34,13 @@ grill-with-docs
 | 原型产出 | `$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code` | 产出低保真 / 高保真页面、交互说明、可演示原型和可分享资产 |
 | AntD 事实校验 | `antd` CLI | 查询 Ant Design v6 设计语言、组件 API、demo、token 和 semantic 信息 |
 | 阶段评审 | `prototype-review` | Fail-closed 评审页面流、状态矩阵、权限、异常、OpenAPI 反推和验收标准 |
-| 用户确认 | `docs/design/templates/prototype-confirmation-template.md` | 记录高保真 HTML 原型是否被用户确认，并决定能否进入 PRD 校准 / OpenAPI Draft |
+| 用户确认 | `docs/design/templates/prototype-confirmation-template.md` | 记录高保真 HTML 原型是否被用户确认，并决定能否进入 Spec 校准 / OpenAPI Draft |
 
 ## 产物要求
 
 有 UI 的功能至少沉淀：
 
-- PRD 初稿：`docs/requirements/<feature>-prd.md`
+- Spec 初稿：`docs/requirements/<feature>-spec.md`
 - 产品总体设计 / 功能架构：`docs/design/<feature>-product-overview-design.md`
 - 交互说明：`docs/design/<feature>-interaction-spec.md`
 - 状态矩阵：`docs/design/<feature>-state-matrix.md`
@@ -48,7 +48,7 @@ grill-with-docs
 - 高保真 HTML 原型：`docs/design/prototypes/<feature>/index.html`
 - 用户确认记录：`docs/design/<feature>-prototype-confirmation.md`
 
-高保真 HTML 原型必须使用 Ant Design v6。系统 / Agent 可以自动产出，但产出后必须获得用户确认并记录确认结果；未确认前不得进入 PRD 校准、需求冻结或 UI 驱动 OpenAPI Draft。
+高保真 HTML 原型必须使用 Ant Design v6。系统 / Agent 可以自动产出，但产出后必须获得用户确认并记录确认结果；未确认前不得进入 Spec 校准、需求冻结或 UI 驱动 OpenAPI Draft。
 
 ## AntD CLI 门禁
 
@@ -74,8 +74,8 @@ antd semantic <Component> --version 6.0.0 --format json
 - 缺产品总体设计 / 功能架构：回到 `docs/design/<feature>-product-overview-design.md`。
 - 没有视觉目标且需要新 UI：按 Product Design 规则先走 `$get-context`，再走 `$ideate`，展示 3 个视觉方向并等待用户选择。
 - 原型评审阻断：回到 Product Design focused skill 补齐页面流、状态矩阵、权限或异常路径。
-- 用户未确认：不得进入 PRD 校准 / OpenAPI Draft。
-- 触碰安全红线：标记 `TODO-HUMAN-REVIEW`，不得直接交付生产实现。
+- 用户未确认：不得进入 Spec 校准 / OpenAPI Draft。
+- 存在高风险变更：记录人工确认项，不得省略验证证据。
 
 ## 兼容策略
 

package/template/docs/process/skill-governance.md

@@ -16,7 +16,7 @@
 | 需要稳定检查但不需要生成大量内容 | checklist | 人仍然负责放行判断 |
 | 规则明确、可机器判断 | 脚本 | 有确定输入、输出和失败条件 |
 | 需要一组可复用步骤、上下文规则和产物规范 | Skill | 多次复用，且普通模板无法约束执行质量 |
-| 属于需求澄清、PRD、Issue、TDD、诊断、审查或架构治理 | 优先复用 Matt skill | 与 `grill-with-docs`、`to-prd`、`to-issues`、`implement`、`tdd`、`diagnosing-bugs`、`code-review`、`codebase-design` 等职责重合 |
+| 属于需求澄清、Spec、Ticket、TDD、诊断、审查或架构治理 | 优先复用 Matt skill | 与 `grill-with-docs`、`to-spec`、`to-tickets`、`wayfinder`、`implement`、`tdd`、`diagnosing-bugs`、`code-review`、`codebase-design` 等职责重合 |
 | 属于 YSS DDD、UI、OpenAPI、Repository、Controller、DTO 或组件规范 | 优先复用 YSS skill | 与现有 YSS 专项规范强相关 |
 | 低频、一次性或高度依赖人工判断 | 不沉淀为 Skill | 记录在复盘或 checklist 即可 |
 
@@ -26,9 +26,10 @@
 |---|---|
 | 候选名称 | 使用动词或明确能力名 |
 | 触发场景 | 什么时候必须使用 |
-| 输入 | 需要哪些文档、代码、Issue 或上下文 |
+| 输入 | 需要哪些文档、代码、Ticket 或上下文 |
 | 输出 | 生成什么产物或判断 |
 | 质量门禁 | 如何判断执行合格 |
+| 文档语言 | 持久化产物正文和章节标题是否默认中文；英文专有名词、命令、metadata 是否按需保留 |
 | 是否已有模板 / 脚本 | 避免重复建设 |
 | 是否已有 Matt / YSS skill | 避免重复建设 |
 | 不适用场景 | 明确不要使用的情况 |
@@ -39,12 +40,19 @@
 - 动作结果高度依赖个人经验或业务拍板。
 - 只需要复制一个模板即可完成。
 - 已经有现成 Skill、脚本或生命周期门禁覆盖。
-- 会绕过安全红线、人审或 fresh verification。
+- 会绕过风险 / 回滚约束、人审或 fresh verification。
 
 ## 治理回流
 
 - 试点复盘时记录新增、修改、合并或废弃 Skill 的候选。
 - 只有稳定语言写入 `CONTEXT.md`。
 - 只有难回滚、非显而易见且有真实取舍的治理决策写入 ADR。
-- Skill 更新后必须同步相关模板、触发规则和用户指南。
+- Skill 更新后必须同步相关模板、触发规则和用户指南；若 Skill 或模板来自英文上游，必须说明落地文档如何转换为中文正文和中文章节标题。
 - Matt skills 升级必须记录来源提交、变更摘要和验证结果。
+
+## 压力场景
+
+| 场景 | 期望处理 |
+|---|---|
+| 新增或升级 Skill 后，Agent 把英文模板标题、checklist 或审查说明原样输出到项目持久化文档 | 标记为规范偏离；回到模板 / Skill 更新，补充中文正文、中文章节标题和保留英文技术标识的规则 |
+| 后端脚手架或验证模板中出现裸 `mvn ...` 命令 | 标记为规范偏离；改为项目根目录 `./mvnw ...`，或记录既有仓库无法使用 Maven Wrapper 的受控例外 |

package/template/docs/process/subagent-collaboration-validation.md

@@ -0,0 +1,53 @@
+---
+status: active
+owner: ai
+---
+
+# Subagent 协同压力场景验证
+
+本文按 `writing-skills` 思路记录流程规则的压力场景，用于验证 `docs/process/subagent-collaboration.md` 不是不可执行的文字规则。
+
+## 场景 1：新模块 Discovery 并行调研
+
+- 输入：用户提出一个新业务模块，只有模糊想法。
+- 风险：主控 Agent 直接派多个 subagent 写 Spec、OpenAPI 和实现计划，跳过 Discovery 和范围收敛。
+- 期望行为：主控 Agent 先判定阶段为“机会与 Discovery”，只派 Explorer 做竞品、技术事实和用户流程调研；Spec 和功能架构只能在 Discovery 收敛后进入。
+- 验证点：checkpoint 中出现 subagent task package，且没有 OpenAPI Freeze 或实现结论。
+
+## 场景 2：API Draft 与数据架构并行
+
+- 输入：已有 Spec 和产品设计，变更影响 API schema、分页和持久化。
+- 风险：API 子代理直接把 Draft 当稳定契约交给实现 Worker。
+- 期望行为：API、数据架构、系统架构可以并行起草；OpenAPI Draft Review 和 Design Review findings 汇总后，由主控 Agent 决定是否进入 Freeze。
+- 验证点：任务包禁止事项包含“不得执行 OpenAPI Freeze”，阶段记录区分 Draft 和 Freeze。
+
+## 场景 3：实现阶段多 Worker 并行
+
+- 输入：已有冻结契约和垂直切片 Ticket，前端和后端都要改。
+- 风险：两个 Worker 同时修改同一 API 客户端或同一 DTO，导致冲突；实现者自审。
+- 期望行为：主控 Agent 按文件 / 模块拆分写范围；Reviewer subagent 独立于 Worker；Verifier 执行 fresh verification。
+- 验证点：任务包写范围不重叠，checkpoint 记录 Reviewer 和 Verifier 证据。
+
+## 场景 4：风险 / 回滚约束被子代理触碰
+
+- 输入：切片涉及权限接入、SQL 或数据库迁移。
+- 风险：Worker 直接生成生产实现并宣称可合并。
+- 期望行为：subagent 必须记录验证证据和责任人，记录人工确认项；主控 Agent 在实现路由和 checkpoint 中记录人工确认结论。
+- 验证点：没有人工确认结论时，阶段状态不得进入“可发布 / 可合并”。
+
+## 场景 5：子代理结论冲突
+
+- 输入：API Reviewer 认为字段必需，Frontend Worker 认为字段可选。
+- 风险：主控 Agent 随意采纳其中一个结论，未回到源资产。
+- 期望行为：主控 Agent 按 Spec、OpenAPI Freeze、ADR、测试证据、CONTEXT 和风险 / 回滚约束优先级裁决；如影响契约，回到 OpenAPI Draft Review / Freeze。
+- 验证点：checkpoint 记录冲突、裁决依据和回填资产。
+
+## 验收结论
+
+本轮流程增强的最小验收标准：
+
+- `AGENTS.md` 明确 subagent 可委派和不可委派边界。
+- `docs/process/lifecycle-artifact-map.md` 引用 subagent 协同规范和任务包模板。
+- `docs/process/templates/stage-checkpoint-template.md` 可记录 subagent 使用情况。
+- `docs/templates/implementation-routing-template.md` 可记录实现阶段 subagent 拆分和写范围。
+- 压力场景覆盖 Discovery、OpenAPI、实现、风险 / 回滚约束和冲突合并。