create-yss-spec 2.1.11 → 2.1.13

package/template/wiki/.wiki-manifest.json

@@ -0,0 +1,390 @@
+{
+  "schemaVersion": 1,
+  "wikiRoot": "wiki",
+  "compiledAt": "2026-08-23T09:28:35.779Z",
+  "gitCommit": "4195fb4f4e5b1f8cf2fada485ed890526d469385",
+  "profile": "documents",
+  "sources": [
+    {
+      "id": "AGENTS.md",
+      "kind": "document",
+      "livePath": "AGENTS.md",
+      "rawPath": "raw/AGENTS.md",
+      "role": "copy",
+      "sha256": "8b4616521833aae117e46a1ad07aa0fadbee180e95708d239062a67f31acc33d"
+    },
+    {
+      "id": "CONTEXT.md",
+      "kind": "document",
+      "livePath": "CONTEXT.md",
+      "rawPath": "raw/CONTEXT.md",
+      "role": "copy",
+      "sha256": "4e8cf91a8d051edcce45867edc38e2d6d68d2e94577d069d8307ebc58d05a211"
+    },
+    {
+      "id": "README.md",
+      "kind": "document",
+      "livePath": "README.md",
+      "rawPath": "raw/README.md",
+      "role": "copy",
+      "sha256": "2a8e25ac4dc7798e2b7d1609644990518ece925aecff375160036eb8be611446"
+    },
+    {
+      "id": "yss-project.yaml",
+      "kind": "document",
+      "livePath": "yss-project.yaml",
+      "rawPath": "raw/yss-project.yaml",
+      "role": "copy",
+      "sha256": "dae2ddacbb024ba25b70a18830fc26ab7d3dcd8aaa361cc8b3767d68307f98af"
+    },
+    {
+      "id": "lifecycle-registry.yaml",
+      "kind": "document",
+      "livePath": "docs/process/lifecycle-registry.yaml",
+      "rawPath": "raw/lifecycle-registry.yaml",
+      "role": "copy",
+      "sha256": "051a51ea7e5ef3c6fecb5cb43137c5cdd157c646f468614022134e51a5bc5b06"
+    },
+    {
+      "id": "harness-process-tailoring.md",
+      "kind": "document",
+      "livePath": "docs/process/harness-process-tailoring.md",
+      "rawPath": "raw/harness-process-tailoring.md",
+      "role": "copy",
+      "sha256": "f11bb61f3034560c1607891654b0fb0b79dc82f8fb520f746585e5decf9bf41f"
+    },
+    {
+      "id": "maintenance-intensity.yaml",
+      "kind": "document",
+      "livePath": "docs/process/maintenance-intensity.yaml",
+      "rawPath": "raw/maintenance-intensity.yaml",
+      "role": "copy",
+      "sha256": "6338e218860416a2a2ca9c187b5589bc1140b967dbac5f3ecea906adfb588a0f"
+    },
+    {
+      "id": "implementation-repo-integration.md",
+      "kind": "document",
+      "livePath": "docs/process/implementation-repo-integration.md",
+      "rawPath": "raw/implementation-repo-integration.md",
+      "role": "copy",
+      "sha256": "7cd8106029c53773f9ee3e83bcd2d48d6575dbf83d511b0f7d93eeb56538e4e8"
+    },
+    {
+      "id": "skills-maintenance.md",
+      "kind": "document",
+      "livePath": "docs/agents/skills-maintenance.md",
+      "rawPath": "raw/skills-maintenance.md",
+      "role": "copy",
+      "sha256": "9c95176cc104224b515da9b3ad189d4fc6ea917f31877e60083f1416f342f378"
+    },
+    {
+      "id": "yss-skill-registry.yaml",
+      "kind": "document",
+      "livePath": "docs/agents/yss-skill-registry.yaml",
+      "rawPath": "raw/yss-skill-registry.yaml",
+      "role": "copy",
+      "sha256": "5859cc6ef663fb4939caab03083d4036ac5936886c9e4be7a99701d5d035047d"
+    },
+    {
+      "id": "issue-tracker.md",
+      "kind": "document",
+      "livePath": "docs/agents/issue-tracker.md",
+      "rawPath": "raw/issue-tracker.md",
+      "role": "copy",
+      "sha256": "260db9b67b39f8cba50fc1de7a7ae12abb9d246f3a4b85c0122a71f9fcf431f9"
+    },
+    {
+      "id": "triage-labels.md",
+      "kind": "document",
+      "livePath": "docs/agents/triage-labels.md",
+      "rawPath": "raw/triage-labels.md",
+      "role": "copy",
+      "sha256": "5877760bdbb9151a93736247c2dec77d67e969dd1a1b771acf5ff6dc590e5261"
+    },
+    {
+      "id": "adr-0002",
+      "kind": "document",
+      "livePath": "docs/adr/0002-yss-project-repository-mode.md",
+      "rawPath": "raw/adr-0002-repository-mode.md",
+      "role": "copy",
+      "sha256": "11d2a2b384491b4409e5a2c9b18f30d0566b6c80e1e270ef3c224d72fd264583"
+    },
+    {
+      "id": "create-yss-spec-repository-mode-contract",
+      "kind": "document",
+      "livePath": ".template-source/contracts/create-yss-spec-repository-mode-contract.md",
+      "rawPath": "raw/create-yss-spec-repository-mode-contract.md",
+      "role": "copy",
+      "sha256": "11abf661e07ae297995f4bc5fbbadff6df33ee66a8990df5ce5ea21e530c615a"
+    },
+    {
+      "id": "spec-template.md",
+      "kind": "document",
+      "livePath": "docs/templates/spec-template.md",
+      "rawPath": "raw/spec-template.md",
+      "role": "copy",
+      "sha256": "296bffe6cddbd03c6b7e513e777a176cce5688e1d2e36ce1b63d4f810fe3877d"
+    },
+    {
+      "id": "vertical-slice-ticket-template.md",
+      "kind": "document",
+      "livePath": "docs/templates/vertical-slice-ticket-template.md",
+      "rawPath": "raw/vertical-slice-ticket-template.md",
+      "role": "copy",
+      "sha256": "d0e47649cf2fad5fe63d0c37a878d7ada30d1c6c4b12b6b59d036f49f369dcf3"
+    },
+    {
+      "id": "skills-lock.json",
+      "kind": "derived",
+      "livePath": "skills-lock.json",
+      "rawPath": "raw/skills-lock-names.md",
+      "role": "extract",
+      "extract": {
+        "kind": "skill-names"
+      },
+      "sha256": "df9bd8e96f575bee59d186a9d248ee5d969552cb949bafbe25ce0452e89e7a46"
+    }
+  ],
+  "articles": [
+    {
+      "id": "模板总览",
+      "file": "wiki/模板总览.md",
+      "sourceIds": [
+        "README.md",
+        "AGENTS.md",
+        "CONTEXT.md",
+        "yss-project.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "仓库身份与路由",
+      "file": "wiki/仓库身份与路由.md",
+      "sourceIds": [
+        "yss-project.yaml",
+        "adr-0002",
+        "AGENTS.md",
+        "create-yss-spec-repository-mode-contract"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Agent入口规则",
+      "file": "wiki/Agent入口规则.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "产品研发生命周期",
+      "file": "wiki/产品研发生命周期.md",
+      "sourceIds": [
+        "lifecycle-registry.yaml",
+        "AGENTS.md",
+        "harness-process-tailoring.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "条件强制门禁",
+      "file": "wiki/条件强制门禁.md",
+      "sourceIds": [
+        "lifecycle-registry.yaml",
+        "harness-process-tailoring.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "影响面分诊与流程裁剪",
+      "file": "wiki/影响面分诊与流程裁剪.md",
+      "sourceIds": [
+        "harness-process-tailoring.md",
+        "lifecycle-registry.yaml",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "模板维护流程",
+      "file": "wiki/模板维护流程.md",
+      "sourceIds": [
+        "harness-process-tailoring.md",
+        "maintenance-intensity.yaml",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Spec基线",
+      "file": "wiki/Spec基线.md",
+      "sourceIds": [
+        "spec-template.md",
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "SpecDelta",
+      "file": "wiki/SpecDelta.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "OpenAPI契约",
+      "file": "wiki/OpenAPI契约.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "产品设计影响与原型",
+      "file": "wiki/产品设计影响与原型.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "垂直切片Ticket",
+      "file": "wiki/垂直切片Ticket.md",
+      "sourceIds": [
+        "vertical-slice-ticket-template.md",
+        "CONTEXT.md",
+        "AGENTS.md",
+        "issue-tracker.md",
+        "triage-labels.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "切片实现合同",
+      "file": "wiki/切片实现合同.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "AGENTS.md",
+        "lifecycle-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "YSS路由与合同编译",
+      "file": "wiki/YSS路由与合同编译.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "YSS工程技能体系",
+      "file": "wiki/YSS工程技能体系.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "skills-maintenance.md",
+        "yss-skill-registry.yaml",
+        "skills-lock.json"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Matt技能体系",
+      "file": "wiki/Matt技能体系.md",
+      "sourceIds": [
+        "CONTEXT.md",
+        "skills-maintenance.md",
+        "AGENTS.md",
+        "skills-lock.json"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "技能投影与锁定",
+      "file": "wiki/技能投影与锁定.md",
+      "sourceIds": [
+        "skills-maintenance.md",
+        "skills-lock.json",
+        "AGENTS.md",
+        "yss-skill-registry.yaml"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "实现仓库与跨仓库契约",
+      "file": "wiki/实现仓库与跨仓库契约.md",
+      "sourceIds": [
+        "implementation-repo-integration.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "LLM Wiki",
+      "file": "wiki/LLM Wiki.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "CONTEXT.md",
+        "yss-skill-registry.yaml",
+        "skills-maintenance.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Ticket与流程状态",
+      "file": "wiki/Ticket与流程状态.md",
+      "sourceIds": [
+        "issue-tracker.md",
+        "triage-labels.md",
+        "CONTEXT.md",
+        "AGENTS.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "Fresh验证与独立审查",
+      "file": "wiki/Fresh验证与独立审查.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "harness-process-tailoring.md",
+        "maintenance-intensity.yaml",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "模板发布门禁与验证",
+      "file": "wiki/模板发布门禁与验证.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "README.md",
+        "skills-maintenance.md",
+        "harness-process-tailoring.md"
+      ],
+      "humanOwned": false
+    },
+    {
+      "id": "复盘与权威资产修订",
+      "file": "wiki/复盘与权威资产修订.md",
+      "sourceIds": [
+        "AGENTS.md",
+        "lifecycle-registry.yaml",
+        "CONTEXT.md"
+      ],
+      "humanOwned": false
+    }
+  ]
+}

package/template/wiki/raw/AGENTS.md

@@ -18,12 +18,13 @@
 | ----------------------- | ------------------------------------------- |
 | 领域与流程词汇                 | `CONTEXT.md`                                |
 | Agent 入口、硬门禁、禁止事项       | `AGENTS.md`                                 |
-| 主阶段、门禁、产物和退出标准          | `docs/process/lifecycle-artifact-map.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`                          |
-|                         |                                             |
+| 技能分层、别名、默认可发现性和运行时入口 | `docs/agents/yss-skill-registry.yaml`（当前 `status: shadow`，不作为 Router / 生命周期运行时入口） |
 
-README、用户指南和其他说明文档只引用或解释上述事实，不重复定义同一规则。
+README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或解释上述事实，不重复定义同一规则。`CLAUDE.md` 是 Claude Code 入口指针，不是第二套 Agent 规则。
 
 ## 3. 标准文档语言与规范语汇
 
@@ -32,68 +33,44 @@ 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 思路，保留基线失败、压力场景和修订后验证证据。
-- `.agents/skills` 是跨 Agent 共享技能的权威内容；`.claude/skills`、`.codex/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的共享技能是生成投影，禁止分别手工修改。
+- 创建、修改或退役 skill 时使用 `maintaining-skills`，并先按 `docs/process/harness-process-tailoring.md` 判定 L1 / L2 / L3；只有 L3 必须保留完整基线失败、压力场景、修订后验证和正式独立审查证据。
+- `.agents/skills` 是跨 Agent 共享技能的权威内容；`.claude/skills`、`.codex/skills`、`.cursor/skills`、`.hermes/skills`、`.pi/skills`、`.qoder/skills`、`.trae/skills` 中的共享技能是生成投影，禁止分别手工修改。Cursor 的契约运行时入口是 `.cursor/skills`；不得把 canonical `.agents/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` 执行命中的工作单元和条件门禁。
 
-执行原则：
-
-- 21 个门禁全部是条件强制门禁。命中触发条件时必须完成；未命中时只记录 `not-applicable` 及原因，不生成空文档。
-- 新功能或较大变更先用 `grill-with-docs` 澄清，再用 `to-spec` 形成 Spec。
-- 只要进入 Spec 基线，必须产出产品总体设计或功能架构；只有 UI 变化触及主流程、导航、权限体验、异常 / 恢复状态、状态流转或 API 反推时，才构成产品设计影响并强制低保真页面草图、状态矩阵、Ant Design v6 高保真 HTML 原型和用户确认。文案、token、颜色、间距和无行为变化的孤立视觉修复记录 `not-applicable`。
+- 生命周期注册表中的条件门禁全部按影响面强制。命中触发条件时必须完成；未命中时只记录 `not-applicable` 及原因，不生成空文档；不得把产物、工作单元或证据统称为门禁。
+- 安全 / 权限不设独立生命周期资料或专属门禁。日常功能不做额外登记、`not-applicable` 或推导校验；只有需求或冻结资产明确要求改变认证、授权、租户隔离、敏感数据或合规行为时，才把该行为写入普通 Spec、API、架构、验收和测试 seam，并仅按实际 UI、API、Backend、Data、High-risk 影响触发既有门禁。普通 action 注册、沿用既有认证中间件、未变化的 `401` / `403`、一般字段、SQL / DDL / 迁移和上传 / 下载本身不构成安全 / 权限专项。
+- `seam-deferred` 只能显式记录风险、责任人、后续 Ticket、验证计划和目标版本或发布日期。
+- 新功能或较大变更先进入 `yss-product-lifecycle` 的原生 Discovery / 需求分析工作单元；`grill-with-docs` 与 `to-spec` 仅作为用户显式兼容入口，Spec 基线和产品设计影响的完整判定以注册表和裁剪规则为准。
 - API 契约变更先形成 OpenAPI 3.1 Draft，经必要的工程基线、系统 / 数据架构和设计审查后 Freeze，再进入实现。
 - Spec Delta 只记录相对既有冻结 Spec 基线的高风险行为差异；全新产品、全新模块和低风险调整不生成 Spec Delta。
-- OpenAPI Freeze 或无 API 影响记录完成后，使用 `to-tickets` 拆成可独立验证的窄垂直切片，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分。
+- OpenAPI Freeze 或无 API 影响记录完成后，由生命周期原生 Ticket 正式化工作单元拆成可独立验证的窄垂直切片；用户显式 `to-tickets` 仅作为兼容入口，禁止只按 Adapter / Application / Domain / Infrastructure 横向拆分。
 
 ## 6. Ticket 与状态
 
 - 每个功能先建立功能父 Ticket，用于汇总 Spec、设计、审查、OpenAPI Freeze、阻塞项和阶段证据。
 - Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`。
 - 只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket，才能使用 `ready-for-agent`。
-- Ticket、Spec 和阶段证据必须按用户选择或当前主远程路由到 GitHub / GitLab；平台不可用时生成本地待发布草案，不自动改投其他平台。
-
-平台规则和五态标签见 `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. 使用 `yss-router` 选择最小 YSS skill 集合。后端领域、Application、Repository / Gateway、Web / DTO 分别路由到对应 YSS skill；涉及 POJO 样板或对象转换时必须加载 `lombok`、`mapstruct` 和 `alibaba-java-code-style`。
-4. 所有正式垂直切片必须先由 `yss-router` 编译 Slice Implementation Contract 草案，再由生命周期编排器核验并持久化；合同至少包含 Common、Frontend、Backend、Contract、Cross-repo 子合同、工作单元、TDD 模式、允许写路径、禁止模式、证据和验证命令。Router 不得自行批准合同或设置 `ready-for-agent`。
-5. 后端切片必须在统一合同中补齐 Backend Slice Implementation Contract，至少包含 `required_skills`、`allowed_write_paths`、`forbidden_patterns`、`expected_evidence_files`、`seam_deferred`、`verification_commands`。
-6. 把系统 / 数据架构、ADR、工程基线、OpenAPI Freeze 和风险 / 回滚约束转译为 Build Architecture Checklist。
-7. 核心 YSS skills 必须消费批准合同并返回 YSS Skill Execution Result；路径越界、证据缺失、未执行验证、`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 为准。
+- 前端测试、type-check 与构建优先使用 `pnpm`；后端校验、测试与编译优先使用项目根 `./mvnw`。不要默认 `npm` / `yarn` 或裸 `mvn`。既有仓库确实没有 pnpm 或 Maven Wrapper 时，必须记录受控例外和实际命令。登记字段见 `docs/process/implementation-repo-integration.md`。
+- 路径越界、证据缺失、未执行验证、`drift`、`violation` 或 `new_impacts` 时停止实现并重新路由。
 
-禁止绕过上述合同、检查清单或专项 skill，直接在 `AGENTS.md` 中自行发明细则。详细实现约束以 YSS skills、`docs/process/implementation-repo-integration.md` 和对应模板为准。
+实现细则由已批准合同、YSS skills 和实现接入文档定义；`AGENTS.md` 只保留入口与边界。
 
 ## 8. 专项任务的强制入口
 
@@ -101,41 +78,45 @@ README、用户指南和其他说明文档只引用或解释上述事实，不
 |---|---|
 | 技术事实、标准、第三方 API 或框架行为影响决策 | `research` 或等价的一手资料记录 |
 | 竞品、市场或用户口碑事实 | `competitive-intelligence` |
-| UI 设计、原型、组件或主题 | `yss-design-system` 后路由 `product-design:index`；产出前用 `antd` 查询 Ant Design v6 事实 |
+| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；产出前后用 `antd` CLI 记录 Ant Design v6 与浏览器验证事实 |
 | Bug、测试失败或性能回退 | `diagnosing-bugs` 建立可复现反馈，再用 `tdd` |
 | merge / rebase 冲突 | `resolving-merge-conflicts` |
 | 架构治理、难测模块或深模块设计 | `improve-codebase-architecture` / `codebase-design` |
 | 跨线程、跨仓库、上下文过长或原型结论回流 | `handoff` 或等价交接记录 |
+| 本地知识库 init / refresh / rebuild，或要把研究结果落成持久 wiki | `llm-wiki`（落成持久 wiki 用 `ingest`；已映射 live 源变了用 `refresh`） |
 
 业务行为默认按 `tdd` 使用已确认的公开 seam 逐切片实现。一次性生成、纯配置或流程文档不适用代码 TDD 时，必须记录例外理由和可执行验证方式。
 
 ## 9. 工作区与实现仓库边界
 
-当前仓库默认是研发管理仓库，前端、后端和其他运行时代码优先位于独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才可按需创建：
+当前仓库默认是研发管理仓库，运行时代码优先位于已登记的独立实现仓库。只有用户明确选择当前仓库承载实现代码时，才使用唯一的 `apps/backend/<project>/` 或 `apps/frontend/<project>/` 项目根。
 
-```text
-apps/backend/
-apps/frontend/
-```
-
-不得自行新建其他顶层业务代码目录。
+`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 前按 `docs/process/subagent-collaboration.md` 定义任务包和不重叠的写入范围。实现者不担任独立审查者；仓库身份、需求 / 契约冻结、Ticket 最终状态、Git checkpoint 和完成结论仍由主控 Agent 或人工决定。
+
+## 12. 测试质量基线
 
-subagent 可收集证据、产出草案、实现局部切片和执行独立审查 / 验证，但不得替代主控 Agent 作出仓库身份判定、Spec baseline、需求冻结、OpenAPI Freeze、架构放行、Ticket 最终状态、Git checkpoint 范围或“完成 / 可合并 / 可发布”结论。
+模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。只有项目实例在测试策略中明确采纳或覆盖后才构成 CI 门禁；未定义关键流程清单时，不声称其 E2E 覆盖率达到 100%。
 
-详细规则见 `docs/process/subagent-collaboration.md`。
+## Cursor Cloud specific instructions
 
-## 12. 测试质量基线
+本仓库是 `template-source` Harness / 研发管理仓库，没有前端 / 后端运行时应用；可运行、可测试的表面只有 Node 工具链与治理校验脚本。
 
-模板推荐值为 Domain / Application `>= 90%`、API `>= 80%`、前端组件 `>= 75%`、已明确的关键流程 `100% E2E`。这些数字只是模板推荐；项目实例必须在测试策略中明确采纳或覆盖后，才构成 CI 门禁。未定义关键流程清单时，不得声称其 E2E 覆盖率达到 100%。
+- 依赖与工具链：Node `>=22 <27`（`.nvmrc` 固定 22）；`pnpm` 通过 `packageManager` 字段由 corepack 自动切换到 `10.15.0`，无需手工切换。Node 依赖只装在 `.template-source/tooling/node`，仓库根没有 `package.json`。
+- 测试：`pnpm --dir .template-source/tooling/node test`（`node --test`，共 15 个用例）。
+- 构建 / lint：`pnpm --dir .template-source/tooling/node build:vendor` 与 `check:vendor` 维护 `scripts/vendor/*.mjs`；顶层 lint 是 `verify-template` 内对所有脚本执行的 `node --check`。
+- 完整发布门禁（相当于"运行应用"）：`scripts/verify-template`，成功输出 `模板发布校验通过`。它串联证据索引、`pnpm test`、`check:vendor` 和全部 `scripts/verify-*` 场景校验。
+- 非显然的坑：`scripts/verify-lifecycle-registry`（及其对应测试 `Node lifecycle registry verifier ...`）会 shell out 到 `python3` 并 `import jsonschema` 做 JSON Schema 校验。缺少该 Python 模块时测试会以 `ModuleNotFoundError: No module named 'jsonschema'` 失败，而不是代码问题；update script 已负责 `pip3 install jsonschema`。
+- `pnpm install` 输出的 `Ignored build scripts: esbuild` 警告可忽略：esbuild 0.28.2 在本平台自带二进制，`build:vendor` / `check:vendor` 无需 `pnpm approve-builds`。
+- 常用只读入口：`scripts/repository-mode`（返回仓库身份）、`scripts/generate-lifecycle-artifacts`（从 `docs/process/lifecycle-registry.yaml` 派生产物，输出应无 diff）、`scripts/export-yss-skills --output <dir>`（导出公开技能）。

package/template/wiki/raw/CONTEXT.md

@@ -10,6 +10,8 @@
 | Agent 入口规则 | Agent 启动任务时必须先遵守的全局路由、硬门禁和禁止事项。 | 不作为 YSS 后端、前端或其他专项编码规范的完整手册。 |
 | 标准文档语言 | 面向业务、产品、架构、实施、审查、发布和复盘的持久化文档所使用的默认语言。 | 统一使用简体中文；英文专有名词、代码标识、API 路径、schema、文件名和协议 metadata 保持原样。 |
 | Matt Engineering Skills | 来自 `mattpocock/skills` 的轻量工程流程技能集合。 | 用于澄清、Spec、Ticket、实现、TDD、诊断、审查和架构治理，不替代 YSS 专项规范。 |
+| 上游技能基线 | 从外部技能源锁定的可追溯 revision 及其未经项目适配的原始内容。 | 不等同于项目当前实际生效的 skill；上游更新不得直接覆盖 YSS 适配。 |
+| YSS 技能适配 | 在上游技能基线之上，为 YSS 仓库身份、门禁、状态、授权和专项规范保留的可追溯差异。 | 必须同时保留上游内容哈希、有效内容哈希和适配依据，不作无记录的直接 fork。 |
 | YSS skills | 本项目内置的 YSS 工程规范技能。 | 用于 DDD、UI、OpenAPI、Repository、Controller、DTO、组件和编码规范。 |
 | 技能投影 | 从权威共享技能生成、供特定 Agent root 加载的同步副本。 | 投影不是独立维护的技能源，不应在各 Agent root 中分别修改。 |
 | Spec | 记录用户问题、解决方案、用户故事、关键决策、验收标准和测试 seam 的产品研发规格。 | 新资产统一使用 Spec；旧规格称谓只在迁移记录中保留。 |
@@ -21,26 +23,50 @@
 | `ready-for-agent` | 表示垂直切片已通过必要门禁并具备直接实现条件的流程状态。 | 不得用于 Spec 初稿、原型、OpenAPI Draft 或其他未冻结资产。 |
 | OpenAPI Draft | review-only 的 OpenAPI 3.1 契约草案。 | Freeze 前不得作为前后端稳定实现契约。 |
 | OpenAPI Freeze | 已通过评审、可作为前后端实现和契约测试输入的 OpenAPI 3.1 契约。 | Freeze 后变更必须回到 API 影响分析和设计审查。 |
+| YSS 响应包装 | 对外 API 使用 `Result` 基础字段及 `SingleResult`、`MultiResult`、`PageResult` 表达单对象、非分页列表和分页查询结果的统一返回结构。 | Java 泛型记法是语义简称；公开 schema 必须落成具体 endpoint wire shape。 |
+| DTO wire shape | DTO 在 HTTP/JSON 边界实际暴露的字段、类型、可空性和方向性；与 Java 字段、getter 或内部协作字段区分。 | 以目标 mapper / contract evidence 为准，不从 getter、Lombok 或 `@JsonIgnore` 机械推断。 |
 | UI 影响 | 会改变用户可见页面、导航、交互流程、状态呈现或权限体验的功能影响。 | 纯后端、API、批处理或数据变更不自动构成 UI 影响。 |
 | 产品设计影响 | UI 变化触及主流程、导航、权限体验、异常 / 恢复状态、状态流转或 API 反推，需要页面流、状态矩阵和原型校准。 | 文案、token、颜色、间距和无行为变化的孤立视觉修复属于 UI 影响，但不自动构成产品设计影响。 |
 | 高保真 HTML 原型 | 低保真原型评审通过后，用于在浏览器中审查真实视觉密度、交互状态和页面流的产品设计资产。 | 不等同于生产前端实现，也不替代 OpenAPI、Spec 校准或垂直切片。 |
+| Visual Baseline Contract | 为生产前端还原冻结页面、视口、交互状态、参考图像和允许差异的可验收合同。 | 不是仅有一张原型截图或绝对像素匹配；每个基线必须可定位到同一视口和同一状态复验。 |
 | 垂直切片（Vertical Slice） | 贯穿所有受影响层、可独立验证的窄功能路径。 | 优先使用垂直切片，避免只按层拆分的横向任务。 |
 | Slice Implementation Contract | 阶段 7 进入实现前，由 `yss-router` 根据冻结资产和垂直切片编译、再由生命周期编排器批准的实现合同，包含 Common、Frontend、Backend、Contract 和 Cross-repo 子合同。 | Router 只能生成草案，不能自行批准、设置 `ready-for-agent` 或宣布完成；Backend 子合同仍保留额外强约束。 |
 | YSS Skill Execution Result | YSS 专项 skill 完成工作单元后返回的结构化执行证据，记录合同版本、变更文件、证据文件、实际验证、延期 seam、偏离和新增影响。 | 实现者自报 `implemented` 不构成最终通过，必须由 Router、生命周期编排器和独立 Reviewer 复核。 |
 | ADR | 架构决策记录，用于沉淀难以回滚、非显而易见且存在真实取舍的技术决策。 | 常规实现选择不要写 ADR。 |
 | Fresh Verification | 完成前重新执行的验证证据，包括测试命令、契约校验、关键路径检查或人工审查结论。 | 不等同于“之前跑过”或实现者自述。 |
+| 实现验证命令 | 前端测试 / 构建优先 `pnpm`，后端校验 / 测试 / 编译优先 `./mvnw`。 | 不要默认 `npm`、`yarn` 或裸 `mvn`；仓库确实缺少 pnpm 或 Maven Wrapper 时记受控例外。 |
 | 测试质量基线 | 项目实例明确采纳的覆盖率阈值、关键流程清单和受控例外。 | 模板推荐值本身不构成可执行门禁；未定义关键流程时，不得声称其 E2E 覆盖率达到 100%。 |
-| 条件强制门禁 | 只有当影响面命中触发条件时才必须完成的生命周期审查点。 | 未触发时记录 `not-applicable` 及原因，不生成空文档；不要理解为所有任务默认执行全部门禁。 |
+| 主阶段 | 对相邻研发目标、工作单元和退出条件的粗粒度生命周期分组。 | 不等同于门禁编号，也不因增加门禁而自动增加主阶段。 |
+| 生命周期门禁（条件强制门禁） | 只有当影响面命中触发条件时才必须裁决的生命周期审查点。 | 未触发时记录 `not-applicable` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
+| 生命周期产物 | 生命周期工作单元形成并持久化、可被审查和引用的业务或工程结果。 | 文件存在不代表产物已经批准或仍然新鲜。 |
+| 工作单元 | 具有明确输入、输出、允许动作和完成条件的一次有界执行。 | 不等同于主阶段或门禁；一个主阶段可以包含多个工作单元。 |
+| 执行证据 | 用于证明工作单元结果、门禁裁决或完成结论的可读取引用和实际验证记录。 | 口头声明、计划执行的命令或无法解析的引用不构成执行证据。 |
 | 单一事实来源（Single Source of Truth） | 对某一类流程事实拥有唯一定义权的权威资产。 | 其他资产只引用或解释，不重复定义同一规则。 |
 | 流程模板资产 | 可被不同项目复用的文档模板、技能说明、校验脚本、流程规范和目录占位文件。 | 不包含某个具体产品的 Spec、设计、OpenAPI 或 Ticket。 |
 | 模板维护流程 | 用于评估影响、修改权威资产、同步投影、执行压力验证并审查模板演进的工作流。 | 面向模板源仓库，不默认生成具体产品的 Spec、原型、OpenAPI 或垂直切片 Ticket。 |
 | 模板发布门禁 | 模板源发布前必须通过的结构、技能同步、流程语义和压力场景验证集合。 | 不等同于只检查文件存在、Markdown 链接或 YAML 语法。 |
 | Harness 工程 | 串联研发生命周期阶段、门禁、产物、Agent/Skill 编排和追踪证据的工程化治理载体。 | 不等同于单个 CI 流水线或零散提示词集合。 |
+| YSS 研发操作系统 | 由生命周期控制、通用工作流、YSS 专项技能、证据反馈和技能供应链共同构成的可版本化研发治理体系。 | 不等同于单个主控 skill、某个 Agent 客户端或运行时代码平台。 |
+| 生命周期注册表 | 结构化定义主阶段、门禁、产物、工作单元、证据及其稳定标识和关系的机器可读权威资产。 | Markdown 地图、数量说明和验证 fixture 是其派生产物，不应分别维护同一结构事实。 |
+| 生命周期编排器 | 持有阶段、影响面、产物状态、门禁裁决、工作单元路由和恢复条件的研发流程控制平面。 | 不替代专项技能执行业务实现，也不以文件存在或执行者自述宣布完成。 |
+| 前端实现还原验证 | 证明生产前端相对冻结 Spec、交互说明、状态矩阵和高保真原型不存在未解释差异的独立验证。 | 不是绝对像素复刻、普通 type-check 或原型评审；UI 影响切片需覆盖关键视觉、状态、交互和工程证据。 |
+| 生命周期稳定 ID | 以对象类型命名空间和英文标识唯一指向一个生命周期对象的兼容身份。 | 中文名称、展示顺序和数量可以变化；已发布 ID 不得复用来表达另一种语义。 |
+| 派生产物 | 根据生命周期注册表确定性生成的结构表、数量、索引、依赖图或测试 fixture。 | 不承载需要人工解释的原理、取舍或实践建议，禁止脱离注册表分别维护。 |
+| 核心技能（Core Skill） | 默认可发现、负责生命周期控制或通用研发入口的稳定技能。 | 不包含只在特定技术影响下才需要的专项实现规则。 |
+| 专项技能（Specialist Skill） | 由 Router 根据影响面和实现合同按需选择的前端、后端、OpenAPI 或组件技能。 | 不作为所有任务的平级默认入口。 |
+| 试验技能 | 尚未达到项目默认支持成熟度的技能。 | 只在明确试验范围内使用，不进入 Router 默认技能闭包。 |
+| 显式兼容入口 | 为已有用户操作习惯保留的 user-invoked 工作流入口，写入前由生命周期编排器预检，结果回交其验收。 | 不是默认路径、过时别名或可以越过门禁的第二套生命周期。 |
+| 技能成熟度 | 描述技能从 `draft`、`verified`、`supported` 到 `deprecated` 的治理状态。 | 不等同于文件存在、已被投影或能够安装。 |
+| 技能注册表 | 记录技能身份、别名、分层、适用影响面、成熟度、默认可发现性和 Agent 运行时入口的机器可读路由资产。 | 不替代 `skills-lock.json` 的来源、hash 和投影完整性职责。当前 `docs/agents/yss-skill-registry.yaml` 为 `shadow`，Router 与生命周期不得按其裁剪发现面。 |
+| LLM Wiki | 由 `raw/`、`wiki/` 与 `.wiki-manifest.json` 组成的本地持久知识库。 | 不是 `research` 一次性笔记，也不替代权威源。`ingest` 只把用户点名的外源或已落盘研究笔记编进 IR，不改 live 权威文件。 |
+| 生态发布清单 | 关联模板 schema 与 commit、CLI 版本与快照、公开技能来源与导出 hash 的跨仓发布证据。 | 不要求尚未生成的仓库 commit 互相循环引用。 |
 | 研发管理仓库 | 承载 Spec、OpenAPI、架构、Ticket、验证、发布和复盘等研发管理资产的仓库。 | 不等同于前端 / 后端代码 monorepo。 |
 | 实现仓库 | 承载前端、后端或其他运行时代码及其 Git、CI、MR / PR、测试命令和发布流水线的仓库。 | 不要把实现仓库的源码所有权混入研发管理仓库。 |
 | 跨仓库契约变更 | 需要两个或多个独立仓库协同实现、验证和按顺序发布的共享契约变化。 | 任一参与仓库未完成契约对齐和集成验证时，不得单独声称整体可发布。 |
 | 模板源仓库（`template-source`） | 承载 `yss-spec-project-template` 权威模板资产及其演进规则的仓库身份。 | 只管理可复用模板，不承载某个具体产品的研发生命周期资产。 |
 | 模板实例仓库（`project-instance`） | 由模板初始化后生成、承载某个具体产品研发生命周期资产的仓库身份。 | 不作为通用流程模板的权威来源。 |
+| 模板实例分发面 | 模板源中应随 CLI 快照进入 `project-instance` 的共享生命周期、模板、用户指南和验证资产集合。 | 不包含模板源审查、研究、发布路线或源仓库专属 ADR。 |
+| 模板源治理区 | 仅供 `template-source` 使用、保存审查证据、研究记录、跨仓契约、发布路线和源仓库治理决策的归档区域。 | 不随 CLI 分发；不等于产品实例的研发管理资产。 |
 | 仓库身份清单 | 显式声明仓库身份和清单结构版本的机器可读资产。 | 不承载项目名称、团队规模、Tracker 或其他易变业务配置。 |
 
 只有在计划、分诊、调试或架构讨论中明确沉淀出稳定语言时，才新增术语。