create-yss-spec 2.1.7 → 2.1.9

package/template/.trae/skills/yss-product-lifecycle/references/orchestration.md

@@ -6,7 +6,7 @@
 2. `setup readiness`：每个任务只执行一次，核对 tracker、五态标签和领域文档布局，并在本轮缓存结果；仅在 tracker、主远端、真实标签或配置变化时重查。
 3. 加载父 Ticket/checkpoint 与真实资产，计算最近可信阶段。
 4. 评估资产、门禁和 `stale`，选择第一个未阻塞工作单元。
-5. 调用一个最小 Matt/YSS 专项 skill，将结果归一化为 `Matt Skill Result`，验收输出并回写状态与证据。
+5. 执行最小生命周期工作单元：只实际调用允许的 model-invoked skill；Matt user-invoked skill 仅作为 workflow reference。将结果归一化为 `Workflow Execution Result`，验收输出并回写状态与证据。
 6. 若仍在授权和自动推进边界内，回到第 3 步；否则暂停。
 
 不要仅输出下一个提示词后结束 `orchestrate`/`resume`。不要因进入业务代码阶段而退出主控；应把实现交给专项 skill，并在返回后继续核验。
@@ -40,7 +40,7 @@ Readiness 结果在同一任务内复用。只有 tracker、主远端、真实
 | 状态 | 判定 | 动作 |
 |---|---|---|
 | `ready` | tracker、Local `Status:` 或远程标签和领域布局兼容 | 继续 |
-| `missing` | 必要配置缺失 | 路由 `setup-matt-pocock-skills` |
+| `missing` | 必要配置缺失 | `needs-human`；说明缺失项并请用户显式运行 `setup-matt-pocock-skills`，随后回到 readiness |
 | `conflict` | 多个持久配置或真实标签/Local 状态互相矛盾 | 暂停并提出迁移方案，不覆盖 |
 | `degraded` | 已选择的 GitHub/GitLab 不可用 | 建 `docs/.scratch/<feature>/` 待发布草案，不改投平台 |
 | `not-applicable` | `template-source` | 只验证模板契约 |
@@ -51,11 +51,11 @@ tracker 选择和冲突按 `docs/agents/issue-tracker.md` 裁决：已持久化
 
 ## Matt flow 进入条件
 
-- `to-spec` 只能在 `grill-with-docs` 退出条件满足且没有未回流 runnable blocker 时进入；产物默认为 `ready-for-human`。
-- `to-tickets` 只能在 OpenAPI Freeze 或无 API 影响记录完成后进入，并且只能生成垂直切片 Ticket；YSS active 下初始角色统一为 `ready-for-human`，不得沿用 Matt 的通用 `ready-for-agent` 默认值。
-- `implement` 无论是多会话还是单会话，都必须满足 `ready-for-agent` 公式、批准并持久化的 Slice Implementation Contract 和 Build Architecture Checklist。
+- `work-unit.discovery-interview` 实际调用 `grilling` 和 `domain-modeling`。`to-spec` 只能由用户显式启动；生命周期仅在其前准备并验收，正式 Spec 默认为 `ready-for-human`。
+- `to-tickets` 只能由用户显式启动；生命周期仅在 OpenAPI Freeze 或无 API 影响记录后准备和验收垂直切片，初始角色统一为 `ready-for-human`。
+- `implement` 只能由用户显式启动；无论多会话还是单会话，生命周期都在其前后核验 `ready-for-agent` 公式、批准并持久化的 Slice Implementation Contract 和 Build Architecture Checklist。
 - `implement` 遇到 backend `scaffold_status=required` 时，还必须满足原型确认后的脚手架策略：脚手架 Execution Result、`yss-backend-scaffold-parent` 基线、Wrapper 验证和 Router 合同重编译均已回写；否则停在工程基线，不得写业务代码。
-- Matt Result 出现 `drift`、`new_impacts`、`stale_candidates`、`violation`、`missing_evidence`、空 `evidence_refs` 或缺少必需字段时暂停当前工作单元。
+- `Workflow Execution Result` 出现 `drift`、`new_impacts`、`stale_candidates`、`violation`、`missing_evidence`、空 `evidence_refs` 或缺少必需字段时暂停当前工作单元；旧结果只能先经只读兼容 adapter 归一化。
 
 ## 审查与验证
 

package/template/.trae/skills/yss-product-lifecycle/references/state-model.md

@@ -50,7 +50,7 @@ AND 所有后续生成代码均绑定主 YSS skill、依赖闭包、允许写路
 
 父 Ticket、Spec、设计、原型、OpenAPI Draft、wayfinder map 和 decision ticket 不得使用 `ready-for-agent`。
 
-YSS active 调用 `to-tickets` 时，垂直切片初始角色固定为 `ready-for-human`。只有 `yss-product-lifecycle` 复算上述公式全部为真后，才能把它提升为 `ready-for-agent`；Matt `to-tickets` 的独立默认值不参与该裁决。
+用户显式运行 `to-tickets` 后，垂直切片初始角色固定为 `ready-for-human`。只有 `yss-product-lifecycle` 复算上述公式全部为真后，才能把它提升为 `ready-for-agent`；生命周期不会自动调用 `to-tickets`，其默认标签也不参与该裁决。
 
 ## Review 与 Git 授权状态
 

package/template/.trae/skills/yss-prototype-stage/SKILL.md

