create-yss-spec 3.3.1 → 3.3.4

package/template/docs/process/template-engineering-overview.md

@@ -1,104 +0,0 @@
-# YSS 模板工程说明
-
-## 1. 工程定位
-
-YSS 模板工程是一套可版本化的研发治理系统。它用仓库身份、生命周期、条件门禁、工程契约、Agent skills 和可读证据，把产品研发从需求澄清连接到实现、审查、发布与复盘。
-
-本仓默认是研发管理仓库，不是前端或后端运行时工程。它维护可复用的流程规则、文档模板、技能、验证脚本和分发契约；运行时代码默认位于已登记的独立实现仓库。
-
-## 2. 首次进入时读取什么
-
-按以下顺序建立上下文：
-
-1. 读取根目录 `yss-project.yaml`，确认 `repository_mode`。
-2. 读取 `AGENTS.md`，取得当前仓库的入口规则、硬门禁和禁止事项。
-3. 读取 `CONTEXT.md`，统一领域与流程语言。
-4. 按任务读取生命周期注册表、裁剪规则、技能注册表和数字人角色注册表。
-
-完成标准：仓库身份合法，任务属于模板维护还是产品研发已经明确，影响面和下一工作单元可以由权威资产解释。
-
-## 3. 两种仓库身份
-
-| 身份 | 用途 | 允许的主要工作 | 边界 |
-|---|---|---|---|
-| `template-source` | 维护通用模板与治理规则 | 更新单一事实来源、同步技能投影、构建 CLI 快照、验证与审查 | 不生成具体产品的 Spec、原型、OpenAPI 或垂直切片 Ticket |
-| `project-instance` | 承载具体产品或模块的研发管理资产 | 执行 Plan、Spec、设计、工程契约、Ticket、实现、验证和发布流程 | 不反向成为通用模板的权威来源 |
-
-身份只由 `yss-project.yaml` 声明。目录结构、Git remote 和占位符都不能替代该清单。
-
-## 4. Harness 产品线
-
-模板工程按研发责任边界拆成三个互不混用的 Harness 产品：
-
-| 产品线 | 模板源 | 实例化 CLI | 生命周期边界 |
-|---|---|---|---|
-| 全产品生命周期 | `yss-spec-project-template` | `create-yss-spec` | 从 Plan 到发布与复盘 |
-| DDD 战略设计交接 | `yss-harness-design-agent` | `create-yss-harness-design` | 从机会、需求和战略设计到 Strategic Design Handoff |
-| 开发落地 | `yss-harness-dev-agent` | `create-yss-harness-dev` | 从已批准 Spec 或战略设计交接包到 Tactical Design、Slice Contract、实现与验证 |
-
-每条产品线使用独立的 profile、metadata 和固定模板 commit。CLI 之间遇到其他产品线的 metadata 时必须 fail closed，不能自动接管。
-
-## 5. 控制平面
-
-### 5.1 生命周期
-
-`docs/process/lifecycle-registry.yaml` 是阶段、门禁、产物、工作单元、证据和稳定 ID 的结构事实源。`docs/process/harness-process-tailoring.md` 决定任务从哪个可信阶段进入，以及哪些条件门禁可以记录为 `not-applicable`。
-
-生命周期编排器只推进第一个未阻塞工作单元。文件存在不等于产物已批准；完成结论必须同时具备内容、审查结论、上游新鲜度和可读取证据。
-
-### 5.2 技能供应链
-
-`.agents/skills` 是跨 Agent 共享技能的权威内容。`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.pi/skills`、`.qoder/skills` 和 `.trae/skills` 是生成投影。
-
-`docs/agents/yss-skill-registry.yaml` 管理技能分层、成熟度、别名和运行时发现；`skills-lock.json` 管理来源、版本、hash 与投影完整性。修改共享技能后必须同步投影并更新 lock，不能分别编辑平台副本。
-
-### 5.3 数字人协作
-
-`docs/agents/digital-human-roles.yaml` 定义数字人角色、运行时绑定、阶段协作组和会签策略。角色叠加在生命周期编排器上，不形成第二套生命周期；实现者与独立审查者必须是不同实例。
-
-正式派发使用结构化任务包，任务包声明角色、运行时、合同、允许写路径、预期证据和汇合条件。共享工作区不替代写入边界。
-
-## 6. 模板源与实例分发边界
-
-模板实例分发面包含根规则、`CONTEXT.md`、共享 skills、`docs/` 中的实例流程资产和共享验证脚本。CLI 从固定模板 commit 构建 bundled snapshot，并在 metadata 中保存模板身份和版本。
-
-`.template-source/` 是模板源治理区，保存维护证据、研究记录、源仓 ADR、跨仓契约、发布路线和模板源 Wiki。该目录不进入 `project-instance`，避免把模板维护历史误当成产品研发资产。
-
-## 7. 模板维护工作流
-
-1. **分级**：根据 `docs/process/maintenance-intensity.yaml` 计算 L1、L2 或 L3；未知 trigger 先更新策略。
-2. **更新权威资产**：修改对应的单一事实来源，避免在说明文档中复制规则。
-3. **生成投影**：涉及 skills 时同步 Agent roots 和 `skills-lock.json`；涉及生命周期结构时同步派生视图；涉及实例分发时构建固定 commit 的 CLI 快照。
-4. **Fresh verification**：实现内循环执行 `scripts/verify-template-fast` 并默认停在 `implementation-ready`；准备审查时执行 candidate 核验和首次完整 `scripts/verify-template`，跨仓 CLI 还要执行固定 commit 的集成测试和打包校验。
-5. **审查与发布**：L2 按需使用聚焦独立审查；L3 日常记录维护者自检，不冻结候选、不派发正式独立审查。正式发布前仍执行一次完整 `scripts/verify-template`。
-6. **发布与回滚**：先发布或提交子仓，再更新父仓 gitlink；跨仓版本、验证命令、发布顺序和回滚点必须可以重建。
-
-完成标准：当前强度要求的自检 / 审查证据通过，跨仓固定引用闭合，正式发布前完整 `scripts/verify-template` 通过，并且不存在未处理的 `violation`、`drift` 或 `new_impacts`。
-
-## 8. 常用入口
-
-| 目标 | 入口 |
-|---|---|
-| 判断仓库身份和下一阶段 | `yss-product-lifecycle` |
-| 修改或退役共享 skill | `maintaining-skills` |
-| 模板实现内循环 | `scripts/verify-template-fast` |
-| 准备模板审查候选 | `scripts/verify-template-candidate`、`scripts/prepare-maintenance-review` |
-| 校验根模板发布候选 | `scripts/verify-template` |
-| 同步共享 skill 投影 | `scripts/sync-skills` |
-| 校验 skills lock | `scripts/update-skill-lock --check` |
-| 校验生命周期注册表 | `scripts/verify-lifecycle-registry` |
-| 校验维护 checkpoint | `scripts/verify-maintenance-checkpoint <file>` |
-
-## 9. 权威阅读地图
-
-| 问题 | 权威资产 |
-|---|---|
-| 仓库是什么 | `yss-project.yaml`、`AGENTS.md` |
-| 统一语言是什么 | `CONTEXT.md` |
-| 阶段、门禁和工作单元是什么 | `docs/process/lifecycle-registry.yaml` |
-| 如何裁剪流程和判定维护强度 | `docs/process/harness-process-tailoring.md`、`docs/process/maintenance-intensity.yaml` |
-| skills 如何发现与校验 | `docs/agents/yss-skill-registry.yaml`、`skills-lock.json` |
-| 数字人如何协作和会签 | `docs/agents/digital-human-roles.yaml` |
-| 实现仓库如何接入 | `docs/process/implementation-repo-integration.md` |
-
-说明文档负责导航和解释；当说明与权威资产冲突时，以表中权威资产为准，并修复说明文档的漂移。

