create-yss-spec 3.4.10 → 3.5.2

package/template/docs/templates/implementation-routing-template.md

@@ -1,350 +0,0 @@
----
-pipeline: <feature-id>
-stage: implementation-routing
-status: draft
-owner: ai
----
-
-# <功能名称>实现路由记录
-
-> 适用场景：Spec、OpenAPI Freeze / 无 API 影响记录、Design Review 和垂直切片 Ticket 已就绪后，进入实现前。
-> 本文记录契约状态、Ticket 状态、YSS skill 最小集合、测试策略和回滚点，不替代垂直切片 Ticket 或实施计划。
-> 实现合同编译器 只能生成 `draft`、`blocked` 或 `ready-for-lifecycle-review`；不得自行写入 `approved`、`ready-for-agent` 或 `completed`。合同批准、持久化和 Ticket 状态推进由生命周期编排器负责。
-
-## 1. 输入材料
-
-| 资产 | 路径 / 链接 | 状态 | 备注 |
-|------|-------------|------|------|
-| 垂直切片 Ticket |  |  |  |
-| OpenAPI Freeze / 无 API 影响记录 |  |  |  |
-| OpenSpec-style Spec Delta（条件必需） |  |  | 仅 API、状态机、数据模型、跨端、新模块或高风险变更需要 |
-| Design Review |  |  |  |
-| 实现仓库 / 实现位置 |  |  |  |
-| 前后端工程存在性判定 |  |  | 记录 frontend / backend 是否已存在且可复用 |
-| 工程路径策略 |  |  | Harness 内使用 `apps/backend/<project>/` / `apps/frontend/<project>/`；外部仓库记录真实项目根 |
-| `垂直切片 Ticket 状态` |  |  | ready / blocked / in-progress |
-
-## 2. 实现前门禁
-
-| 检查项 | 结果 | 备注 |
-|--------|------|------|
-| Spec 验收标准已可追溯 | 是 / 否 |  |
-| OpenAPI Freeze 或无 API 影响记录已完成 | 是 / 否 |  |
-| Spec Delta 已补齐或明确不需要 | 是 / 否 / 不适用 |  |
-| Design Review 阻断项已关闭 | 是 / 否 / 不适用 |  |
-| 垂直切片 Ticket 已拆到端到端可验收 | 是 / 否 |  |
-| 实现仓库 / 实现位置已登记 | 是 / 否 |  |
-| 受影响 frontend 工程已存在可复用，或已登记 `scaffold_status=required` 并确认外部脚手架目标 | 是 / 否 / 不适用 |  |
-| 受影响 backend 工程已存在可复用，或已登记 `scaffold_status=required` 并确认外部脚手架目标 | 是 / 否 / 不适用 |  |
-| 缺失工程时已路由到对应脚手架 skill | 是 / 否 / 不适用 | `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator` |
-| Harness 内项目根路径符合 `apps/<backend|frontend>/<project>/` | 是 / 否 / 不适用 | `apps/backend/`、`apps/frontend/` 仅为容器 |
-| 未使用 `app/backend/`、`app/frontend/` 及其子路径 | 是 / 否 / 不适用 | 命中即阻断生成和实现 |
-| 原型确认后先完成后端脚手架，再进入业务代码路由 | 是 / 否 / 不适用 | `backend_scaffold_policy_satisfied` |
-| 后端脚手架合同字段完整且版本当前 | 是 / 否 / 不适用 | schema v2：`scaffold_request_id`、项目/输出目录、实现合同编译器 draft、生命周期批准、base package、Maven 坐标、target DDD/Profile、initialize-only、允许写路径、预期证据、验证命令 |
-| 后端构建 / 测试 / OpenAPI / CI 命令均使用项目根目录 `./mvnw ...`，或已记录受控例外 | 是 / 否 / 不适用 | 裸 `mvn ...` 默认为规范偏离 |
-| 持久化文档正文和章节标题已转换为中文，仅保留必要英文技术标识 / metadata | 是 / 否 | 英文 skill / 模板不得原样落地为交付文档 |
-| YSS skill 路由已完成 | 是 / 否 |  |
-| fresh verification 方式已明确 | 是 / 否 |  |
-
-## 2.1 Slice Implementation Contract 身份与状态
-
-| 字段 | 内容 |
-|---|---|
-| schema_version | `1` |
-| contract_id |  |
-| contract_version |  |
-| slice_id |  |
-| status | `draft` / `blocked` / `ready-for-lifecycle-review` |
-| compiled_by | `yss-implementation-contract-compiler` |
-| 生命周期批准状态 | pending / approved / rejected；由生命周期编排器填写 |
-| 合同持久化路径 |  |
-
-### 生命周期引用与就绪性
-
-| lifecycle_ref | 路径 / 链接 | 状态 | 阻塞或过期说明 |
-|---|---|---|---|
-| Spec |  |  |  |
-| 垂直切片 Ticket |  |  |  |
-| 需求冻结 |  |  |  |
-| 原型确认 / 状态矩阵 |  |  | 无 UI 影响时记录 `not-applicable` 及原因 |
-| OpenAPI Freeze / 无 API 影响记录 |  |  |  |
-| 系统 / 数据架构审查 |  |  |  |
-| Build Architecture Checklist |  |  |  |
-
-| readiness | 内容 |
-|---|---|
-| blockers |  |
-| stale_inputs |  |
-| not_applicable |  |
-
-任一适用输入为 `missing`、`stale` 或未批准时，合同状态必须为 `blocked`，并写明回退阶段。
-
-## 2.2 Common 子合同
-
-| 字段 | 内容 |
-|---|---|
-| impacted_areas |  |
-| implementation_path_policy | `harness-apps-multi-project` / `external-repository-native` / `git-submodule-harness-apps` |
-| project_roots | Harness 内与 `git-submodule` 填写 `apps/backend/<project>/` / `apps/frontend/<project>/`；外部仓库填写真实项目根 |
-| required_skills |  |
-| optional_skills |  |
-| unavailable_skills | 写明 provider、fallback 和阻断结论；不得静默跳过 |
-| allowed_write_paths |  |
-| forbidden_patterns |  |
-| expected_evidence_files |  |
-| verification_commands |  |
-| human_review_points |  |
-| full_reroute_triggers | 新 API/schema、状态机、数据模型、写目录、仓库、skill、风险、seam、交付顺序或其他未冻结行为等变化 |
-| quality_baseline_ref | 工程基线的 `baseline_id` / `baseline_version`；切片不得重新定义质量标准 |
-| context_plan | 必需上下文、按需上下文、停止规则和缺失动作 |
-| doubt_driven_review | 高风险影响的主张、反证、证据、残余风险和审查引用；未命中时 `not-applicable` |
-
-| 不适用 skill | 原因 |
-|---|---|
-|  |  |
-
-### Context Plan（上下文工程）
-
-| 字段 | 内容 |
-|---|---|
-| required_context_refs | `CONTEXT.md`、已批准 Spec、当前 Slice Contract、适用 ADR / 工程基线 |
-| on_demand_context_refs | 命中影响面后再加载的专项 references、实现仓库文件和历史证据 |
-| context_stop_rule | `minimal-sufficient-evidence` |
-| missing_context_action | `blocked` / `reroute`；不得猜测补齐 |
-
-### Doubt-Driven 高风险反证
-
-| 字段 | 内容 |
-|---|---|
-| status | `not-applicable` / `required` / `completed` / `blocked` |
-| trigger_impacts | API、数据迁移、跨仓契约、发布回滚、实际安全行为、生命周期 / 生成语义 |
-| claim / counterclaim |  |  |
-| evidence_refs |  |
-| residual_risks |  |
-| reviewer_ref |  |
-
-## 3. YSS skill 最小集合
-
-| 领域 | skill | 使用原因 | 是否必需 |
-|------|-------|----------|----------|
-| 前端 |  |  | 是 / 否 |
-| 后端 |  |  | 是 / 否 |
-| API / 契约 |  |  | 是 / 否 |
-| 测试 / 验证 |  |  | 是 / 否 |
-
-### 3.1 Frontend 子合同
-
-> 有 UI 影响时，批准后的产品设计、正式原型和状态矩阵是必填输入；缺失时合同必须为 `blocked`。无 UI 影响时填写 `not-applicable` 及原因。
-
-| 字段 | 内容 |
-|---|---|
-| status | required / not-applicable |
-| required_skills |  |
-| approved_prototype_ref |  |
-| state_matrix_ref |  |
-| visual_baseline_ref | `visual-baseline.yaml` 路径、版本与 digest |
-| visual_baseline_case_ids | 当前切片实际消费的 case_id；禁止目录 glob |
-| generated_api_client_ref |  |
-| allowed_write_paths |  |
-| component_test_seams | loading / empty / error / permission / 其他公开 seam |
-| e2e_paths |  |
-
-### 3.2 Backend Slice Implementation Contract
-
-> 任一后端切片写业务代码前必须填写本合同；没有后端影响时标记 `not-applicable` 并说明原因。合同缺少必填项时，结论必须为 `Blocked`，不得进入实现。
-
-| 项 | 内容 |
-|---|---|
-| slice_id |  |
-| status | required / not-applicable |
-| affected_layers | Adapter / Application / Domain / Infrastructure / Bootstrap / not-applicable |
-| required_skills | `yss-domain` / `yss-application` / `yss-repository` / `yss-mybatis` / `yss-web-controller` / `yss-dto` / `mapstruct` / `lombok` / `alibaba-java-code-style` / other |
-| application_boundary |  |
-| transaction_boundary |  |
-| persistence_strategy |  |
-| allowed_write_paths |  |
-| forbidden_patterns | 私自新建 / 混用 Result 包装；Controller 内部类或非约定包临时定义主要 DTO / VO；DTO 未按 `yss-dto` 继承 `CommandDTO` / `QueryDTO` / `PageQuery`；Controller 手工分页；Controller 穿透 Repository；InMemory Gateway 作为正式持久化；`BeanUtils.copyProperties` / 反射拷贝 / 重复手写 mapping；成片手写 POJO getter/setter/constructor/builder/logger；其他： |
-| expected_evidence_files |  |
-| seam_deferred |  |
-| 人工确认项 |  |
-| verification_commands | 后端命令必须使用 `./mvnw ...`；如使用裸 `mvn ...`，必须在备注中记录受控例外原因 |
-
-| 层级 | 必需 skill | 预期文件 / 证据 | 状态 |
-|---|---|---|---|
-| Adapter / Web | `yss-web-controller`、`yss-dto`、`mapstruct`、`lombok` | Controller、CMD / Query / VO、WebConvertor、统一响应包装、Lombok 注解和 MapStruct 转换证据 | pending / implemented / seam-deferred / violation / not-applicable |
-| Application | `yss-application` | AppService / UseCase、事务边界、跨聚合协调、异常处理 | pending / implemented / seam-deferred / violation / not-applicable |
-| Domain | `yss-domain`；术语 / 边界 / ADR 变化时增加 `domain-modeling` | Entity / ValueObject / DomainService / Gateway interface / 状态方法；命中通用建模时补 CONTEXT / ADR 证据 | pending / implemented / seam-deferred / violation / not-applicable |
-| Infrastructure | `yss-repository`、`yss-mybatis`、`mapstruct`、`lombok` | PO、Repository、Convertor、GatewayImpl、Mapper / XML / 查询策略、Lombok 注解和 MapStruct 转换证据 | pending / implemented / seam-deferred / violation / not-applicable |
-| Java 规范 | `alibaba-java-code-style` | 命名、异常、日志、ORM、Maven、单测和安全项审查记录 | pending / implemented / seam-deferred / violation / not-applicable |
-
-### 3.3 Contract 子合同
-
-| 字段 | 内容 |
-|---|---|
-| api_impact | true / false |
-| freeze_ref | API 有影响时的 OpenAPI Freeze |
-| no_api_impact_ref | API 无影响时的正式记录 |
-| generated_clients |  |
-| contract_tests |  |
-| regeneration_commands |  |
-
-### 3.4 Cross-repo 子合同
-
-| 字段 | 内容 |
-|---|---|
-| repositories |  |
-| delivery_order |  |
-| integration_verification |  |
-| rollback_order |  |
-
-### 3.5 后端门禁压力场景
-
-| 场景 | 期望处理 |
-|---|---|
-| Agent 试图在 Controller 中新增内部 `CreateXCommand`、`XVO` 或私自新建 `PageResult` | 标记 `violation`；回到 `yss-web-controller` / `yss-dto` 补独立 DTO / VO / WebConvertor、复用既有响应包装或记录受控例外 |
-| Agent 试图用 `InMemory*Gateway` 完成需要持久化的切片 | 仅允许 `seam-deferred`；必须写补齐切片、风险、人工确认项，不得作为正式持久化实现 |
-| Agent 试图跳过 Repository / PO / Convertor，直接在 Application 中过滤集合 | 若切片需要持久化或查询策略，标记 `violation`；回到 `yss-repository` / `yss-mybatis` |
-| Agent 试图用 `BeanUtils.copyProperties`、反射拷贝或大段手写字段赋值完成对象转换 | 标记 `violation`；回到 `mapstruct` / `yss-repository` / `yss-web-controller` 补 MapStruct Convertor，或记录受控例外、测试和 review 证据 |
-| Agent 试图成片手写 POJO getter/setter、constructor、builder 或 logger | 标记 `violation`；回到 `lombok` 补注解，或记录受控例外、测试和 review 证据 |
-| Agent 只写“符合 YSS”但没有列出 skill 证据和文件证据 | 标记 `violation`；不得进入 code review / 完成结论 |
-| Agent 在后端 README、CI、Ticket、Review 或验证记录中使用 `mvn clean test` 等裸 Maven 命令 | 标记规范偏离；改为项目根目录 `./mvnw ...`，或记录既有仓库无法使用 wrapper 的受控例外 |
-| Agent 将英文 skill 模板标题 / checklist 原样复制为持久化交付文档 | 标记规范偏离；正文、标题、审查结论、实施说明和 checkpoint 说明必须改为中文 |
-
-## 4. 外部实现仓库
-
-> 当前仓库默认不承载运行时代码。若用户明确选择 Harness 内实现，同源代码用 `harness-apps`；独立仓挂载用 `git-submodule`。两种项目根都必须是 `apps/backend/<project>/` 或 `apps/frontend/<project>/`；`apps/backend/`、`apps/frontend/` 不能作为项目根，`app/backend/`、`app/frontend/` 及其子路径禁止使用。
-
-| repo_role | project_root | git_url | default_branch | working_branch | MR / PR | CI | test_command | build_command | 状态 |
-|---|---|---|---|---|---|---|---|---|---|
-| backend | `apps/backend/<project>/` 或外部真实路径 |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
-| frontend | `apps/frontend/<project>/` 或外部真实路径 |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
-| other | 真实路径 |  |  |  |  |  |  |  | pending / ready / blocked / not-applicable |
-
-说明：当前仓库默认作为 Harness / 研发管理仓库；前后端实现默认位于外部实现仓库。缺少实现仓库登记时，先使用 `implementation-repo-onboarding`，并按 `docs/templates/implementation-repo-registry-template.md` 补齐登记。
-
-## 4.1 脚手架初始化判定
-
-| 受影响端 | 是否已有可用工程 | scaffold_status | 目标是否确认 | 处理结论 | 使用 skill | 输出位置 / 仓库 | 备注 |
-|---|---|---|---|---|---|---|---|
-| backend | 是 / 否 / 不适用 | existing / required / initialized / not-applicable | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-ddd-scaffold-generator` / `yss-layered-mvc-scaffold-generator` / none |  | 新建填写 gate、architecture_family、精确 Spring Boot 版本、decision_id 与 digest；既有工程填写登记值复用证据 |
-| frontend | 是 / 否 / 不适用 | existing / required / initialized / not-applicable | 是 / 否 / 不适用 | 复用现有 / 初始化 / 阻塞 | `yss-frontend-scaffold-generator` / none |  |  |
-
-脚手架输出位置必须回指具体项目根：后端为 `apps/backend/<project>/`，前端为 `apps/frontend/<project>/`；不得把 `apps/backend/`、`apps/frontend/` 容器根或任何 `app/backend/`、`app/frontend/` 路径作为生成目标。
-
-## 4.2 人工确认结论
-
-| 人工确认项 | 是否涉及 | 结论 | 证据 / 链接 | 补齐落点 |
-|---|---|---|---|---|
-| DDL / SQL / 数据库迁移 | 是 / 否 | 通过 / 草案 / 阻断 / 不适用 |  |  |
-| 其他已明确的风险 / 人工确认 | 是 / 否 | 通过 / 草案 / 阻断 / 不适用 | 仅登记上游已经明确的事项 |  |
-
-### 4.3 后端脚手架工作单元
-
-当 backend `scaffold_status=required` 时，生命周期先按领域复杂度推荐 DDD/MVC，并展示平台清单中的精确 Spring Boot / Java 版本，以批量决策表取得同一次用户确认并通过 `gate.backend-architecture-platform-approved`。选择写入 `scaffold-architecture-decisions.yaml`；缺失、未确认或 stale 时阻断。门禁通过后才进入对应的 DDD 战术设计或 MVC 技术设计，再登记 `controlled-generation` 工作单元。`domain-driven` 使用 `primary_skill=yss-ddd-scaffold-generator`，`layered-mvc` 使用 `primary_skill=yss-layered-mvc-scaffold-generator`。生成后执行对应基线校验和 `yss-implementation-contract-compiler` 合同重编译。`existing` / `initialized` 核验并复用当前登记架构与平台，不重复询问或生成；架构转换、平台升级另立迁移工作单元。
-
-| 项 | 内容 |
-|---|---|
-| 前置 | `prototype_confirmation`、工程基线、实现仓库和脚手架目标已确认；`gate.backend-architecture-platform-approved` 已同时确认 DDD / MVC 与精确 Spring Boot 版本，`scaffold-architecture-decisions.yaml` digest 当前；实现合同编译器 schema v4 脚手架合同 draft 已经生命周期批准并持久化为结构化 JSON，生成器通过 `--contract-file` 消费 |
-| 生成器 | `domain-driven` → `yss-ddd-scaffold-generator`；`layered-mvc` → `yss-layered-mvc-scaffold-generator` |
-| 模式 | `controlled-generation` |
-| Java / Maven 身份 | `base_package` 与 Maven `group_id` 分开登记；项目版本、父 POM GAV、`yss-components.version` 进入批准合同并原样传给 CLI |
-| 允许生成 | DDD 的 Domain / Application / Infrastructure / Adapter / Bootstrap，或 MVC 的 server / service / repository 与能力解析出的 adapter / client / feign-client；以及 POM、配置、Wrapper 和非业务机械模板 |
-| 禁止生成 | 业务规则、状态机、权限、事务、复杂查询、错误映射、业务字段和用户可见行为 |
-| 生成选项 | 关闭 `--with-example`；生成器严格 initialize-only，非空目录、`--force`、旧项目迁移和当前模板升级均为 `unsupported` |
-| Profile | DDD：`target-domain-model`；MVC：`layered-mvc-service`；Spring Boot / Java 使用用户确认且兼容清单验证通过的精确组合，不使用版本范围或 `latest` |
-| 验证 | 使用一键生成验证入口，实际执行项目根目录 `./mvnw validate`、`./mvnw test`、`./mvnw package`；通过后仅为 `empty-scaffold-verified`，golden first slice 通过后才是 `first-slice-verified` |
-| 后置 | 生成器内部工程基线校验、`yss-implementation-contract-compiler` 业务合同重编译、YSS Skill Execution Result |
-
-所有后续生成代码必须绑定当前批准且版本一致的 Slice Implementation Contract、主 YSS skill、依赖闭包、允许写路径、预期证据和 Execution Result。业务行为必须使用 `behavior-tdd`；缺任一条件即阻断，不得以脚手架成功或时间压力豁免。
-
-## 5. TDD 与验证策略
-
-> 每个工作单元必须且只能选择 `behavior-tdd` 或 `controlled-generation`。领域规则、状态机、事务、复杂查询、权限 / 错误映射、页面交互和用户可见状态必须使用 `behavior-tdd`；`controlled-generation` 只用于机械脚手架、样板、冻结客户端和配置。
-
-| work_unit_id | 验收行为 / 生成目标 | primary_skill | supporting_skills | tdd_mode | allowed_write_paths | expected_evidence | verification_commands | 状态 |
-|---|---|---|---|---|---|---|---|---|
-|  |  |  |  | behavior-tdd / controlled-generation |  |  |  | pending / running / blocked / completed / stale |
-
-### 5.1 `behavior-tdd` 工作单元
-
-| work_unit_id | 已确认公开 seam | RED 证据 | GREEN 证据 | 合同回勾 |
-|---|---|---|---|---|
-|  |  |  |  |  |
-
-### 5.2 `controlled-generation` 工作单元
-
-| work_unit_id | exception_reason | generator | generator_inputs | expected_files | verification_commands | behavior_tests_after_generation |
-|---|---|---|---|---|---|---|
-|  | mechanical-scaffold / frozen-client / configuration / other |  |  |  |  |  |
-
-若生成内容包含状态变化、权限、业务过滤、事务或错误映射，必须拆分对应工作单元并改为 `behavior-tdd`。
-
-| 层级 | 先失败测试 / 验证命令 | 通过标准 |
-|------|------------------------|----------|
-| Domain / Application |  |  |
-| API / 契约 |  |  |
-| 前端组件 |  |  |
-| E2E / 关键路径 |  |  |
-
-## 5.3 YSS Skill Execution Result 回填
-
-> 每个结果必须引用当前 `contract_id` / `contract_version` 和 `work_unit_id`。只列计划命令、缺实际结果、`duration_ms` 或时间戳，不构成 fresh verification。
-
-| schema_version | skill | slice_id | work_unit_id | status | consumed contract ref / version | changed_files | evidence_files | verification result / executed_at | constraint_results | seam_deferred | deviations | new_impacts | 结果文件引用 |
-|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
-| `1` |  |  |  | implemented / seam-deferred / drift / violation / not-applicable |  |  |  |  |  |  |  |  |  |
-
-汇总规则：
-
-- `changed_files` 超出 `allowed_write_paths`，或 `expected_evidence_files` 缺失：标记 `violation`，阻断 build。
-- `drift`：触发 Architecture Re-check；不得汇总为完成。
-- `new_impacts` 非空、原 `not-applicable` 被推翻或合同关键输入变化：将合同及相关工作单元标记 `stale`，暂停实现并进入完整重路由或生命周期回退。
-
-## 6. Subagent 执行计划
-
-| task_id | 数字人角色 | runtime_id | core_skills（从角色表复制） | subagent 角色 | 责任范围 | 允许修改文件 / 模块 | 禁止事项 | 输出回填位置 |
-|---|---|---|---|---|---|---|---|---|
-|  | role.frontend-engineer | runtime.skill-projection | 从 YAML `core_skills` 复制 | Explorer / Drafter / Worker / Reviewer / Verifier | frontend / backend / test / review / docs |  | 不得 Freeze / 不得覆盖他人改动 / 不得会签自己的草稿 |  |
-
-| 并行风险 | 缓解措施 | 合并负责人 | 状态 |
-|---|---|---|---|
-| 写范围冲突 | 按文件 / 模块拆分，不重叠写入 | 主控 Agent | open / mitigated / blocked |
-| 实现者自审 | Reviewer 必须独立于 Worker / Drafter | 主控 Agent | open / mitigated / blocked |
-| 验证不足 | Verifier 执行 fresh verification 并记录命令 | 主控 Agent | open / mitigated / blocked |
-
-| 子代理输出 | 主控采纳结论 | 未采纳原因 | 回填资产 |
-|---|---|---|---|
-|  | 采纳 / 部分采纳 / 不采纳 / 需返工 |  |  |
-
-## 7. 回滚点与风险
-
-| 风险 | 回滚点 | 观察信号 | 负责人 |
-|------|--------|----------|--------|
-|  |  |  |  |
-
-## 8. 完成标准
-
-- [ ] 垂直切片 Ticket 完整，且状态允许进入实现。
-- [ ] 统一合同包含 `contract_id` / `contract_version`、Common、Frontend、Backend、Contract 和 Cross-repo 子合同；不适用项均有原因。
-- [ ] 生命周期编排器已批准并持久化合同；实现合同编译器 没有自行给出 `approved` 或 `ready-for-agent`。
-- [ ] YSS skills 已最小化选择，没有绕过 Ticket、OpenAPI Freeze / 无 API 影响记录或必要的 Spec Delta。
-- [ ] 后端切片如适用，已填写 `Backend Slice Implementation Contract`，并且 required skills、禁止模式、证据文件、延期 seam 和验证命令完整。
-- [ ] 受影响外部实现仓库已登记，并绑定分支、MR / PR、CI 和验证命令。
-- [ ] 受影响 frontend / backend 工程存在性已判定；0-1 缺失工程已登记 `scaffold_status=required`、确认外部脚手架目标并路由对应脚手架 skill。
-- [ ] 原型确认后已满足 `backend_scaffold_policy_satisfied`；脚手架只生成工程骨架，所有后续生成代码均经批准合同和 YSS skill 路由。
-- [ ] DDL / SQL / 数据库迁移及其他上游明确的人工确认结论已记录。
-- [ ] `seam-deferred` 若存在，已填写风险、责任人、后续 Ticket、验证计划和目标版本 / 发布日期。
-- [ ] 若使用 subagent，已记录任务包、写范围、独立 review、verification 命令和主控采纳结论。
-- [ ] 每个切片包含测试命令、验证方式和回滚点。
-- [ ] 每个工作单元均绑定唯一 TDD 模式，且 Execution Result 引用合同版本并包含实际验证结果和时间。
-- [ ] `changed_files`、证据文件、`deviations`、`new_impacts`、`drift` 和 `violation` 已完成汇总核验；需重路由时合同已标记 `stale` 并暂停相关工作单元。
-- [ ] 需要人工确认的事项已记录范围、责任人和结论。
-
-## 9. 下一步门禁
-
-- 实现合同编译器 结论：draft / blocked / ready-for-lifecycle-review
-- 生命周期编排器结论：approved / rejected / pending
-- 下一步：生命周期合同审查 / TDD 实现 / 完整重路由 / Architecture Re-check / 回到 系统 / 数据架构设计 / 回到垂直切片
-- 阻断项：
-- stale 合同 / 工作单元：
-- 恢复条件：

package/template/docs/templates/release-note-template.md

@@ -1,14 +0,0 @@
----
-pipeline: <feature-id>
-stage: archive
-status: draft
-owner: ai
----
-
-# 发布说明：<功能名称>
-
-## 变更内容
-
-## 迁移说明
-
-## 验证结果

package/template/docs/templates/requirement-freeze-template.md

@@ -1,63 +0,0 @@
----
-pipeline: <feature-id>
-stage: requirement-freeze
-status: draft
-owner: ai
----
-
-# <功能名称>需求冻结记录
-
-> 适用场景：Spec 初稿经过产品总体设计 / 功能架构、产品设计 / 原型评审后，需要冻结可进入 API 影响分析 / 契约草案和工程设计的范围。
-> 本文记录最终范围、回填项、非目标和开放问题，不替代 Spec。
-
-## 1. 输入材料
-
-| 资产 | 路径 / 链接 | 状态 | 备注 |
-|------|-------------|------|------|
-| Spec 初稿 |  |  |  |
-| 产品总体设计 / 功能架构 |  |  | 必需 |
-| 产品设计 / 交互说明 |  |  |  |
-| 原型交付物 | `docs/.scratch/<feature>/design/prototypes/index.html` 或稳定 URL |  | 有产品设计影响时必需；按 H1/H2 档位提供 Prototype Evidence schema v4、Visual Baseline schema v1、浏览器、Design QA 与条件 AntD 事实；真实组件待验事项进入前端实现计划 |
-| Prototype Review |  |  |  |
-| CONTEXT 术语 |  |  | 业务术语须含 PascalCase `英文标识` |
-
-## 2. 冻结范围
-
-| 能力 | 是否冻结进入本轮 | 优先级 | 验收标准链接 / 摘要 |
-|------|------------------|--------|---------------------|
-|  | 是 / 否 | P0 / P1 / P2 |  |
-
-## 3. Spec 回填完成情况
-
-| 回填项 | 来源 | 处理结果 | 是否阻断 |
-|--------|------|----------|----------|
-|  | 产品设计 / 原型评审 / 架构 | 已回填 / 延后 / 拒绝 | 是 / 否 |
-
-## 4. 非目标与延后项
-
-| 项目 | 原因 | 后续触发条件 |
-|------|------|--------------|
-|  |  |  |
-
-## 5. OpenAPI 与架构影响
-
-| 影响类型 | 结论 | 下一步 |
-|----------|------|--------|
-| OpenAPI | 有 / 无 / 待确认 | API 影响分析 / 契约草案 / 无 API 影响记录 / 阻断 |
-| 工程基线 | 有 / 无 | 工程基线审查 / 跳过 |
-| 系统架构 | 有 / 无 | 系统概要设计 / 跳过 |
-| 数据架构 | 有 / 无 | 数据架构 / 跳过 |
-| 高风险变更 / 人工确认项 | 有 / 无 | 需确认 / 不适用 |
-
-## 6. 完成标准
-
-- [ ] Spec 已吸收产品总体设计 / 功能架构、产品设计、低保真原型评审和原型交付物暴露的阻断项。
-- [ ] 本轮做什么、不做什么、延后什么已经明确。
-- [ ] OpenAPI、工程基线、系统架构、数据架构、风险影响已有明确结论。
-- [ ] 可进入 API 影响分析 / 契约草案 / 工程基线，或阻断项已列出。
-
-## 7. 下一步门禁
-
-- 结论：Approved / Blocked
-- 下一步：API 影响分析 / 契约草案 / 工程基线 / 回到 Spec 或产品设计
-- 阻断项：

package/template/docs/templates/retro-report-template.md

@@ -1,16 +0,0 @@
----
-pipeline: <feature-id>
-stage: archive
-status: draft
-owner: ai
----
-
-# 复盘报告：<功能名称>
-
-## 做得好的地方
-
-## 需要改进的地方
-
-## 改进动作
-
-## 沉淀去向

package/template/docs/templates/risk-register-template.md

@@ -1,11 +0,0 @@
----
-pipeline: <feature-id>
-stage: design
-status: draft
-owner: ai
----
-
-# 风险登记表：<功能名称>
-
-| 风险 | 影响 | 可能性 | 应对措施 | 负责人 |
-|------|--------|------------|------------|-------|

package/template/docs/templates/user-story-template.md

@@ -1,20 +0,0 @@
----
-pipeline: <feature-id>
-stage: open
-status: draft
-owner: ai
----
-
-# 用户故事：<功能名称>
-
-## 故事
-
-作为<用户>，我希望<能力>，以便<业务结果>。
-
-## 验收标准
-
-```gherkin
-假如 <上下文>
-当 <操作>
-那么 <结果>
-```

package/template/docs/templates/verification-record-template.md

@@ -1,53 +0,0 @@
----
-pipeline: <feature-id>
-stage: verify
-status: draft
-owner: ai
----
-
-# <功能名称>Fresh Verification 记录
-
-> 适用场景：合并、发布、归档或宣称完成前。
-> 本文记录最新验证证据；没有 fresh verification，不得给出“完成 / 可合并 / 可发布”结论。
-
-## 1. 验证范围
-
-| 范围 | 说明 | 是否覆盖 |
-|------|------|----------|
-| Spec 验收标准 |  | 是 / 否 |
-| OpenAPI / 契约 |  | 是 / 否 / 不适用 |
-| 后端行为 |  | 是 / 否 / 不适用 |
-| 前端组件 / 页面 |  | 是 / 否 / 不适用 |
-| E2E 关键路径 |  | 是 / 否 / 不适用 |
-| 风险 / 回滚约束 |  | 是 / 否 / 不适用 |
-
-## 2. 命令与结果
-
-| 时间 | 命令 | 结果 | 备注 |
-|------|------|------|------|
-|  |  | pass / fail / skipped |  |
-
-## 3. 手工验证
-
-| 场景 | 步骤 | 结果 | 证据 |
-|------|------|------|------|
-|  |  |  |  |
-
-## 4. 未覆盖风险
-
-| 风险 | 原因 | 处理方式 |
-|------|------|----------|
-|  |  |  |
-
-## 5. 完成标准
-
-- [ ] 验证命令是本次完成前新鲜执行的结果。
-- [ ] 失败项已有修复或明确阻断。
-- [ ] skipped 项有合理原因和后续处理方式。
-- [ ] 发布 / 合并 / 归档所需证据已能追溯。
-
-## 6. 结论
-
-- 验证结论：Approved / Blocked
-- 可合并 / 可发布：是 / 否
-- 阻断项：

package/template/docs/testing/README.md

@@ -1,110 +0,0 @@
-# 测试策略 (Testing Strategy)
-
-> **覆盖全流程：单元 → 集成 → E2E → 性能 → 安全**
-
----
-
-## 测试金字塔
-
-```
-           ┌──────┐
-           │ E2E  │  ← Playwright (关键流程 100% 覆盖)
-           ├──────┤
-           │ 集成  │  ← pytest + httpx (API 端点)
-           ├──────┤
-           │ 单元  │  ← pytest + vitest (Service/Hook/组件)
-           └──────┘
-```
-
----
-
-## 各层测试策略
-
-### 单元测试 (Unit)
-
-| 层级 | 工具 | 覆盖率 | Mock 策略 |
-|------|------|--------|----------|
-| 后端 Service | pytest | ≥90% | Mock DB/外部API，不 mock 内部 Service |
-| 后端 Model | pytest | ≥90% | 验证字段定义/约束 |
-| 前端 Hook | vitest | ≥90% | Mock API 调用 |
-| 前端 工具函数 | vitest | ≥90% | 纯函数不 mock |
-
-### 集成测试 (Integration)
-
-| 层级 | 工具 | 覆盖率 | 策略 |
-|------|------|--------|------|
-| API 端点 | pytest + httpx + ASGITransport | ≥80% | 真实路由 + Mock 数据层 |
-| 数据库 (未来) | pytest + test DB | ≥80% | 每测试独立事务，自动回滚 |
-
-### E2E 测试
-
-| 场景 | 工具 | 策略 |
-|------|------|------|
-| 关键业务流程 | Playwright | 100% 覆盖 |
-| 视觉回归 | Playwright + screenshot | 关键页面 |
-| 跨浏览器 | Playwright (Chromium + Firefox) | 关键流程 |
-
-### 性能测试
-
-| 指标 | 工具 | 目标 |
-|------|------|------|
-| API 响应时间 | locust / k6 | P99 ≤ 200ms |
-| 并发用户 | locust | 1000 并发 P99 ≤ 500ms |
-
-### 安全测试
-
-| 检查项 | 工具 | 频率 |
-|--------|------|------|
-| 依赖漏洞 | pip audit / npm audit | 每次 PR |
-| 代码安全 | bandit (Python) | 每次 PR |
-| SAST | semgrep | 每次 PR |
-
----
-
-## AI 在测试中的角色
-
-### 1. 测试生成 Agent — 分析影响范围，自动生成测试
-
-```python
-delegate_task(
-    goal="分析本次 PR diff，生成被修改代码的针对性测试",
-    context="""
-    分析 git diff，对每个修改的函数：
-    1. 识别未覆盖的代码路径
-    2. 生成单元测试 (边界值/等价类/异常路径)
-    3. 如果修改了 API 端点，生成集成测试
-    
-    输出：可直接运行的测试代码
-    """,
-    toolsets=["terminal", "file"]
-)
-```
-
-### 2. 失败诊断 Agent — 测试失败时辅助定位
-
-```python
-delegate_task(
-    goal="分析测试失败日志，定位根因",
-    context="""
-    失败测试输出：[贴入 pytest/vitest 输出]
-    
-    1. 归类失败 (代码bug / 测试bug / 环境问题)
-    2. 定位最可能的根因文件+行号
-    3. 给出修复建议
-    """,
-    toolsets=["terminal", "file"]
-)
-```
-
----
-
-## 质量门禁
-
-| 门禁 | 条件 | 阻断级别 |
-|------|------|---------|
-| 单元测试 | 100% pass | 🔴 阻断合入 |
-| 集成测试 | 100% pass | 🔴 阻断合入 |
-| 覆盖率 | ≥80% (新增代码) | 🟡 警告 |
-| Lint | 0 error | 🔴 阻断合入 |
-| 安全扫描 | 0 high/critical | 🔴 阻断合入 |
-| 发布门禁 | 项目定义的质量门禁通过 | 🔴 阻断合入 |