@@ -11,7 +11,7 @@ description: Use when a YSS feature has product-design impact on a primary flow,
 
 - 先由 `yss-product-lifecycle` 判断产品设计影响；无行为变化的孤立视觉修复记录 `not-applicable`，不创建空资产。
 - Codex 的产出主入口是 `product-design:index`；其他 Agent 使用等价的产品设计能力，但必须产出本技能规定的相同资产和证据。能力或证据不能等价时，暂停并回到人工确认。
-- 旧 `product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅为兼容入口；从它们进入时立即回到本合同。
+- `product-design-prototype`、`high-fidelity-html-prototype` 仅为兼容入口；从它们进入时立即回到本合同。已退休的原型技能不得继续路由。
 
 ## 资产与门禁顺序
 

package/template/AGENTS.md

@@ -20,8 +20,8 @@
 | Agent 入口、硬门禁、禁止事项       | `AGENTS.md`                                 |
 | 主阶段、门禁、产物、工作单元、证据和稳定 ID | `docs/process/lifecycle-registry.yaml`；`docs/process/lifecycle-artifact-map.md` 为派生阅读视图 |
 | 影响面触发与 `not-applicable` | `docs/process/harness-process-tailoring.md` |
+| 模板维护强度触发与最低等级 | `docs/process/maintenance-intensity.yaml` |
 | 技能清单、来源、版本、哈希和投影目标      | `skills-lock.json`                          |
-|                         |                                             |
 
 README、用户指南和其他说明文档只引用或解释上述事实，不重复定义同一规则。
 
@@ -32,44 +32,22 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 - 新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。过时术语和技能名只能出现在迁移指南或明确标注的旧项目上下文。
 - 实施前读取 `CONTEXT.md`；与词汇或 ADR 冲突时立即指出并先解决冲突。
 
-## 4. `template-source` 模板维护流程
+## 4. `template-source` 模板维护路由
 
-```text
-影响面分析
-→ 修改对应单一事实来源
-→ 同步技能投影和派生文档
-→ 执行压力场景与 scripts/verify-template
-→ 独立审查和 Git checkpoint
-```
+按“影响面 → 单一事实来源 → 投影 / 派生资产 → 分级证据”维护。强度分级、最低证据和 checkpoint 合同见 `docs/process/harness-process-tailoring.md`。
 
-硬门禁：
-
-- 修改 skill、`AGENTS.md`、流程规则或模板时，必须使用 `writing-skills` 的 RED / GREEN / REFACTOR 思路，保留基线失败、压力场景和修订后验证证据。
+- 创建、修改或退役 skill 时使用 `maintaining-skills`，并先按 `docs/process/harness-process-tailoring.md` 判定 L1 / L2 / L3；只有 L3 必须保留完整基线失败、压力场景、修订后验证和正式独立审查证据。
 - `.agents/skills` 是跨 Agent 共享技能的权威内容；`.claude/skills`、`.codex/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的共享技能是生成投影，禁止分别手工修改。
 - `scripts/verify-template` 是模板发布阻断门禁。模板与外部 `create-yss-spec` 的跨仓库契约未完成集成验证时，不得声称可发布。
 
 ## 5. `project-instance` 产品研发路由
 
-任务开始时先根据 `docs/process/harness-process-tailoring.md` 判断小改动、中等变更或新模块 / 高风险变更，定位最近可信阶段。日常骨架为：
-
-```text
-入口分诊
-→ 机会与 Discovery
-→ 业务 / Spec / 功能架构
-→ 产品设计与需求冻结
-→ 系统 / 数据架构与工程契约设计审查
-→ 契约冻结与 Ticket 正式化
-→ 垂直切片与 TDD 实现
-→ 验证发布与复盘
-```
-
-执行原则：
+先用 `docs/process/harness-process-tailoring.md` 判定变更类型、影响面和最近可信阶段，再按 `docs/process/lifecycle-registry.yaml` 执行命中的工作单元和条件门禁。
 
 - 生命周期注册表中的条件门禁全部按影响面强制。命中触发条件时必须完成；未命中时只记录 `not-applicable` 及原因，不生成空文档；不得把产物、工作单元或证据统称为门禁。
 - 安全 / 权限不设独立生命周期资料或专属门禁。日常功能不做额外登记、`not-applicable` 或推导校验；只有需求或冻结资产明确要求改变认证、授权、租户隔离、敏感数据或合规行为时，才把该行为写入普通 Spec、API、架构、验收和测试 seam，并仅按实际 UI、API、Backend、Data、High-risk 影响触发既有门禁。普通 action 注册、沿用既有认证中间件、未变化的 `401` / `403`、一般字段、SQL / DDL / 迁移和上传 / 下载本身不构成安全 / 权限专项。
 - `seam-deferred` 只能显式记录风险、责任人、后续 Ticket、验证计划和目标版本或发布日期。
-- 新功能或较大变更先用 `grill-with-docs` 澄清，再用 `to-spec` 形成 Spec。
-- 只要进入 Spec 基线，必须产出产品总体设计或功能架构；只有 UI 变化触及主流程、导航、权限体验、异常 / 恢复状态、状态流转或 API 反推时，才构成产品设计影响并强制低保真页面草图、状态矩阵、Ant Design v6 高保真 HTML 原型和用户确认。文案、token、颜色、间距和无行为变化的孤立视觉修复记录 `not-applicable`。
+- 新功能或较大变更先用 `grill-with-docs` 澄清，再用 `to-spec` 形成 Spec；Spec 基线和产品设计影响的完整判定以注册表和裁剪规则为准。
 - API 契约变更先形成 OpenAPI 3.1 Draft，经必要的工程基线、系统 / 数据架构和设计审查后 Freeze，再进入实现。
 - Spec Delta 只记录相对既有冻结 Spec 基线的高风险行为差异；全新产品、全新模块和低风险调整不生成 Spec Delta。
 - OpenAPI Freeze 或无 API 影响记录完成后，使用 `to-tickets` 拆成可独立验证的窄垂直切片，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分。