package/template/docs/process/template-verification-profiles.yaml

@@ -1,365 +0,0 @@
-schema_version: 1
-default_profile: fast
-max_concurrency: 4
-profiles:
-  fast:
-    always_groups: [hygiene]
-  candidate:
-    always_groups: [hygiene, candidate-integrity]
-  release:
-    all_groups: true
-core_escalation_patterns:
-  - scripts/lib/user-decision.mjs
-  - scripts/lib/approval-record.mjs
-  - scripts/lib/lifecycle-transition.mjs
-  - AGENTS.md
-  - yss-project.yaml
-  - docs/process/maintenance-intensity.yaml
-  - docs/process/lifecycle-registry.yaml
-  - scripts/verify-template
-  - scripts/verify-template-fast
-  - scripts/verify-template-candidate
-  - scripts/run-template-verification
-  - scripts/lib/template-verification.mjs
-  - scripts/verify-template-verification-scenarios
-  - docs/process/template-verification-profiles.yaml
-  - scripts/lib/maintenance-intensity.mjs
-  - scripts/verify-maintenance-checkpoint
-  - scripts/verify-maintenance-intensity-scenarios
-  - scripts/lib/maintenance-review-workflow.mjs
-  - scripts/lib/maintenance-review.mjs
-  - scripts/lib/maintenance-candidate.mjs
-  - scripts/lib/template-commit-cache.mjs
-  - scripts/prepare-maintenance-review
-  - scripts/evaluate-maintenance-review-round
-  - scripts/cache-template-commit
-  - scripts/capture-maintenance-candidate
-  - scripts/inspect-maintenance-candidate
-  - .template-source/tooling/node/scripts/design-md.mjs
-required_files:
-  - docs/process/schemas/user-decision.schema.json
-  - docs/process/templates/user-decision-template.yaml
-  - .agents/skills/yss-product-lifecycle/references/user-decisions.md
-  - yss-project.yaml
-  - AGENTS.md
-  - CONTEXT.md
-  - skills-lock.json
-  - .agents/skills/.yss-skills-manifest.json
-  - .agents/skills/.strategic-design-skills-manifest.json
-  - .mcp.json
-  - .agents/mcp_config.json
-  - .cursor/mcp.json
-  - .vscode/mcp.json
-  - docs/agents/yss-skill-registry.yaml
-  - .agents/skills/yss-implementation-contract-compiler/SKILL.md
-  - .agents/skills/yss-implementation-contract-compiler/references/compiler-contract.yaml
-  - .agents/skills/yss-implementation-contract-compiler/references/boundaries.md
-  - .agents/skills/yss-implementation-contract-compiler/references/slice-implementation-contract.md
-  - .agents/skills/yss-implementation-contract-compiler/tests/compiler-scenarios.test.mjs
-  - .agents/skills/yss-skill-source-index-refresh/SKILL.md
-  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs
-  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs
-  - .agents/skills/yss-repository/tests/profile-routing.test.mjs
-  - docs/agents/yss-ui-skills-integration.md
-  - docs/agents/strategic-design-skills-integration.md
-  - docs/user-guide/yss-ui-mcp.md
-  - docs/agents/digital-human-roles.yaml
-  - docs/process/lifecycle-registry.yaml
-  - docs/process/lifecycle-registry-baseline.json
-  - docs/process/template-verification-profiles.yaml
-  - docs/process/maintenance-intensity.yaml
-  - docs/process/schemas/digital-human-task-package.schema.json
-  - docs/process/schemas/maintenance-review-record.schema.json
-  - docs/process/schemas/lifecycle-checkpoint.schema.json
-  - docs/process/schemas/context-reconciliation.schema.json
-  - docs/process/schemas/strategic-design-handoff.schema.json
-  - docs/process/schemas/frontend-implementation-evidence.schema.json
-  - docs/process/schemas/scaffold-architecture-decisions.schema.json
-  - docs/process/schemas/project-scaffold-contract.schema.json
-  - docs/process/schemas/implementation-repository-preparation-result.schema.json
-  - docs/design/schemas/visual-baseline.schema.json
-  - docs/process/schemas/subagent-task-package.schema.json
-  - docs/process/templates/lifecycle-checkpoint-template.yaml
-  - docs/process/templates/context-reconciliation-template.yaml
-  - docs/process/templates/frontend-implementation-plan-template.yaml
-  - docs/process/templates/frontend-implementation-verification-template.yaml
-  - docs/process/templates/scaffold-architecture-decisions-template.yaml
-  - docs/design/templates/visual-baseline-template.yaml
-  - docs/process/templates/maintenance-checkpoint-template.yaml
-  - docs/templates/subagent-task-package-template.md
-  - .agents/skills/yss-technical-design/SKILL.md
-  - .agents/skills/yss-technical-design/references/technical-design.schema.json
-  - .agents/skills/yss-technical-design/scripts/validate-technical-design.mjs
-  - .agents/skills/yss-mvc-design/SKILL.md
-  - .agents/skills/yss-mvc-design/references/mvc-design.schema.json
-  - .agents/skills/yss-tactical-design/SKILL.md
-  - .agents/skills/yss-tactical-design/agents/openai.yaml
-  - .agents/skills/yss-tactical-design/references/tactical-design-contract.md
-  - .agents/skills/yss-tactical-design/references/tactical-design.schema.json
-  - .agents/skills/yss-tactical-design/references/validation-rules.md
-  - .agents/skills/yss-tactical-design/references/output-template.md
-  - .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs
-  - .agents/skills/yss-tactical-design/tests/run-scenarios.mjs
-  - .agents/skills/yss-layered-mvc-scaffold-generator/SKILL.md
-  - .agents/skills/yss-layered-mvc-scaffold-generator/agents/openai.yaml
-  - .agents/skills/yss-layered-mvc-scaffold-generator/references/architecture.md
-  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/generate_scaffold.mjs
-  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/run_scaffold_verification.mjs
-  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/generate_and_verify_scaffold.mjs
-  - .agents/skills/yss-layered-mvc-scaffold-generator/scripts/scaffold-generator.test.mjs
-  - .agents/skills/yss-prototype-stage/references/product-design-adapter.md
-  - .agents/skills/yss-prototype-stage/references/prototype-profile-routing.md
-  - .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs
-  - .agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs
-  - .agents/skills/yss-prototype-stage/tests/run-scenarios.mjs
-  - docs/design/templates/prototype-evidence-template.yaml
-  - scripts/lib/template-verification.mjs
-  - scripts/lib/maintenance-intensity.mjs
-  - scripts/lib/maintenance-candidate.mjs
-  - scripts/lib/task-package.mjs
-  - scripts/run-template-verification
-  - scripts/verify-template-fast
-  - scripts/verify-template-candidate
-  - scripts/verify-template
-  - scripts/verify-business-language-scenarios
-  - scripts/query-lifecycle-context
-  - scripts/lib/lifecycle-context-query.mjs
-  - scripts/verify-lifecycle-context-query-scenarios
-  - scripts/verify-frontend-implementation-evidence-scenarios
-  - scripts/prepare-maintenance-review
-  - scripts/evaluate-maintenance-review-round
-  - scripts/cache-template-commit
-  - scripts/capture-maintenance-candidate
-  - scripts/inspect-maintenance-candidate
-syntax_files:
-  - scripts/lib/user-decision.mjs
-  - scripts/verify-user-decision
-  - scripts/verify-user-decision-scenarios
-  - scripts/sync-skills
-  - scripts/update-skill-lock
-  - scripts/verify-upstream-skill-source
-  - scripts/lib/skill-supply-chain.mjs
-  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.mjs
-  - .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs
-  - .agents/skills/yss-repository/tests/profile-routing.test.mjs
-  - scripts/generate-lifecycle-artifacts
-  - scripts/verify-lifecycle-registry
-  - scripts/verify-lifecycle-checkpoint
-  - scripts/lib/context-contract.mjs
-  - scripts/verify-context-contract
-  - scripts/verify-context-contract-scenarios
-  - scripts/verify-business-language-scenarios
-  - scripts/query-lifecycle-context
-  - scripts/lib/lifecycle-context-query.mjs
-  - scripts/verify-lifecycle-context-query-scenarios
-  - scripts/verify-context-reconciliation
-  - scripts/verify-context-reconciliation-scenarios
-  - scripts/verify-grill-with-docs-context-scenarios
-  - scripts/verify-strategic-context-import
-  - scripts/verify-strategic-context-import-scenarios
-  - scripts/verify-frontend-implementation-evidence
-  - scripts/verify-scaffold-architecture-decisions
-  - scripts/verify-scaffold-architecture-decision-scenarios
-  - scripts/lib/task-package-schema.mjs
-  - scripts/lib/json-schema.mjs
-  - scripts/lib/task-package.mjs
-  - scripts/lib/maintenance-review.mjs
-  - scripts/lib/maintenance-intensity.mjs
-  - scripts/lib/template-verification.mjs
-  - scripts/run-template-verification
-  - scripts/verify-maintenance-checkpoint
-  - scripts/verify-maintenance-review-record
-  - scripts/verify-maintenance-intensity-scenarios
-  - scripts/verify-skill-registry
-  - scripts/lib/implementation-contract-compiler.mjs
-  - scripts/generate-yss-skill-boundaries
-  - scripts/audit-yss-backend-skills
-  - scripts/verify-retired-skill-ids
-  - scripts/verify-skill-governance
-  - scripts/verify-upstream-skill-source
-  - scripts/lib/skill-supply-chain.mjs
-  - scripts/verify-yss-dto-openapi-profile
-  - scripts/verify-yss-dto-openapi-scenarios
-  - scripts/verify-digital-human-roles
-  - scripts/verify-digital-human-roles-scenarios
-  - scripts/verify-approval-record
-  - scripts/lib/lifecycle-transition.mjs
-  - scripts/verify-lifecycle-scenarios
-  - scripts/verify-lifecycle-transition-scenarios
-  - scripts/verify-frontend-scaffold-generator-scenarios
-  - .agents/skills/yss-frontend-scaffold-generator/scripts/generate_scaffold.mjs
-  - .agents/skills/yss-frontend-scaffold-generator/scripts/run_scaffold_verification.mjs
-  - .agents/skills/yss-frontend-scaffold-generator/scripts/generate_and_verify_scaffold.mjs
-  - scripts/verify-matt-yss-integration-scenarios
-  - scripts/verify-prototype-backend-scaffold-scenarios
-  - scripts/verify-yss-implementation-contract-compiler-scenarios
-  - scripts/verify-yss-prototype-contract-scenarios
-  - scripts/verify-openapi-yaml-first-scenarios
-  - scripts/verify-openapi-json-handoff-scenarios
-  - scripts/verify-repository-scope-scenarios
-  - scripts/export-yss-skills
-  - scripts/verify-digital-human-task-package
-  - scripts/verify-digital-human-task-package-scenarios
-  - scripts/verify-subagent-task-package
-  - scripts/verify-subagent-task-package-scenarios
-  - scripts/verify-template-verification-scenarios
-  - scripts/lib/maintenance-review-workflow.mjs
-  - scripts/lib/maintenance-candidate.mjs
-  - scripts/lib/template-commit-cache.mjs
-  - scripts/prepare-maintenance-review
-  - scripts/evaluate-maintenance-review-round
-  - scripts/cache-template-commit
-  - scripts/capture-maintenance-candidate
-  - scripts/inspect-maintenance-candidate
-  - scripts/verify-maintenance-review-workflow-scenarios
-  - scripts/verify-template-cache-scenarios
-routing:
-  - patterns: [".template-source/cli-core/**"]
-    groups: [dedicated-cli-core]
-  - patterns: [".agents/skills/yss-technical-design/**", ".agents/skills/yss-mvc-design/**", ".agents/skills/yss-tactical-design/**", "scripts/lib/technical-design-boundary.mjs", "scripts/lib/strategic-handoff-design-targets.mjs"]
-    groups: [tactical-design, implementation]
-  - patterns: ["scripts/*backend-delivery*", "scripts/*frontend-delivery*", "scripts/lib/*backend-delivery*", "scripts/lib/*frontend-delivery*", "scripts/fixtures/backend-delivery/**", "docs/process/frontend-backend-delivery.md", "docs/process/schemas/backend-delivery*", "docs/process/schemas/frontend-delivery*"]
-    groups: [frontend-delivery]
-  - patterns: ["scripts/*user-decision*", "scripts/lib/user-decision*", "scripts/fixtures/user-decision/**", "docs/process/schemas/user-decision*", "docs/process/templates/user-decision*", "scripts/lib/approval-record.mjs", "scripts/verify-approval-record"]
-    groups: [lifecycle, collaboration]
-  - patterns: ["scripts/*strategic-handoff*", "scripts/lib/strategic-handoff*", "scripts/fixtures/strategic-handoff/**", "docs/process/strategic-handoff-package.md", "docs/process/schemas/strategic-handoff-*"]
-    groups: [strategic-handoff-package]
-  - patterns: [DESIGN.md, "docs/design/**", ".template-source/tooling/node/scripts/design-md.mjs"]
-    groups: [design-system]
-  - patterns: [AGENTS.md, CONTEXT.md, yss-project.yaml, package.json, .gitignore, README.md, "docs/**"]
-    groups: [hygiene]
-  - patterns: [AGENTS.md, yss-project.yaml, "docs/process/template-engineering-overview.md"]
-    groups: [governance-release]
-  - patterns: [skills-lock.json, ".agents/skills/**", ".claude/skills/**", ".codex/skills/**", ".cursor/skills/**", ".pi/skills/**", ".qoder/skills/**", ".trae/skills/**", "docs/agents/yss-skill-registry.yaml", "docs/agents/skills-maintenance.md", "scripts/*skill*"]
-    groups: [skills]
-  - patterns: [.mcp.json, .agents/mcp_config.json, .cursor/mcp.json, .vscode/mcp.json, docs/user-guide/yss-ui-mcp.md, docs/agents/yss-ui-skills-integration.md]
-    groups: [skills]
-  - patterns: [.agents/skills/.strategic-design-skills-manifest.json, docs/agents/strategic-design-skills-integration.md, submodules/yss-harness-design-agent/**]
-    groups: [skills]
-  - patterns: ["docs/process/maintenance-*", "docs/process/harness-process-tailoring.md", "docs/process/schemas/maintenance-*", "scripts/*maintenance*", "scripts/lib/maintenance-*"]
-    groups: [maintenance]
-  - patterns: ["docs/process/lifecycle-*", "docs/process/templates/lifecycle-*", "scripts/*lifecycle*", "scripts/lib/lifecycle-*"]
-    groups: [lifecycle]
-  - patterns: ["docs/agents/digital-human-*", "docs/process/schemas/*task-package*", "docs/templates/subagent-task-package-template.md", "scripts/*task-package*", "scripts/*digital-human*", "scripts/lib/task-package*"]
-    groups: [collaboration]
-  - patterns: [".agents/skills/code-review/**", ".agents/skills/maintaining-skills/**"]
-    groups: [maintenance, collaboration]
-  - patterns: ["docs/templates/openapi-*", ".agents/skills/yss-openapi-*/**", ".agents/skills/yss-dto/**", "scripts/*openapi*", "scripts/*dto*"]
-    groups: [contracts]
-  - patterns: ["docs/process/implementation-*", "scripts/*repository*", "scripts/*implementation*", "scripts/*scaffold*", "scripts/*prototype*"]
-    groups: [implementation]
-  - patterns: [".template-source/**", "scripts/vendor/**"]
-    groups: [tooling]
-  - patterns: [".github/**"]
-    groups: [candidate-integrity]
-  - patterns: ["submodules/**"]
-    groups: [implementation]
-  - patterns: ["scripts/**"]
-    groups: [hygiene]
-groups:
-  dedicated-cli-core:
-    commands:
-      - { run: "node --test .template-source/cli-core/tests/*.test.mjs", when: template-source }
-  frontend-delivery:
-    commands:
-      - { run: "scripts/verify-frontend-delivery-scenarios" }
-      - { run: "node .template-source/scripts/verify-delivery-harness-distribution.mjs", when: template-source }
-  strategic-handoff-package:
-    commands:
-      - { run: "node --check scripts/lib/strategic-handoff.mjs" }
-      - { run: "scripts/verify-strategic-handoff-package-scenarios" }
-  design-system:
-    commands:
-      - { run: "node .template-source/tooling/node/scripts/design-md.mjs lint DESIGN.md", when: template-source }
-      - { run: "node .template-source/tooling/node/scripts/design-md.mjs drift", when: template-source }
-  hygiene:
-    commands: []
-  tooling:
-    commands:
-      - { run: ".template-source/scripts/evidence-index --check", when: template-source }
-      - { run: "pnpm --dir .template-source/tooling/node test", when: template-source }
-      - { run: "pnpm --dir .template-source/tooling/node check:vendor", when: template-source }
-  skills:
-    commands:
-      - { run: "scripts/sync-skills --check" }
-      - { run: "scripts/update-skill-lock --check" }
-      - { run: "scripts/verify-skill-registry" }
-      - { run: "scripts/verify-skill-governance" }
-      - { run: "scripts/verify-upstream-skill-source --source=iloveZzz/yss-harness-design-agent --source-root=submodules/yss-harness-design-agent", when: template-source }
-      - { run: "node .agents/skills/yss-antdv-next-design/tests/run-scenarios.mjs" }
-      - { run: "node --test .agents/skills/yss-skill-source-index-refresh/scripts/refresh-yss-skill-index.test.mjs" }
-      - { run: "node --test .agents/skills/yss-repository/tests/profile-routing.test.mjs" }
-  tactical-design:
-    commands:
-      - { run: "node .agents/skills/yss-technical-design/scripts/generate-schema.mjs --check" }
-      - { run: "node .agents/skills/yss-technical-design/tests/run-scenarios.mjs" }
-      - { run: "node --check .agents/skills/yss-tactical-design/scripts/validate-tactical-design.mjs" }
-      - { run: "node --check .agents/skills/yss-tactical-design/tests/run-scenarios.mjs" }
-      - { run: "node .agents/skills/yss-tactical-design/tests/run-scenarios.mjs" }
-  contracts:
-    commands:
-      - { run: "scripts/verify-yss-dto-openapi-profile" }
-      - { run: "scripts/verify-yss-dto-openapi-scenarios" }
-      - { run: "scripts/verify-openapi-yaml-first-scenarios" }
-      - { run: "scripts/verify-openapi-json-handoff-scenarios" }
-  collaboration:
-    commands:
-      - { run: "scripts/verify-digital-human-roles" }
-      - { run: "scripts/verify-digital-human-roles-scenarios" }
-      - { run: "scripts/verify-approval-record --history docs/templates/approval-record-template.yaml" }
-      - { run: "scripts/verify-subagent-task-package-scenarios" }
-      - { run: "scripts/verify-digital-human-task-package-scenarios" }
-      - { run: "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/digital-human-task-package-review-task.yaml", when: template-source }
-      - { run: "scripts/verify-digital-human-task-package .template-source/evidence/maintenance/lifecycle-ticket-transition-review-task-package.yaml", when: template-source }
-  lifecycle:
-    commands:
-      - { run: "scripts/verify-user-decision-scenarios" }
-      - { run: "scripts/verify-context-contract --root . --json" }
-      - { run: "scripts/verify-context-contract-scenarios" }
-      - { run: "node scripts/verify-business-language-scenarios" }
-      - { run: "scripts/verify-context-reconciliation-scenarios" }
-      - { run: "node scripts/verify-script-performance-scenarios" }
-      - { run: "scripts/verify-grill-with-docs-context-scenarios" }
-      - { run: "scripts/verify-strategic-context-import-scenarios" }
-      - { run: "scripts/verify-lifecycle-registry" }
-      - { run: "scripts/verify-lifecycle-context-query-scenarios" }
-      - { run: "scripts/verify-lifecycle-checkpoint docs/process/templates/lifecycle-checkpoint-template.yaml" }
-      - { run: "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-plan-template.yaml" }
-      - { run: "scripts/verify-frontend-implementation-evidence --allow-template docs/process/templates/frontend-implementation-verification-template.yaml" }
-      - { run: "scripts/verify-frontend-implementation-evidence-scenarios" }
-      - { run: "scripts/verify-scaffold-architecture-decisions --allow-template docs/process/templates/scaffold-architecture-decisions-template.yaml" }
-      - { run: "scripts/verify-scaffold-architecture-decision-scenarios" }
-      - { run: "scripts/verify-lifecycle-scenarios" }
-      - { run: "scripts/verify-lifecycle-transition-scenarios" }
-      - { run: "node scripts/verify-plan-spec-entry-scenarios" }
-      - { run: "scripts/verify-frontend-scaffold-generator-scenarios" }
-  maintenance:
-    commands:
-      - { run: "scripts/verify-maintenance-checkpoint .template-source/evidence/maintenance/yss-tactical-design-l3-checkpoint-2026-08-27.yaml", when: template-source }
-      - { run: "scripts/verify-maintenance-intensity-scenarios" }
-      - { run: "node scripts/verify-maintenance-review-workflow-scenarios" }
-  implementation:
-    commands:
-      - { run: "scripts/verify-implementation-path-scenarios" }
-      - { run: "scripts/verify-repository-scope-scenarios" }
-      - { run: "scripts/verify-scaffold-generator-scenarios" }
-      - { run: "node --test .agents/skills/yss-ddd-scaffold-generator/scripts/scaffold-generator.test.mjs" }
-      - { run: "node --test .agents/skills/yss-layered-mvc-scaffold-generator/scripts/scaffold-generator.test.mjs" }
-      - { run: "scripts/verify-frontend-scaffold-generator-scenarios" }
-      - { run: "scripts/verify-prototype-backend-scaffold-scenarios" }
-      - { run: "scripts/verify-matt-yss-integration-scenarios" }
-      - { run: "scripts/verify-yss-implementation-contract-compiler-scenarios" }
-      - { run: "scripts/generate-yss-skill-boundaries --check" }
-      - { run: "scripts/audit-yss-backend-skills --check" }
-      - { run: "scripts/verify-retired-skill-ids" }
-      - { run: "scripts/verify-yss-ui-scenarios" }
-      - { run: "scripts/verify-yss-prototype-contract-scenarios" }
-      - { run: "node .agents/skills/yss-prototype-stage/scripts/prototype-contract.mjs validate-evidence docs/design/templates/prototype-evidence-template.yaml --allow-template" }
-      - { run: "node .agents/skills/yss-prototype-stage/scripts/visual-baseline-contract.mjs validate docs/design/templates/visual-baseline-template.yaml --allow-template" }
-  governance-release:
-    commands:
-      - { run: "scripts/verify-governance-release" }
-  candidate-integrity:
-    commands:
-      - { run: "node scripts/verify-template-verification-scenarios" }
-      - { run: "node scripts/verify-template-cache-scenarios" }

package/template/docs/process/templates/maintenance-checkpoint-template.yaml

@@ -1,19 +0,0 @@
-schema_version: 2
-intensity: L3
-classification_reason: <分级理由>
-triggers: [core-validator]
-changed_assets: [<路径或资产引用>]
-verification_evidence:
-  - kind: self-check
-    command: <维护者自检命令或证据>
-    result: pass
-  - kind: fresh-verification
-    command: scripts/verify-template-fast
-    result: pass
-review_mode: self-check
-escalation: none
-target_state: implementation-ready
-current_state: implementation-ready
-verification_profile: fast
-review_round: 0
-candidate_digest: null

package/template/scripts/audit-yss-backend-skills

@@ -1,56 +0,0 @@
-#!/usr/bin/env node
-import { existsSync } from "node:fs";
-import path from "node:path";
-import { loadSkillRegistry } from "./lib/skill-registry.mjs";
-import { OBSOLETE, ROOT } from "./lib/skill-supply-chain.mjs";
-
-const checkOnly = process.argv.includes("--check");
-const registry = loadSkillRegistry();
-const capabilityBySkill = new Map();
-for (const capability of registry.capabilities) {
-  if (!capabilityBySkill.has(capability.primary_skill)) capabilityBySkill.set(capability.primary_skill, []);
-  capabilityBySkill.get(capability.primary_skill).push(capability.id);
-}
-const inbound = new Map();
-for (const [owner, dependencies] of Object.entries(registry.skill_dependencies)) {
-  for (const dependency of dependencies) {
-    if (!inbound.has(dependency.skill)) inbound.set(dependency.skill, []);
-    inbound.get(dependency.skill).push({ owner, type: dependency.type, ...(dependency.when ? { when: dependency.when } : {}) });
-  }
-}
-const recipeCallers = new Map();
-for (const recipe of registry.recipes) for (const capability of recipe.capabilities) {
-  const skill = registry.capabilities.find((item) => item.id === capability)?.primary_skill;
-  if (!skill) continue;
-  if (!recipeCallers.has(skill)) recipeCallers.set(skill, []);
-  recipeCallers.get(skill).push(recipe.id);
-}
-
-const candidates = registry.skills
-  .filter((skill) => skill.impacts.includes("backend") || capabilityBySkill.has(skill.id))
-  .map((skill) => {
-    const capabilities = capabilityBySkill.get(skill.id) ?? [];
-    const callers = [...new Set(recipeCallers.get(skill.id) ?? [])].sort();
-    const dependencies = inbound.get(skill.id) ?? [];
-    const canonicalExists = existsSync(path.join(ROOT, ".agents/skills", skill.id, "SKILL.md"));
-    let classification = "keep";
-    let rationale = "unique capability or active typed caller exists";
-    if (OBSOLETE.has(skill.id)) {
-      classification = "remove";
-      rationale = "explicitly obsolete";
-    } else if (!capabilities.length && !callers.length && !dependencies.length) {
-      classification = "narrow";
-      rationale = "backend impact is declared but no capability, recipe, or typed dependency consumes it";
-    }
-    return { skill: skill.id, classification, canonical_exists: canonicalExists, capabilities, recipe_callers: callers, dependency_callers: dependencies, rationale };
-  })
-  .sort((left, right) => left.skill.localeCompare(right.skill));
-
-const blocking = candidates.filter((item) => item.classification === "remove" && item.canonical_exists);
-if (checkOnly) {
-  const counts = Object.fromEntries(["keep", "narrow", "merge", "remove"].map((classification) => [classification, candidates.filter((item) => item.classification === classification).length]));
-  process.stdout.write(`backend skill audit passed: ${candidates.length} candidates (${Object.entries(counts).map(([key, value]) => `${key}=${value}`).join(", ")})\n`);
-} else {
-  process.stdout.write(`${JSON.stringify({ schema_version: 1, generated_from: "docs/agents/yss-skill-registry.yaml", candidates }, null, 2)}\n`);
-}
-if (blocking.length) process.exitCode = 1;

package/template/scripts/cache-template-commit

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-import { parseArgs } from "node:util";
-import { acquireTemplateCommit } from "./lib/template-commit-cache.mjs";
-
-try {
-  const { values } = parseArgs({ options: { repository: { type: "string" }, commit: { type: "string" }, "cache-root": { type: "string" }, "timeout-ms": { type: "string" } }, strict: true });
-  if (!values.repository || !values.commit) throw new TypeError("用法: scripts/cache-template-commit --repository <remote-url> --commit <40位commit> [--cache-root <path>]");
-  const result = acquireTemplateCommit({ repository: values.repository, commit: values.commit, cacheRoot: values["cache-root"], timeoutMs: Number(values["timeout-ms"] || 0) });
-  process.stdout.write(`${JSON.stringify(result)}\n`);
-} catch (error) {
-  process.stderr.write(`模板 commit 缓存失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/capture-maintenance-candidate

@@ -1,14 +0,0 @@
-#!/usr/bin/env node
-import { parseArgs } from "node:util";
-import { captureMaintenanceCandidate } from "./lib/maintenance-candidate.mjs";
-import { ROOT } from "./lib/template-verification.mjs";
-
-try {
-  const { values } = parseArgs({ options: { output: { type: "string" }, base: { type: "string", default: "HEAD" }, exclude: { type: "string", multiple: true } }, strict: true });
-  if (!values.output) throw new TypeError("用法: scripts/capture-maintenance-candidate --output <仓库相对目录> [--base <ref>]");
-  const result = captureMaintenanceCandidate({ root: ROOT, outputDir: values.output, baseRef: values.base, excludePaths: values.exclude || [] });
-  process.stdout.write(`${JSON.stringify({ candidate_digest: result.candidate_digest, manifest_ref: result.manifest_ref, files: result.files }, null, 2)}\n`);
-} catch (error) {
-  process.stderr.write(`维护候选捕获失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/evaluate-maintenance-review-round

@@ -1,37 +0,0 @@
-#!/usr/bin/env node
-import { readFileSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { parseDocument, stringify } from "./vendor/yaml.mjs";
-import { evaluateMaintenanceReviewRound } from "./lib/maintenance-review-workflow.mjs";
-import { loadMaintenanceCheckpoint, validateMaintenanceCheckpoint } from "./lib/maintenance-intensity.mjs";
-import { ROOT } from "./lib/template-verification.mjs";
-
-function load(ref) {
-  const document = parseDocument(readFileSync(path.resolve(ROOT, ref), "utf8"), { uniqueKeys: true });
-  if (document.errors.length > 0) throw document.errors[0];
-  return document.toJS({ maxAliasCount: 0 });
-}
-
-try {
-  const { values, positionals } = parseArgs({ options: { checkpoint: { type: "string" }, output: { type: "string" } }, allowPositionals: true, strict: true });
-  if (positionals.length !== 1) throw new TypeError("用法: scripts/evaluate-maintenance-review-round [--checkpoint <input> --output <new-checkpoint>] <review-summary.yaml>");
-  const result = evaluateMaintenanceReviewRound(load(positionals[0]));
-  if (values.checkpoint || values.output) {
-    if (!values.checkpoint || !values.output) throw new TypeError("--checkpoint 与 --output 必须同时提供");
-    const checkpoint = loadMaintenanceCheckpoint(path.resolve(ROOT, values.checkpoint));
-    if (checkpoint.schema_version !== 2) throw new TypeError("只能更新 schema v2 checkpoint");
-    if (checkpoint.candidate_digest !== result.candidate_digest || checkpoint.review_round !== result.review_round) throw new TypeError("review summary 与 checkpoint 身份不一致");
-    const next = { ...checkpoint, current_state: result.current_state };
-    if (result.current_state === "needs-human") next.target_state = "release-ready";
-    validateMaintenanceCheckpoint(next);
-    const outputPath = path.resolve(ROOT, values.output);
-    if (outputPath === path.resolve(ROOT, values.checkpoint)) throw new TypeError("output 必须是新 checkpoint，禁止覆盖输入");
-    if (path.relative(ROOT, outputPath).startsWith("..")) throw new TypeError("output 不得越出仓库");
-    writeFileSync(outputPath, stringify(next, { lineWidth: 0 }));
-  }
-  process.stdout.write(`${JSON.stringify(result, null, 2)}\n`);
-} catch (error) {
-  process.stderr.write(`维护审查轮次裁决失败: ${error.message}\n`);
-  process.exitCode = 1;
-}

package/template/scripts/export-yss-skills

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import { exportSkills } from "./lib/export-skills.mjs";
-try { process.stdout.write(`${exportSkills()}\n`); } catch (error) { process.stderr.write(`${error.message}\n`); process.exitCode = 1; }

package/template/scripts/fixtures/backend-delivery/revision-server.mjs

@@ -1,11 +0,0 @@
-// Synthetic maintenance service. Never used as evidence of product API readiness.
-import { createServer } from 'node:http';
-import { readFileSync } from 'node:fs';
-const server=createServer((request,response)=>{
-  if(request.method!=='GET'||request.url!=='/version') {response.writeHead(404);response.end();return;}
-  const state=JSON.parse(readFileSync(process.argv[2],'utf8'));
-  response.writeHead(state.status||200,{'content-type':'application/json'});
-  response.end(JSON.stringify(state.body));
-});
-server.listen(0,'127.0.0.1',()=>process.send({port:server.address().port}));
-process.on('disconnect',()=>server.close(()=>process.exit(0)));

package/template/scripts/fixtures/maintenance-review/maintenance-focused-review-approved.md

@@ -1,5 +0,0 @@
-# 模板维护聚焦独立审查
-
-审查者：`reviewer.focused`
-
-审查结论：`pass`。候选满足 L2 聚焦独立审查要求。