@@ -79,24 +57,18 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 - 每个功能先建立功能父 Ticket，用于汇总 Spec、设计、审查、OpenAPI Freeze、阻塞项和阶段证据。
 - Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`。
 - 只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket，才能使用 `ready-for-agent`。
-- Ticket、Spec 和阶段证据必须按 `docs/agents/issue-tracker.md` 选择的主 tracker 持久化；模板默认使用 Local Markdown，完整功能包保存于 `docs/.scratch/<feature>/`。GitHub / GitLab 只有在项目明确选择时才作为主 tracker，Git remote 仅代表代码托管，不覆盖 tracker 选择；选定远程平台不可用时才生成 `docs/.scratch/<feature>/` 下的待发布草案，不自动改投其他平台。
-
-平台规则和五态标签见 `docs/agents/issue-tracker.md` 与 `docs/agents/triage-labels.md`。
+- Ticket、Spec 和阶段证据按 `docs/agents/issue-tracker.md` 选定的主 tracker 持久化；Git remote 不代表 tracker 选择，平台不可用时按该文档生成待发布草案。五态标签见 `docs/agents/triage-labels.md`。
 
 ## 7. 实现与 YSS 路由硬门禁
 
-进入实现前：
+进入实现时先读 `docs/process/implementation-repo-integration.md`，登记实现仓库、项目根、分支、CI、验证命令和回滚点；再使用 `yss-router` 编译最小 skill 集合与当前实现合同。
 
-1. 确认受影响的 frontend / backend 工程是 `existing`、`required` 还是 `initialized`，并登记实现仓库、分支、CI、验证命令和回滚点。
-2. 无可复用工程时，先确认外部目标仓库或输出目录，再分别使用 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator`；不因当前仓库缺少 frontend / backend 目录而绕过脚手架路由。
-3. 原型确认后，若 backend 为 `scaffold_status=required`，先由 `yss-router` 编译结构化脚手架受控生成工作单元合同，经生命周期编排器批准并持久化为合同 JSON 后，才使用 `yss-ddd-scaffold-generator` 读取该文件生成骨架；随后由受控工作单元实际执行项目根目录的 `./mvnw validate`、`./mvnw test`、`./mvnw package` 并记录逐条结果，再用 `yss-backend-scaffold-parent` 做工程基线校验并重新进入 Router；不得在合同批准前、脚手架前或脚手架内写业务代码。
-4. 使用 `yss-router` 选择最小 YSS skill 集合。后端领域、Application、Repository / Gateway、Web / DTO 分别路由到对应 YSS skill；涉及 POJO 样板或对象转换时必须加载 `lombok`、`mapstruct` 和 `alibaba-java-code-style`。复用已验证的平台认证 / 授权能力本身不增加专项 skill；只有真实触碰当前用户、审计、加密、权限行为或安全边界时才增加对应路由。
-5. 所有正式垂直切片必须先由 `yss-router` 编译 Slice Implementation Contract 草案，再由生命周期编排器核验并持久化；合同至少包含 Common、Frontend、Backend、Contract、Cross-repo 子合同、工作单元、TDD 模式、允许写路径、禁止模式、证据和验证命令。Router 不得自行批准合同或设置 `ready-for-agent`。
-6. 后端切片必须在统一合同中补齐 Backend Slice Implementation Contract，至少包含 `required_skills`、`allowed_write_paths`、`forbidden_patterns`、`expected_evidence_files`、`seam_deferred`、`verification_commands`。
-7. 把系统 / 数据架构、ADR、工程基线、OpenAPI Freeze 和风险 / 回滚约束转译为 Build Architecture Checklist。明确写入需求的权限业务行为仍使用 `behavior-tdd`，且不放宽 `controlled-generation` 的禁止范围。
-8. 脚手架输出消费批准的脚手架合同；所有后续生成的后端代码都必须消费批准且版本当前的 Slice Implementation Contract、YSS skill 依赖闭包、允许写路径、预期证据和 YSS Skill Execution Result；业务行为只能使用 `behavior-tdd`，路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 阻断继续实现或触发重路由。
+- 无可复用工程时，先确认外部目标仓库或输出目录，再使用 `yss-ddd-scaffold-generator` / `yss-frontend-scaffold-generator`；当前仓库缺少 frontend / backend 目录不改变此路由。
+- 脚手架只在 `scaffold_status=required` 且受控生成合同已持久化、获得生命周期批准后运行；它只产生机械骨架，业务行为回到 Router 并使用 `behavior-tdd`。
+- 正式垂直切片必须消费已批准、已持久化且版本当前的 Slice Implementation Contract。Router 只生成草案，不批准合同、不设置 `ready-for-agent`、不宣布完成。合同 schema、Backend 子合同和证据字段以 `yss-router` references 为准。
+- 路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 时停止实现并重新路由。
 
-禁止绕过上述合同、检查清单或专项 skill，直接在 `AGENTS.md` 中自行发明细则。详细实现约束以 YSS skills、`docs/process/implementation-repo-integration.md` 和对应模板为准。
+实现细则由已批准合同、YSS skills 和实现接入文档定义；`AGENTS.md` 只保留入口与边界。
 
 ## 8. 专项任务的强制入口
 
@@ -114,34 +86,22 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 
 ## 9. 工作区与实现仓库边界
 
-当前仓库默认是研发管理仓库，前端、后端和其他运行时代码优先位于独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才可按需创建：
+当前仓库默认是研发管理仓库，运行时代码优先位于已登记的独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才使用唯一的 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 项目根。
 
-```text
-apps/
-├── backend/<project>/
-└── frontend/<project>/
-```
-
-`apps/backend/` 和 `apps/frontend/` 只能作为项目容器，不能直接作为某个工程项目的输出目录；每个工程必须落在唯一的 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 下，多个项目按项目目录并列。`app/backend/`、`app/frontend/` 及其子路径是禁止的工程输出路径，不能因脚手架、临时目录或已有目录而放行。
-
-实现仓库为外部仓库时，不强制把源码搬入本 Harness 的 `apps/`；但必须在实现仓库登记和 Slice Implementation Contract 中记录实际仓库、项目根路径、分支、CI、验证命令和回滚点。不得自行新建其他顶层业务代码目录。
+`apps/backend/` 和 `apps/frontend/` 只是项目容器；`app/backend/`、`app/frontend/` 及其子路径禁止作为工程输出。完整登记字段和跨仓约束见 `docs/process/implementation-repo-integration.md`。
 
 ## 10. 独立审查、验证和追踪
 
-- 实现者不能审查自己的代码。模板发布、代码切片和高风险变更必须由其他 Agent 或人工独立审查；低风险文档变更可使用显式人工 checkpoint。
+- 实现者不能承担命中的独立审查。模板维护按 L1 / L2 / L3 分别使用 self-check / 人工 checkpoint、聚焦独立审查、正式独立审查；模板发布、代码切片和高风险变更仍必须由其他 Agent 或人工独立审查。
 - 任何“完成 / 可合并 / 可发布”结论必须基于 fresh verification，不接受“之前跑过”或实现者自述。
-- 连续自动推进期间累积各阶段和垂直切片的 Ticket 证据，在人工暂停、handoff、进入实现、合并或发布边界集中同步范围、验证证据、风险、人工审查点和下一步；阻塞、责任人变化或资产单独批准时立即同步。
-- Git checkpoint 与上述边界对齐，列出本轮覆盖阶段、变更产物和 Ticket 同步状态，排除无关脏文件；只有用户已授权时才按明确范围提交或推送。集中记录不得丢失各阶段因果关系。
+- 在人工暂停、handoff、进入实现、合并或发布边界集中同步范围、验证证据、风险、人工审查点、Ticket 状态和下一步；阻塞、责任人变化或资产单独批准时立即同步。
+- Git checkpoint 只包含本轮明确范围；获得用户授权后才提交或推送。
 - 发布后或阶段性完成后做复盘判断；出现架构返工、验证返工、IMPORTANT / CRITICAL review finding 或人工确认延期时，落简体中文复盘并修订权威资产。
 
 ## 11. Subagent 协同
 
-使用 subagent 前必须定义任务包：输入资产、输出产物、可写范围、禁止事项、验收标准和汇合方式。写入范围不得重叠，实现者不得同时担任审查者。
-
-subagent 可收集证据、产出草案、实现局部切片和执行独立审查 / 验证，但不得替代主控 Agent 作出仓库身份判定、Spec baseline、需求冻结、OpenAPI Freeze、架构放行、Ticket 最终状态、Git checkpoint 范围或“完成 / 可合并 / 可发布”结论。
-
-详细规则见 `docs/process/subagent-collaboration.md`。
+使用 subagent 前按 `docs/process/subagent-collaboration.md` 定义任务包和不重叠的写入范围。实现者不担任独立审查者；仓库身份、需求 / 契约冻结、Ticket 最终状态、Git checkpoint 和完成结论仍由主控 Agent 或人工决定。
 
 ## 12. 测试质量基线
 
-模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。这些数字只是模板推荐；项目实例必须在测试策略中明确采纳或覆盖后，才构成 CI 门禁。未定义关键流程清单时，不得声称其 E2E 覆盖率达到 100%。
+模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。只有项目实例在测试策略中明确采纳或覆盖后才构成 CI 门禁；未定义关键流程清单时，不声称其 E2E 覆盖率达到 100%。

package/template/docs/adr/0001-product-design-prototype-entrypoint.md

@@ -24,7 +24,7 @@ YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入
 |------|------|------|------|
 | 继续使用多个原型技能并列入口 | 对旧流程改动少 | Agent 路由不稳定，难以统一 AntD v6 高保真 HTML 原型和确认记录 | 放弃 |
 | 只保留 `high-fidelity-html-prototype` | 产物目标直接 | 缺少 Product Design plugin 的上下文、视觉探索、URL / 图片 / 代码来源路由能力 | 放弃 |
-| 以 `product-design:index` 为主入口，旧技能保留兼容 | 路由统一，可复用 focused skills，迁移风险低 | 需要在文档中明确 legacy 边界 | 采纳 |
+| 以 `product-design:index` 为主入口，只保留仍有迁移价值的兼容入口 | 路由统一，可复用 focused skills，并允许逐步退休冗余入口 | 需要在文档中明确 legacy 边界 | 采纳 |
 
 ## 后果
 
@@ -37,7 +37,7 @@ YSS Harness 需要把有 UI 功能的产品原型产出收敛到一个稳定入
 ### 负面影响
 
 - 需要维护完整 `.codex/skills/product-design/` 插件目录，不能只复制 `index/SKILL.md`。
-- 旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境。
+- 部分旧原型技能在过渡期仍会存在，需要通过流程文档限制使用语境；无继续维护价值的入口直接退休，不保留空壳目录。
 
 ### 风险
 

package/template/docs/agents/skills-maintenance.md

@@ -27,13 +27,13 @@
 
 当前 Matt 快照为 `6acc160e4e0cd062dbbbd7a1b26ae92855edf07e`。`ask-matt` 的关联入口包括 `to-questionnaire`、`wait-what`、`writing-for-agents` 和 `PHASE-BOUNDARIES.md`；这些支持文件随共享 skill 目录一起计算 `effectiveHash`，不得单独投影或维护。
 
-本轮升级还将生命周期适配固定为：阶段边界只写可选 `phase_boundary` 证据；`to-questionnaire` 使用 `external-input-required` 暂停并在答案回流后重新分类影响面；Matt `prototype` 使用 `prototype/<name>` 分支和单文件 HTML，YSS 高保真原型继续执行 Prototype Review、AntD CLI 校验和用户确认。`wizard` 的人工步骤以及 `diagnosing-bugs` 的输出必须脱敏，`wait-what` 不改变生命周期状态。
+本轮升级还将生命周期适配固定为：阶段边界只写可选 `phase_boundary` 证据；`to-questionnaire` 使用 `external-input-required` 暂停并在答案回流后重新分类影响面；Matt `prototype` 使用 `prototype/<name>` 分支和单文件 HTML，YSS 高保真原型继续执行 Prototype Review、AntD CLI 校验和用户确认。人工 checkpoint 与 `diagnosing-bugs` 的输出必须脱敏，`wait-what` 不改变生命周期状态。
 
 ## 维护流程
 
 1. 在临时目录读取或下载锁定来源，不直接覆盖工作区。
 2. 只在 `.agents/skills/<skill-name>/` 修改共享技能；平台专属技能只在所属 root 修改。
-3. 修改流程型 skill 时按 `writing-skills` 记录 RED 基线、压力场景、GREEN 结果和 REFACTOR 检查。
+3. 创建、修改或退役 skill 时使用 `maintaining-skills`，并先按 `docs/process/harness-process-tailoring.md` 判定验证与审查强度：L1 执行相关检查，L2 记录最小反例和 fresh verification，L3 记录完整 RED 基线、压力场景、GREEN 结果和 REFACTOR 检查。未定义分级的外部仓库按实际风险执行结构校验和针对性行为验证，不强制为每次普通修改构造失败基线。
 4. 生成共享投影并更新锁文件：
 
    ```bash
@@ -73,7 +73,7 @@ YSS 技能的公开发布仓库为 `iloveZzz/yss-spec-dev-skills`，它是本模
 - 发布顺序为：同步 canonical projections → 更新 lock → `scripts/verify-template` → 导出并检查 → 独立审查 → 在 `yss-spec-dev-skills` 提交人工 PR。不得从目标仓库反向覆盖 `.agents/skills`。
 - skills.sh 通过 `npx skills add iloveZzz/yss-spec-dev-skills` 的安装遥测自动发现技能，不需要手工注册；遥测可用 `DISABLE_TELEMETRY=1` 或 `DO_NOT_TRACK` 关闭。
 
-已退休或 personal 的 Matt 条目（`design-an-interface`、`qa`、`request-refactor-plan`、`ubiquitous-language`、`edit-article`、`obsidian-vault`、`writing-great-skills`）不再进入 `.agents/skills`、六个共享投影根或 `skills-lock.json`。迁移时使用 `codebase-design`、`triage + to-tickets`、`to-spec + improve-codebase-architecture`、`domain-modeling` 等新路由，不创建兼容目录。
+已退休或 personal 的条目（`design-an-interface`、`qa`、`request-refactor-plan`、`ubiquitous-language`、`edit-article`、`obsidian-vault`、`writing-great-skills`、`web-design-engineer`、`web-video-presentation`、`wireframe-prototype`、`wizard`、`git-guardrails-claude-code`、`claude-handoff`）不再进入 `.agents/skills`、六个共享投影根或 `skills-lock.json`。迁移时使用 `codebase-design`、`triage + to-tickets`、`to-spec + improve-codebase-architecture`、`domain-modeling`、`product-design:index`、普通人工 checkpoint 或 `handoff` 等现行路由，不创建兼容目录。
 
 ## 外部工作流工具
 

package/template/docs/design/README.md

@@ -41,7 +41,7 @@
 - Product Design focused skills：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
 - `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
 - `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
-- 兼容入口：`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
+- 兼容入口：`product-design-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`，已退休技能不再提供兼容路由。
 
 推荐目录：
 

package/template/docs/process/MATT-POCOCK-ENGINEERING-SKILLS.md

@@ -4,6 +4,6 @@ Matt Pocock Engineering Skills 提供轻量的澄清、实现、TDD、诊断和
 
 ## 进入与退出
 
-- `grill-with-docs`、`to-spec`、`to-tickets`、`implement`、`tdd` 和 `code-review` 必须遵守 `AGENTS.md` 的阶段、门禁和证据要求。
+- Matt user-invoked 的 `grill-with-docs`、`to-spec`、`to-tickets` 和 `implement` 必须由用户显式启动；YSS 生命周期只准备、校验和验收其结果。`tdd`、`code-review` 等 model-invoked skill 仍须遵守 `AGENTS.md` 的阶段、门禁和证据要求。
 - `template-source` 只执行模板维护流程，不生成具体产品 Spec、原型、OpenAPI 或垂直切片 Ticket。
 - Agent 完成工作单元后返回可核验的 evidence refs、变更资产、验证命令、残余风险和下一路由。

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

@@ -15,7 +15,7 @@
 
 | 类型 | 默认入口 | 必需工作 | 可记录为 `not-applicable` |
 |---|---|---|---|
-| 模板源维护 | 影响面分析 | 修改单一事实来源、技能投影同步、压力场景、fresh verification、独立审查 | 产品 Spec、产品设计、OpenAPI、运行时代码 |
+| 模板源维护 | 影响面分析 | 修改单一事实来源、按验证与审查强度分级执行证据、必要的技能投影同步、fresh verification / review | 产品 Spec、产品设计、OpenAPI、运行时代码 |
 | 小改动 | 入口分诊 | 影响面、主 tracker 同步、fresh verification | Spec、架构、原型、切片（没有触发条件时） |
 | 中等变更 | 最近可信的 Spec / 架构阶段 | Spec、功能架构、必要工程审查、父 Ticket 和切片 | 未命中的 UI、数据或 API 门禁 |
 | 全新产品 / 模块 | Discovery | Discovery、Spec、产品总体设计、功能架构、必要设计 / 契约审查、父 Ticket 和切片 | 未命中的 UI、数据或 API 门禁 |
@@ -26,3 +26,39 @@
 ## 3. 执行与证据
 
 同一独立执行者可以在一个连续工作单元内完成相邻的实现动作，但不能替代独立审查者。阶段证据在集中 checkpoint 回写，至少包含：范围、变更文件、受影响仓库、验证命令及结果、阻塞项、人工审查点、Ticket 状态和下一步。
+
+## 4. 模板维护验证与审查强度分级
+
+本节只适用于 `template-source` 的模板、流程规则和共享 skill 维护，不降低 `project-instance` 的 Spec、OpenAPI Freeze、垂直切片或高风险工程门禁。强度由错误逃逸损失和是否改变 Agent 行为决定，不由文件所在目录单独决定。
+
+| 强度 | 权威触发项 | 最低验证证据 | Review |
+|---|---|---|---|
+| L1 | `maintenance-intensity.yaml` 的 `levels.L1.triggers` | 至少一项与变更直接相关的实际检查 | `self-check` 或显式 `human-checkpoint` |
+| L2 | `maintenance-intensity.yaml` 的 `levels.L2.triggers`，或该策略的 `default_level` | 修改前可失败的最小反例，以及本轮 fresh verification | 一名非实施者执行 `focused-independent` 聚焦审查；结论可内联 checkpoint |
+| L3 | `maintenance-intensity.yaml` 的 `levels.L3.triggers` | 完整 RED、GREEN、REFACTOR、压力场景与本轮 fresh verification | 冻结候选后执行 `formal-independent` 正式独立审查；需要时使用完整 `code-review` |
+
+判定规则：
+
+1. 等级只由 `maintenance-intensity.yaml` 计算；未给出 trigger 时使用该策略的 `default_level`，未知 trigger 必须更新策略后才可验证。
+2. 实施者可先分级，不要求 L1/L2 预批准；发现新影响时立即更新 `escalation`、重新分级并补齐证据。
+3. 发布、合并或阶段完成时按整体候选重新判定；不得把共同改变整体语义的修改拆成多个 L1/L2 规避 L3。
+4. RED 用于证明行为差异。L1 不人为构造失败；L2 可使用已有失败、最小 fixture 或现有测试修改前失败；只有行为无法确定性表达时才运行聚焦压力场景。L3 使用 `maintaining-skills` 并执行本节定义的完整 RED、GREEN、REFACTOR 和压力场景要求。
+5. 模板发布候选固定按 L3 聚合验证，但不追溯补造每个既有 L1/L2 修改的独立 RED。
+
+每个模板维护 checkpoint 使用以下轻量合同；L1/L2 可直接写入主 Ticket 或集中 checkpoint，不要求新增独立文档：
+
+```yaml
+schema_version: 1
+intensity: L1 | L2 | L3
+classification_reason: <分级理由>
+triggers: [<可观察触发项>]
+changed_assets: [<路径或资产引用>]
+verification_evidence:
+  - kind: relevant-check | counterexample | red | green | refactor | pressure-scenario | fresh-verification | focused-independent-review | formal-independent-review
+    command: <本轮实际命令或可读取证据引用>
+    result: pass
+review_mode: self-check | human-checkpoint | focused-independent | formal-independent # L2/L3 还必须在 verification_evidence 中给出对应 review 证据引用
+escalation: none | <升级原因和原等级>
+```
+
+使用 `scripts/verify-maintenance-checkpoint <file>` 或通过 stdin 传入 YAML / JSON 做只读校验。触发项 ID 与最低等级只由 `docs/process/maintenance-intensity.yaml` 维护；校验器消费该策略。未知触发项必须先更新该权威策略和场景，不能静默接受。

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

@@ -71,6 +71,7 @@
 | 稳定 ID | 证据 | 说明 |
 |---|---|---|
 | `evidence.impact-assessment` | 影响面分析记录 | 受影响仓库、资产、风险与最近可信阶段。 |
+| `evidence.maintenance-intensity-checkpoint` | 模板维护强度 checkpoint | template-source 变更的 L1 / L2 / L3 分级、触发项、最低验证证据、review 模式和升级记录。 |
 | `evidence.repository-identity-check` | 仓库身份校验结果 | yss-project.yaml 的合法性与 repository_mode 裁决。 |
 | `evidence.approval-record` | 人工批准记录 | 对需要人工批准的 Spec、设计、契约或发布裁决的可追溯记录。 |
 | `evidence.design-review-result` | 设计审查结果 | API、架构或产品设计审查意见及处理结果。 |

package/template/docs/process/lifecycle-registry-baseline.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "registry_id": "yss.lifecycle",
-  "semantic_sha256": "6261529654dba3e3738aa950e42d6af5b5db1b3be4ac6c2e4dc86a395c49ec6f",
+  "semantic_sha256": "308015680acdfdd600c255ce05ef46447c0e9205a5ec0d489c149f131a2e87fc",
   "published_ids": [
     "artifact.architecture-review",
     "artifact.data-architecture",
@@ -32,6 +32,7 @@
     "evidence.design-review-result",
     "evidence.fresh-verification",
     "evidence.impact-assessment",
+    "evidence.maintenance-intensity-checkpoint",
     "evidence.openapi-draft-review",
     "evidence.prototype-confirmation",
     "evidence.prototype-review-result",
@@ -62,6 +63,8 @@
     "work-unit.entry-triage",
     "work-unit.fresh-verification",
     "work-unit.independent-review",
+    "work-unit.intensity-aware-review",
+    "work-unit.intensity-aware-verification",
     "work-unit.release-and-rollback",
     "work-unit.skill-projection-sync",
     "work-unit.ssot-update",

package/template/docs/process/lifecycle-registry.yaml

@@ -8,7 +8,7 @@ id_policy:
   pattern: '^(stage|gate|artifact|work-unit|evidence)\.[a-z0-9][a-z0-9-]*$'
   published_ids_immutable: true
   baseline: docs/process/lifecycle-registry-baseline.json
-  deprecated_ids: []
+  deprecated_ids: [work-unit.fresh-verification, work-unit.independent-review]
 
 stages:
   - id: stage.entry-triage
@@ -48,6 +48,9 @@ evidence:
   - id: evidence.impact-assessment
     name: 影响面分析记录
     description: 受影响仓库、资产、风险与最近可信阶段。
+  - id: evidence.maintenance-intensity-checkpoint
+    name: 模板维护强度 checkpoint
+    description: template-source 变更的 L1 / L2 / L3 分级、触发项、最低验证证据、review 模式和升级记录。
   - id: evidence.repository-identity-check
     name: 仓库身份校验结果
     description: yss-project.yaml 的合法性与 repository_mode 裁决。
@@ -269,18 +272,18 @@ work_units:
     input: 目标仓库、dry-run 计划。
     output: 受管资产和 metadata。
     completion: 验证通过或完整回滚。
-  - id: work-unit.fresh-verification
-    name: Fresh verification
+  - id: work-unit.intensity-aware-verification
+    name: 分级 Fresh verification
     scope: template-source
-    input: 变更仓库。
+    input: 变更仓库、强度分级与对应最低证据。
     output: 命令输出与证据。
-    completion: 所有命中门禁通过。
-  - id: work-unit.independent-review
-    name: 独立审查
+    completion: L1 相关检查、L2 最小反例与 fresh verification、L3 完整 RED / GREEN / REFACTOR 与 fresh verification 按命中等级通过。
+  - id: work-unit.intensity-aware-review
+    name: 分级审查
     scope: template-source
-    input: 变更 diff、验证证据。
-    output: review 结论。
-    completion: 无未处理阻断项。
+    input: 变更 diff、强度分级与验证证据。
+    output: L1 self-check / 人工 checkpoint、L2 聚焦独立审查或 L3 正式独立审查结论。
+    completion: 已按命中等级完成审查且无未处理阻断项；L1 不强制独立 reviewer。
   - id: work-unit.release-and-rollback
     name: 发布与回滚
     scope: template-source

package/template/docs/process/maintenance-intensity.yaml

@@ -0,0 +1,25 @@
+schema_version: 1
+default_level: L2
+levels:
+  L1:
+    triggers:
+      - textual-only
+      - link-only
+      - deterministic-projection
+  L2:
+    triggers:
+      - local-rule
+      - template-structure
+      - non-core-validator
+  L3:
+    triggers:
+      - lifecycle-gate
+      - ticket-state
+      - permission-boundary
+      - generation-semantics
+      - release-semantics
+      - cross-repo-contract
+      - core-validator
+      - historical-important-escape
+      - aggregate-behavior-change
+      - release-candidate

package/template/docs/user-guide//344/272/247/345/223/201/347/240/224/345/217/221/345/205/250/347/224/237/345/221/275/345/221/250/346/234/237/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -482,7 +482,7 @@ docs/.scratch/data-modeling/design/data-modeling-prototype-review.md
 | 图谱、血缘、流程编排画布 | tldraw / xyflow | 适合数据血缘、任务流、关系图等画布型体验 |
 | 进入高保真前门禁 | `prototype-review` | 未通过则回到原型阶段 |
 
-`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容入口或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
+`product-design-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容入口或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`，已退休技能不再提供兼容路由。
 
 如果团队使用 Figma、即时设计、Axure 或其它原型工具，可以在 `docs/.scratch/data-modeling/design/data-modeling-interaction-spec.md` 中保存链接、版本、评审记录和关键截图说明。第一版不强制引入 Excalidraw、Figma、Penpot、tldraw 或 xyflow 作为项目依赖。
 

package/template/scripts/lib/maintenance-intensity.mjs

@@ -0,0 +1,94 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseDocument } from "../vendor/yaml.mjs";
+
+const LEVELS = ["L1", "L2", "L3"];
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+const INTENSITY_POLICY = path.join(root, "docs/process/maintenance-intensity.yaml");
+
+const REQUIRED_EVIDENCE = {
+  L1: ["relevant-check"],
+  L2: ["counterexample", "fresh-verification", "focused-independent-review"],
+  L3: ["red", "green", "refactor", "pressure-scenario", "fresh-verification", "formal-independent-review"]
+};
+
+const REVIEW_MODES = {
+  L1: new Set(["self-check", "human-checkpoint"]),
+  L2: new Set(["focused-independent"]),
+  L3: new Set(["formal-independent"])
+};
+
+function ensure(condition, message) {
+  if (!condition) throw new TypeError(message);
+}
+
+function loadTriggerLevels() {
+  const document = parseDocument(readFileSync(INTENSITY_POLICY, "utf8"), { uniqueKeys: true });
+  ensure(document.errors.length === 0, document.errors[0]?.message || "维护强度策略无法解析");
+  const policy = document.toJS({ maxAliasCount: 0 });
+  ensure(policy?.schema_version === 1 && LEVELS.includes(policy.default_level) && policy.levels && typeof policy.levels === "object", "维护强度策略 schema 无效");
+  const pairs = [];
+  for (const level of LEVELS) {
+    const triggers = policy.levels[level]?.triggers;
+    ensure(Array.isArray(triggers) && triggers.length > 0, `维护强度策略缺少 ${level} triggers`);
+    for (const trigger of triggers) {
+      ensure(typeof trigger === "string" && trigger.trim(), `${level} 包含无效 trigger`);
+      pairs.push([trigger, level]);
+    }
+  }
+  const map = new Map(pairs);
+  ensure(map.size === pairs.length, "维护强度策略包含重复 trigger");
+  return { defaultLevel: policy.default_level, map };
+}
+
+const triggerLevels = loadTriggerLevels();
+
+function levelRank(level) {
+  return LEVELS.indexOf(level);
+}
+
+export function minimumIntensity(triggers) {
+  ensure(Array.isArray(triggers), "triggers 必须是数组");
+  if (triggers.length === 0) return triggerLevels.defaultLevel;
+  let required = "L1";
+  for (const trigger of triggers) {
+    ensure(triggerLevels.map.has(trigger), `未知 trigger: ${trigger}`);
+    const candidate = triggerLevels.map.get(trigger);
+    if (levelRank(candidate) > levelRank(required)) required = candidate;
+  }
+  return required;
+}
+
+export function validateMaintenanceCheckpoint(data) {
+  ensure(data && typeof data === "object" && !Array.isArray(data), "checkpoint 必须是对象");
+  const exactFields = ["schema_version", "intensity", "classification_reason", "triggers", "changed_assets", "verification_evidence", "review_mode", "escalation"];
+  const unknown = Object.keys(data).filter((key) => !exactFields.includes(key));
+  ensure(unknown.length === 0, `checkpoint 包含未知字段: ${unknown.join(", ")}`);
+  ensure(data.schema_version === 1, "schema_version 必须为 1");
+  ensure(LEVELS.includes(data.intensity), "intensity 必须是 L1、L2 或 L3");
+  ensure(typeof data.classification_reason === "string" && data.classification_reason.trim(), "classification_reason 不能为空");
+  ensure(Array.isArray(data.changed_assets) && data.changed_assets.length > 0 && data.changed_assets.every((item) => typeof item === "string" && item.trim()), "changed_assets 必须包含至少一个路径或资产引用");
+  const minimum = minimumIntensity(data.triggers);
+  ensure(levelRank(data.intensity) >= levelRank(minimum), `${data.triggers.join(", ") || "默认"} 至少要求 ${minimum}，不得声明为 ${data.intensity}`);
+  ensure(typeof data.escalation === "string" && data.escalation.trim(), "escalation 必须说明 none 或升级原因");
+  ensure(Array.isArray(data.verification_evidence), "verification_evidence 必须是数组");
+  const kinds = new Set();
+  for (const evidence of data.verification_evidence) {
+    ensure(evidence && typeof evidence === "object" && !Array.isArray(evidence), "verification_evidence 条目必须是对象");
+    ensure(typeof evidence.kind === "string" && evidence.kind.trim(), "verification_evidence.kind 不能为空");
+    ensure(typeof evidence.command === "string" && evidence.command.trim(), "verification_evidence.command 不能为空");
+    ensure(evidence.result === "pass", `验证证据必须是本轮实际通过结果: ${evidence.kind ?? "unknown"}`);
+    kinds.add(evidence.kind);
+  }
+  for (const required of REQUIRED_EVIDENCE[data.intensity]) ensure(kinds.has(required), `${data.intensity} 缺少 ${required} 证据`);
+  ensure(REVIEW_MODES[data.intensity].has(data.review_mode), `${data.intensity} 不允许 review_mode=${data.review_mode}`);
+  return { intensity: data.intensity, minimum_intensity: minimum };
+}
+
+export function loadMaintenanceCheckpoint(source) {
+  const raw = source === "-" ? readFileSync(0, "utf8") : readFileSync(source, "utf8");
+  const document = parseDocument(raw, { uniqueKeys: true });
+  ensure(document.errors.length === 0, document.errors[0]?.message || "checkpoint 无法解析");
+  return document.toJS({ maxAliasCount: 0 });
+}