create-yss-spec 2.1.13 → 2.1.15

package/README.md

@@ -14,6 +14,18 @@ npm create yss-spec@latest
 npx create-yss-spec@latest
 ```
 
+查看用法、命令、参数和样例：
+
+```bash
+npx create-yss-spec@latest --help
+```
+
+查看 CLI 版本：
+
+```bash
+npx create-yss-spec@latest --version
+```
+
 ## 当前支持
 
 - 交互式收集 `projectName`、`businessDomain`、`targetDir`
@@ -33,7 +45,7 @@ npx create-yss-spec@latest
 - 旧、新资产内容冲突或清单 schema / mode 非法时 fail closed
 - 保留模板的共享 skill 投影；生成实例可在尚未 `git init` 时运行模板校验
 
-本次模板适配按 `2.1.13` 发布。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。
+本次模板适配按 `2.1.15` 发布。`templateCommit` 会写入实例 metadata；“最新模板”指用户执行的 `npx create-yss-spec@latest` 所携带的最新已发布快照，CLI 运行时不会拉取模板仓库。
 
 ## 接管已有项目
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yss-spec",
-  "version": "2.1.13",
+  "version": "2.1.15",
   "description": "Initialize a YSS spec project template repository",
   "repository": {
     "type": "git",

package/src/cli.js

@@ -33,6 +33,8 @@ const TEMPLATE_METADATA_FILENAME = ".yss-template.json";
 const TEMPLATE_MANIFEST_VERSION = sha256(TEMPLATE_MANIFEST_TEXT);
 const TEMPLATE_SOURCE = "github:iloveZzz/yss-spec-project-template";
 const METADATA_SCHEMA_VERSION = 2;
+const HELP_FLAGS = new Set(["--help", "-h", "-help"]);
+const VERSION_FLAGS = new Set(["--version", "-v", "-version"]);
 const AGENT_SKILL_ROOTS = [
   ".agents/skills",
   ".claude/skills",
@@ -184,8 +186,10 @@ function parseArgs(argv) {
       options.includeExampleDocs = true;
     } else if (current === "--no-example-docs") {
       options.includeExampleDocs = false;
-    } else if (current === "--help" || current === "-h") {
+    } else if (HELP_FLAGS.has(current)) {
       options.help = true;
+    } else if (VERSION_FLAGS.has(current)) {
+      options.version = true;
     } else {
       throw new Error(`不支持的参数：${current}`);
     }
@@ -1539,6 +1543,10 @@ function runInit(argv = []) {
     printHelp();
     return;
   }
+  if (options.version) {
+    printVersion();
+    return;
+  }
   return promptForMissingOptions(options).then((promptedOptions) => {
     assertRequiredOptions(promptedOptions, "init");
     readTemplateSnapshot();
@@ -1592,6 +1600,10 @@ function runAttach(argv = []) {
     printHelp();
     return;
   }
+  if (options.version) {
+    printVersion();
+    return;
+  }
   assertRequiredOptions(options, "attach");
   if (options.dryRun && options.apply) {
     throw new Error("attach 的 --dry-run 与 --apply 互斥");
@@ -1692,6 +1704,10 @@ function runSync(argv = []) {
     printHelp();
     return;
   }
+  if (options.version) {
+    printVersion();
+    return;
+  }
   readTemplateSnapshot();
   const targetDir = normalizeTargetDir(options.targetDir || ".");
   inspectExistingTargetDir(targetDir);
@@ -1782,16 +1798,87 @@ function runSync(argv = []) {
   console.log("3. 确认无误后提交本次模板同步结果");
 }
 
+function argvIncludesFlag(argv, flags) {
+  return argv.some((arg) => flags.has(arg));
+}
+
+function printVersion() {
+  console.log(`create-yss-spec ${PACKAGE_MANIFEST.version}`);
+}
+
 function printHelp() {
   console.log(`create-yss-spec ${PACKAGE_MANIFEST.version}
 
-初始化：create-yss-spec --project-name <name> --business-domain <domain> --target-dir <dir>
-接管已有项目：create-yss-spec attach --target-dir <dir> --project-name <name> --business-domain <domain> --dry-run|--apply [--force]
-同步模板：create-yss-spec sync [--target-dir <dir>] [--dry-run] [--force]
+USAGE
+  $ create-yss-spec [COMMAND] [OPTIONS]
+
+COMMANDS
+  (default)  初始化新的模板实例仓库
+  attach     向已有项目补齐受管研发管理资产
+  sync       同步已有模板实例的受管资产
+
+OPTIONS
+  --project-name <name>              项目名称；init 不传则进入交互输入
+  --business-domain <domain>         业务领域；init 不传则进入交互输入
+  --team-size <size>                 团队规模；init 不传则可留空，默认「待补充」
+  --target-dir <dir>                 目标目录；init 不传则进入交互输入，sync 默认为当前目录
+  --issue-tracker github|gitlab      默认 issue tracker 偏好（默认 github）
+  --dry-run                          只预览计划，不写入文件
+  --apply                            attach 确认执行写入；不能与 --dry-run 同时使用
+  --force                            init：允许清空非空目录后重新生成
+                                     attach / sync：覆盖受管冲突文件；unsafe 路径始终阻断
+  --git-init                         初始化完成后执行 git init
+  --include-example-docs             显式保留示例文档（默认开启）
+  --no-example-docs                  不生成示例文档
+  -h, --help                         显示本帮助信息
+  -v, --version                      显示 CLI 版本
+
+EXAMPLES
+  $ npm create yss-spec@latest
+  $ npx create-yss-spec@latest --help
+  $ npx create-yss-spec@latest --version
+  $ npx create-yss-spec@latest \\
+      --project-name "Acme Spec Repo" \\
+      --business-domain "Investment Research" \\
+      --team-size "12" \\
+      --target-dir "./acme-spec-repo" \\
+      --issue-tracker github \\
+      --git-init
+  $ npx create-yss-spec@latest \\
+      --project-name "Preview Repo" \\
+      --business-domain "Data Platform" \\
+      --target-dir "./preview-repo" \\
+      --dry-run
+  $ npx create-yss-spec@latest attach \\
+      --target-dir . \\
+      --project-name "Acme Application" \\
+      --business-domain "Data Platform" \\
+      --dry-run
+  $ npx create-yss-spec@latest attach \\
+      --target-dir . \\
+      --project-name "Acme Application" \\
+      --business-domain "Data Platform" \\
+      --apply
+  $ npx create-yss-spec@latest sync
+  $ npx create-yss-spec@latest sync --dry-run
+  $ npx create-yss-spec@latest sync --target-dir . --force
+
+LEARN MORE
+  仓库 README：https://github.com/iloveZzz/create-yss-spec#readme
+  使用手册：https://github.com/iloveZzz/create-yss-spec/blob/main/docs/user-guide/create-yss-spec-cli-guide.md
+  模板仓库：https://github.com/iloveZzz/yss-spec-project-template
 `);
 }
 
 async function runCli(argv = []) {
+  if (argvIncludesFlag(argv, HELP_FLAGS)) {
+    printHelp();
+    return;
+  }
+  if (argvIncludesFlag(argv, VERSION_FLAGS)) {
+    printVersion();
+    return;
+  }
   if (argv[0] === "sync") {
     runSync(argv.slice(1));
     return;

package/template/AGENTS.md

@@ -31,7 +31,7 @@ README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或
 - 所有面向业务、产品、架构、实施、审查、发布和复盘的落地文档，正文统一使用简体中文。
 - 英文专有名词、代码标识、API 路径、schema、类名、方法名、枚举值、错误码、命令、文件名和协议 metadata 保持原样。
 - 新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。过时术语和技能名只能出现在迁移指南或明确标注的旧项目上下文。
-- 实施前读取 `CONTEXT.md`；与词汇或 ADR 冲突时立即指出并先解决冲突。
+- 实施前读取 `CONTEXT.md`。业务术语必须已有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形。改中文术语或英文标识都先回写 `CONTEXT.md`。与词汇或 ADR 冲突时立即指出并先解决冲突。
 
 ## 4. `template-source` 模板维护路由
 

package/template/CONTEXT.md

@@ -1,72 +1,80 @@
 # 领域上下文
 
-本文档是项目的领域词汇表，只记录业务语言和协作概念，不记录实现细节、计划草稿或架构说明。
+本文档是项目的领域词汇表，只记录稳定业务语言和协作概念，不记录实现细节、计划草稿或架构说明。
 
-## 术语表
-
-| 术语 | 含义 | 避免 / 备注 |
-|---|---|---|
-| Agent | 执行特定工作流步骤的 AI 协作者。 | 不要与人工审查者混用。 |
-| 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；旧规格称谓只在迁移记录中保留。 |
-| Spec Delta | 记录相对于既有冻结 Spec 基线的 `ADDED / MODIFIED / REMOVED` 行为、验收场景和测试映射。 | 不用于全新产品或全新模块，也不替代完整 Spec、OpenAPI 或架构资产。 |
-| Ticket | 在追踪平台上承载功能生命周期或可实现工作单元的通用追踪对象。 | GitHub Issues / GitLab Issues 是具体平台对象名称；领域资产统一称为 Ticket。 |
-| 功能父 Ticket | 汇总一个功能从 Spec 到契约冻结的阶段状态、资产链接、审查结论和阻塞项的 Ticket。 | 不作为 Agent 直接实现的垂直切片。 |
-| 垂直切片 Ticket | 契约冻结后生成的可独立验证实现单元，记录范围、阻塞关系、验收标准和验证证据。 | 只有通过必要门禁并具备直接实现条件时才能标记 `ready-for-agent`。 |
-| `ready-for-human` | 表示 Spec、设计、契约草案或其他资产仍需人工审查或确认的流程状态。 | 此状态不表示可以直接进入实现。 |
-| `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` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
-| 生命周期产物 | 生命周期工作单元形成并持久化、可被审查和引用的业务或工程结果。 | 文件存在不代表产物已经批准或仍然新鲜。 |
-| 工作单元 | 具有明确输入、输出、允许动作和完成条件的一次有界执行。 | 不等同于主阶段或门禁；一个主阶段可以包含多个工作单元。 |
-| 执行证据 | 用于证明工作单元结果、门禁裁决或完成结论的可读取引用和实际验证记录。 | 口头声明、计划执行的命令或无法解析的引用不构成执行证据。 |
-| 单一事实来源（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 或其他易变业务配置。 |
+`英文标识` 是 PascalCase 词干，不是英语释义。`## 业务术语` 必须填写该列；`## 流程术语` 填 `—`。代码类型名、字段名和契约 property 由该词干变形：类名 = 词干 + YSS 工程后缀；字段与 JSON property 为 camelCase；数据库列为 snake_case；枚举常量为 UPPER_SNAKE。工程后缀以 YSS skill 和当前工程惯例为准，不作为领域词写入本表。JSON 与 Java 字段不一致时，以 DTO wire shape / OpenAPI 为准，不在本表另开列。改中文术语或英文标识都是统一语言变更，必须先回写本表。`避免 / 备注` 同时记录禁用中文和禁用英文别名。
 
 只有在计划、分诊、调试或架构讨论中明确沉淀出稳定语言时，才新增术语。
+
+## 流程术语
+
+模板源与生命周期协作概念放在本节。`英文标识` 填 `—`，不回溯补译。
+
+| 术语 | 含义 | 英文标识 | 避免 / 备注 |
+|---|---|---|---|
+| Agent | 执行特定工作流步骤的 AI 协作者。 | — | 不要与人工审查者混用。 |
+| 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；旧规格称谓只在迁移记录中保留。 |
+| Spec Delta | 记录相对于既有冻结 Spec 基线的 `ADDED / MODIFIED / REMOVED` 行为、验收场景和测试映射。 | — | 不用于全新产品或全新模块，也不替代完整 Spec、OpenAPI 或架构资产。 |
+| Ticket | 在追踪平台上承载功能生命周期或可实现工作单元的通用追踪对象。 | — | GitHub Issues / GitLab Issues 是具体平台对象名称；领域资产统一称为 Ticket。 |
+| 功能父 Ticket | 汇总一个功能从 Spec 到契约冻结的阶段状态、资产链接、审查结论和阻塞项的 Ticket。 | — | 不作为 Agent 直接实现的垂直切片。 |
+| 垂直切片 Ticket | 契约冻结后生成的可独立验证实现单元，记录范围、阻塞关系、验收标准和验证证据。 | — | 只有通过必要门禁并具备直接实现条件时才能标记 `ready-for-agent`。 |
+| `ready-for-human` | 表示 Spec、设计、契约草案或其他资产仍需人工审查或确认的流程状态。 | — | 此状态不表示可以直接进入实现。 |
+| `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` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
+| 生命周期产物 | 生命周期工作单元形成并持久化、可被审查和引用的业务或工程结果。 | — | 文件存在不代表产物已经批准或仍然新鲜。 |
+| 工作单元 | 具有明确输入、输出、允许动作和完成条件的一次有界执行。 | — | 不等同于主阶段或门禁；一个主阶段可以包含多个工作单元。 |
+| 执行证据 | 用于证明工作单元结果、门禁裁决或完成结论的可读取引用和实际验证记录。 | — | 口头声明、计划执行的命令或无法解析的引用不构成执行证据。 |
+| 单一事实来源（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 或其他易变业务配置。 |
+
+## 业务术语
+
+`project-instance` 在本节新增产品对象。每一行必须有 PascalCase `英文标识`；缺该列视为统一语言未冻结。模板源不放虚构业务行。

package/template/docs/agents/domain.md

@@ -24,6 +24,7 @@
 
 ## 使用规则
 
-- 在 Spec、Ticket 标题、测试、架构说明和实施总结中使用 `CONTEXT.md` 定义的术语。
-- 不在 `CONTEXT.md` 中记录实现细节；它是领域词汇表，不是需求或实现规格。
-- 如果提案与现有 ADR 冲突，必须在继续执行前明确指出冲突。
+- 在 Spec、Ticket 标题、测试、架构说明和实施总结中使用 `CONTEXT.md` 定义的中文术语。
+- 业务术语必须同时有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形。不把具体类全名、表名或接口路径写入词汇表。
+- `CONTEXT.md` 是领域词汇表，不是需求或实现规格；临时计划和未确认猜测不写入。
+- 如果提案与现有 ADR 或已冻结术语冲突，必须在继续执行前明确指出冲突。

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

@@ -19,7 +19,7 @@ owner: ai
 | 产品设计 / 交互说明 |  |  |  |
 | 高保真 HTML 原型 | `docs/.scratch/<feature>/design/prototypes/index.html` |  | 有 UI 时必需；Ant Design v6 |
 | Prototype Review |  |  |  |
-| CONTEXT 术语 |  |  |  |
+| CONTEXT 术语 |  |  | 业务术语须含 PascalCase `英文标识` |
 
 ## 2. 冻结范围
 

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

@@ -66,6 +66,7 @@ Approved / Changes requested / Blocked
 | `alibaba-java-code-style` 已纳入审查，命名、异常、日志、ORM/MyBatis、Maven、MapStruct / Lombok 注解处理器配置无 blocker | pass / violation / not-applicable |  |
 | 后端构建 / 测试 / OpenAPI / CI / Release 命令使用项目根目录 `./mvnw ...`；裸 `mvn ...` 已改正或有受控例外记录 | pass / violation / not-applicable |  |
 | 持久化文档正文、章节标题、审查结论和实施说明使用中文；英文模板内容未原样落地 | pass / violation / not-applicable |  |
+| 新增或修改的业务类型 / 字段 / OpenAPI property 能追溯到 `CONTEXT.md` 业务术语的 `英文标识` 词干；未登记的新名字已回写词汇表 | pass / violation / not-applicable |  |
 | `Build Architecture Checklist` 已回勾，延期项、漂移项、违反项有明确处理结论 | pass / violation / not-applicable |  |
 
 ### 后端 smoke check

package/template/docs/templates/spec-template.md

@@ -73,7 +73,7 @@ owner: ai
 
 | 检查项 | 是 / 否 | 说明 / 处理 |
 |---|---|---|
-| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` |
+| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` 的中文术语和 PascalCase `英文标识` |
 | 是否新增或改变限界上下文 / 模块边界 |  | 需要在产品总体设计中完成 Strategic DDD Check |
 | 是否改变上下文间协作关系 |  | 说明上游 / 下游 / 防腐层 / 共享内核关系 |
 | 是否新增或改变聚合、不变量、状态机 |  | 需要在系统概要设计 / 数据架构中完成 Tactical DDD Check |

package/template/docs/templates/vertical-slice-ticket-template.md

@@ -129,4 +129,4 @@ Status: ready-for-human
 - [ ] 已回勾当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
 - [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
 - [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`
-- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR
+- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR；新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干

package/template/docs/user-guide//344/272/247/345/223/201/347/224/237/345/221/275/345/221/250/346/234/237/345/267/245/344/275/234/346/265/201.md

@@ -17,7 +17,7 @@
 
 | 资产     | 位置                                                          | 用途                                                          |
 | ------ | ----------------------------------------------------------- | ----------------------------------------------------------- |
-| 领域语言   | `CONTEXT.md`                                                | 统一产品、开发、设计、实施和 AI 的业务词汇                                     |
+| 领域语言   | `CONTEXT.md`                                                | 统一产品、开发、设计、实施和 AI 的业务词汇与英文标识词干                     |
 | 需求与验收  | `docs/.scratch/<feature>/spec.md`                                | 保存 Spec、用户故事、验收条件和边界规则                                      |
 | API 契约 | `docs/.scratch/<feature>/api/`                                    | 用 OpenAPI 3.1 约束前后端协作                                       |
 | 行为差异   | `docs/.scratch/<feature>/spec-delta/`                             | 用轻量 Spec Delta 记录中高风险变化的 ADDED / MODIFIED / REMOVED 行为和测试映射 |
@@ -77,17 +77,17 @@ CONTEXT.md
 
 ### Step 2: 建立领域词汇
 
-在 `CONTEXT.md` 中只放稳定业务语言，不放实现细节。
+在 `CONTEXT.md` 的 `## 业务术语` 中只放稳定业务语言，并填写 PascalCase `英文标识`。不放实现细节、类全名或表名。格式以根目录 `CONTEXT.md` 为准。
 
-示例：
+示例（仅用户指南；不要把虚构行写入模板源 `## 业务术语`）：
 
-| 术语 | 含义 | 备注 |
-|---|---|---|
-| 模型 | 对业务数据结构的抽象定义 | 不等同于数据库表 |
-| 字段 | 模型中的属性定义 | 包含类型、长度、是否必填、默认值 |
-| 草稿版本 | 可编辑但未发布的模型版本 | 不能被生产服务引用 |
-| 发布版本 | 已冻结的可引用版本 | 原则上不可变 |
-| 模型校验 | 发布前对字段、命名、关系和约束的检查 | 失败时需要字段级错误 |
+| 术语 | 含义 | 英文标识 | 避免 / 备注 |
+|---|---|---|---|
+| 模型 | 对业务数据结构的抽象定义 | Model | 不等同于数据库表；Table |
+| 字段 | 模型中的属性定义 | Field | SchemaColumn |
+| 草稿版本 | 可编辑但未发布的模型版本 | DraftVersion | 不能被生产服务引用 |
+| 发布版本 | 已冻结的可引用版本 | PublishedVersion | 上线、提交；Release、OnlineVersion |
+| 模型校验 | 发布前对字段、命名、关系和约束的检查 | ModelValidation | 失败时需要字段级错误 |
 
 这一步会直接影响后续 AI 生成 Spec、API、代码和测试的质量。可用 `domain-modeling` 持续维护领域语言和 ADR。
 

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

@@ -62,7 +62,7 @@
 | Harness 能力 | 位置 | 用法 |
 |---|---|---|
 | Agent 入口规则 | `AGENTS.md` | 约束风险 / 回滚约束、阶段门禁和默认协作流程 |
-| 领域记忆 | `CONTEXT.md` | 保存稳定业务术语，避免每轮重新解释 |
+| 领域记忆 | `CONTEXT.md` | 保存稳定业务术语和英文标识词干，避免每轮重新解释或临场翻译 |
 | 需求和规格资产 | `docs/.scratch/<feature>/discovery/`、`docs/.scratch/<feature>/spec.md`、`docs/.scratch/<feature>/api/` | 把聊天结论变成可审查文件 |
 | 产品设计资产 | `docs/.scratch/<feature>/design/` 或 Figma / 原型工具链接 | 保存页面清单、用户流、原型、交互说明和状态矩阵 |
 | 架构和决策资产 | `docs/.scratch/<feature>/architecture/`、`docs/adr/` | 保存模块边界、状态流和难回滚取舍 |
@@ -144,7 +144,7 @@ skills 是让 AI 按规程工作的“操作手册”，不是关键词装饰。
 | 目标 | 推荐入口 | 注意事项 |
 |---|---|---|
 | 不知道当前该做什么 | `yss-product-lifecycle` | 先阶段判断和资产检查，不写业务代码 |
-| 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语写 `CONTEXT.md` |
+| 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语和英文标识写 `CONTEXT.md` |
 | 生成 Spec 初稿 / 需求基线 | `to-spec` 或 Spec 模板 | 只基于已确认事实，不把待确认项写成需求 |
 | 产品总体设计 / 功能架构 | `docs/design/templates/product-overview-design-template.md`、`docs/.scratch/<feature>/design/` | Spec 初稿后的必要产物；必须包含低保真原型 / 页面草图；进入页面 / 原型 / 交互设计、Spec 校准或 OpenAPI Draft 前必须完成 |
 | 页面和交互设计 | `product-design:index`、Product Design focused skills、`docs/.scratch/<feature>/design/` | 基于 Spec 初稿和产品总体设计细化页面流、状态和交互，再回填 Spec 并反推 API |
@@ -361,7 +361,7 @@ docs/.scratch/data-modeling/discovery/data-modeling-opportunity.md
 - [ ] 字段级校验和错误展示规则明确。
 - [ ] API 影响已初判。
 - [ ] 风险 / 回滚约束已检查；需要人工确认的事项已记录结论。
-- [ ] 稳定术语已准备写入 `CONTEXT.md`。
+- [ ] 稳定术语已准备写入 `CONTEXT.md`，业务对象含 PascalCase `英文标识`。
 
 ## 6. 阶段 3：Spec 初稿 / 需求基线
 
@@ -920,7 +920,7 @@ docs/user-guide/
 - 哪些 OpenAPI 字段在 Freeze 后仍被修改，原因是什么？
 - 哪些测试 seam 缺失导致回归风险？
 - 哪些实施问题应该写入用户指南？
-- 哪些规则应该上升到 `CONTEXT.md`、ADR 或 `AGENTS.md`？
+- 哪些规则应该上升到 `CONTEXT.md`（含英文标识）、ADR 或 `AGENTS.md`？
 
 阶段门禁：
 

package/template/docs/user-guide//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

@@ -6,12 +6,12 @@
 
 ### 1.1 先稳定语言，再稳定实现
 
-业务系统最怕“同一个东西有三个名字”。开始写代码前，先把稳定术语写进 `CONTEXT.md`。
+业务系统最怕“同一个东西有三个名字”。开始写代码前，先把稳定术语和 PascalCase `英文标识` 写进 `CONTEXT.md` 的 `## 业务术语`。
 
 示例：
 
 ```text
-模型、字段、草稿版本、发布版本、校验错误、引用关系
+模型 / Model、字段 / Field、草稿版本 / DraftVersion、发布版本 / PublishedVersion
 ```
 
 如果一个术语还在讨论中，可以先放在 Spec 或 discovery 文档，不要急着写进 `CONTEXT.md`。
@@ -222,7 +222,7 @@ opportunity exploration
 
 | 文档 | 应该写 | 不应该写 |
 |---|---|---|
-| `CONTEXT.md` | 稳定术语 | 临时计划、代码路径 |
+| `CONTEXT.md` | 稳定术语与英文标识词干 | 临时计划、类全名、表名、代码路径 |
 | Competitive Matrix | 竞品功能、差异化机会、MVP 边界输入 | 未验证事实、营销文案堆砌 |
 | Spec | 用户问题、范围、验收 | 详细实现代码 |
 | OpenAPI | 接口契约 | 页面交互细节 |
@@ -436,7 +436,7 @@ OpenAPI Freeze
 - [ ] 如果涉及权限、认证、SQL、迁移、加密或公共 API 时，已记录风险判断和验证证据。
 - [ ] 没有调试代码。
 - [ ] 任务清单已更新。
-- [ ] 如果术语或规则变化，已更新 `CONTEXT.md` 或 Spec。
+- [ ] 如果术语或规则变化，已更新 `CONTEXT.md`（业务术语含 `英文标识`）或 Spec。
 
 ### 6.3 发布前
 
@@ -579,6 +579,6 @@ OpenAPI Freeze
 - 哪些需求被改了两次以上？
 - 哪些实现让实施解释成本变高？
 - 哪些规则应该写入 `AGENTS.md`？
-- 哪些术语应该写入 `CONTEXT.md`？
+- 哪些术语应该写入 `CONTEXT.md`，并补上英文标识词干？
 
 这样这套模板会从“文档目录”逐渐变成你的产品操作系统。

package/template/docs/user-guide//351/234/200/346/261/202/346/276/204/346/270/205/346/214/207/345/215/227.md

@@ -121,28 +121,27 @@ grill 的重点是“被问住”。遇到不确定的问题，不要让 AI 替
 
 ## 5. 与 CONTEXT.md 的关系
 
-`CONTEXT.md` 只记录稳定业务语言，不记录实现细节。
+`CONTEXT.md` 只记录稳定业务语言，不记录实现细节。格式与变形规则以根目录 `CONTEXT.md` 文首为准。
 
 应该写入：
 
 - 业务对象：模型、字段、草稿版本、发布版本。
 - 状态含义：冻结、发布、撤销、失效。
 - 角色和责任：建模人员、实施顾问、平台管理员。
-- 避免用语：同义词、容易混淆的叫法。
+- PascalCase `英文标识` 词干，供代码类型 / 字段和契约 property 变形。
+- 避免用语：禁用中文近义词和禁用英文别名。
 
 不应该写入：
 
-- Java 类名、Vue 组件名、表名、接口路径。
+- 具体类全名、Vue 组件名、表名、接口路径。
 - 临时计划。
 - 未确认猜测。
 - 具体实现方案。
 
-示例：
+示例（仅用户指南；不要把虚构行写入模板源 `## 业务术语`）：
 
 ```text
-模型发布：
-将草稿版本冻结为可被下游引用的发布版本。
-_Avoid_: 上线、提交、保存
+| 发布版本 | 已冻结的可引用版本 | PublishedVersion | 上线、提交；Release、OnlineVersion |
 ```
 
 ## 6. 与 ADR 的关系

package/template/docs/user-guide//351/234/200/346/261/202/346/276/204/346/270/205/346/234/200/344/275/263/345/256/236/350/267/265.md

@@ -236,7 +236,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 |---|---|---|
 | AI 一次问十个问题 | 用户难回答，容易敷衍 | 一次聚焦一个主题，必要时一个关键问题一轮 |
 | AI 替业务做决定 | 关键规则来自猜测 | 标为待确认 |
-| 术语都写进 CONTEXT.md | 词汇表膨胀失真 | 只写稳定业务语言 |
+| 术语都写进 CONTEXT.md | 词汇表膨胀失真 | 只写已确认的业务术语，并带 PascalCase `英文标识` |
 | ADR 写成大方案 | 后续没人读 | 只记录决定和原因 |
 | grill 之后直接开发 | Spec / OpenAPI / change 丢失 | 先进入 Spec 或 Ticket |
 | 只问正常路径 | 异常场景上线后暴露 | 必问失败、并发、权限、回滚 |
@@ -255,7 +255,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 ### grill 过程中
 
 - [ ] 不确定的问题标记为待确认。
-- [ ] 稳定术语及时写入 `CONTEXT.md`。
+- [ ] 稳定业务术语及时写入 `CONTEXT.md`，并填写 PascalCase `英文标识`。
 - [ ] 冲突术语被指出并解决。
 - [ ] 正常路径、异常路径、权限和边界都被问到。
 - [ ] 重大取舍按 ADR 三条件判断。
@@ -264,7 +264,7 @@ Ticket 需要清晰 change 目标。如果目标还模糊，先 grill。
 
 - [ ] 已确认范围和非目标。
 - [ ] 已列出待确认问题。
-- [ ] `CONTEXT.md` 没有实现细节。
+- [ ] `CONTEXT.md` 没有类全名、表名或接口路径；业务术语有英文标识词干。
 - [ ] ADR 只记录必要决定。
 - [ ] 已明确下一步是 discovery、Spec、OpenAPI、Ticket 还是实现路由。
 

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

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "wikiRoot": "wiki",
-  "compiledAt": "2026-08-23T09:28:35.779Z",
-  "gitCommit": "4195fb4f4e5b1f8cf2fada485ed890526d469385",
+  "compiledAt": "2026-08-24T03:05:31.972Z",
+  "gitCommit": "de5a8f193f84d44c0b8c9b8dc5da501e60846e66",
   "profile": "documents",
   "sources": [
     {
@@ -11,7 +11,7 @@
       "livePath": "AGENTS.md",
       "rawPath": "raw/AGENTS.md",
       "role": "copy",
-      "sha256": "8b4616521833aae117e46a1ad07aa0fadbee180e95708d239062a67f31acc33d"
+      "sha256": "7cfed91a8e530606f1140acf5156acae1b4c7b16ae13c3d960b8905a61fabd0d"
     },
     {
       "id": "CONTEXT.md",
@@ -19,7 +19,7 @@
       "livePath": "CONTEXT.md",
       "rawPath": "raw/CONTEXT.md",
       "role": "copy",
-      "sha256": "4e8cf91a8d051edcce45867edc38e2d6d68d2e94577d069d8307ebc58d05a211"
+      "sha256": "83c31282a9fcfa5ca22e391045fb482cba87d1fb8ae1f31bd93a6224add462d4"
     },
     {
       "id": "README.md",
@@ -83,7 +83,7 @@
       "livePath": "docs/agents/yss-skill-registry.yaml",
       "rawPath": "raw/yss-skill-registry.yaml",
       "role": "copy",
-      "sha256": "5859cc6ef663fb4939caab03083d4036ac5936886c9e4be7a99701d5d035047d"
+      "sha256": "b265d25be9bc80166e289ca1702337457ac839aec50290d1ba078c7a100cd474"
     },
     {
       "id": "issue-tracker.md",
@@ -123,7 +123,7 @@
       "livePath": "docs/templates/spec-template.md",
       "rawPath": "raw/spec-template.md",
       "role": "copy",
-      "sha256": "296bffe6cddbd03c6b7e513e777a176cce5688e1d2e36ce1b63d4f810fe3877d"
+      "sha256": "10d12f0d4c7c148afd74876d057afebdf0a97b65a21cdf2b67ca14a3ce804115"
     },
     {
       "id": "vertical-slice-ticket-template.md",
@@ -131,7 +131,7 @@
       "livePath": "docs/templates/vertical-slice-ticket-template.md",
       "rawPath": "raw/vertical-slice-ticket-template.md",
       "role": "copy",
-      "sha256": "d0e47649cf2fad5fe63d0c37a878d7ada30d1c6c4b12b6b59d036f49f369dcf3"
+      "sha256": "49bec2cb6df81ab6d76d01920b52197274b39b6381c329baff360e34e64cc341"
     },
     {
       "id": "skills-lock.json",
@@ -142,7 +142,7 @@
       "extract": {
         "kind": "skill-names"
       },
-      "sha256": "df9bd8e96f575bee59d186a9d248ee5d969552cb949bafbe25ce0452e89e7a46"
+      "sha256": "8b6df90beb87c526bc2e0a71de61a2ffd1f76b96cb47e6fe87172ebd849bb45b"
     }
   ],
   "articles": [

package/template/wiki/raw/AGENTS.md

@@ -31,7 +31,7 @@ README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或
 - 所有面向业务、产品、架构、实施、审查、发布和复盘的落地文档，正文统一使用简体中文。
 - 英文专有名词、代码标识、API 路径、schema、类名、方法名、枚举值、错误码、命令、文件名和协议 metadata 保持原样。
 - 新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。过时术语和技能名只能出现在迁移指南或明确标注的旧项目上下文。
-- 实施前读取 `CONTEXT.md`；与词汇或 ADR 冲突时立即指出并先解决冲突。
+- 实施前读取 `CONTEXT.md`。业务术语必须已有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形。改中文术语或英文标识都先回写 `CONTEXT.md`。与词汇或 ADR 冲突时立即指出并先解决冲突。
 
 ## 4. `template-source` 模板维护路由
 
@@ -78,7 +78,7 @@ README、用户指南、根目录 `CLAUDE.md` 和其他说明文档只引用或
 |---|---|
 | 技术事实、标准、第三方 API 或框架行为影响决策 | `research` 或等价的一手资料记录 |
 | 竞品、市场或用户口碑事实 | `competitive-intelligence` |
-| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；产出前后用 `antd` CLI 记录 Ant Design v6 与浏览器验证事实 |
+| UI 设计、原型、组件或主题 | `yss-design-system` 后使用 `yss-prototype-stage`；Codex 再路由 `product-design:index`，其他 Agent 交付等价合同资产；原型产出前后用 `yss-antd-design` 记录 Ant Design v6 事实与浏览器验证。前端代码落地改用 `yss-ui`，不要继续调用 `yss-antd-design` |
 | Bug、测试失败或性能回退 | `diagnosing-bugs` 建立可复现反馈，再用 `tdd` |
 | merge / rebase 冲突 | `resolving-merge-conflicts` |
 | 架构治理、难测模块或深模块设计 | `improve-codebase-architecture` / `codebase-design` |

package/template/wiki/raw/CONTEXT.md

@@ -1,72 +1,80 @@
 # 领域上下文
 
-本文档是项目的领域词汇表，只记录业务语言和协作概念，不记录实现细节、计划草稿或架构说明。
+本文档是项目的领域词汇表，只记录稳定业务语言和协作概念，不记录实现细节、计划草稿或架构说明。
 
-## 术语表
-
-| 术语 | 含义 | 避免 / 备注 |
-|---|---|---|
-| Agent | 执行特定工作流步骤的 AI 协作者。 | 不要与人工审查者混用。 |
-| 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；旧规格称谓只在迁移记录中保留。 |
-| Spec Delta | 记录相对于既有冻结 Spec 基线的 `ADDED / MODIFIED / REMOVED` 行为、验收场景和测试映射。 | 不用于全新产品或全新模块，也不替代完整 Spec、OpenAPI 或架构资产。 |
-| Ticket | 在追踪平台上承载功能生命周期或可实现工作单元的通用追踪对象。 | GitHub Issues / GitLab Issues 是具体平台对象名称；领域资产统一称为 Ticket。 |
-| 功能父 Ticket | 汇总一个功能从 Spec 到契约冻结的阶段状态、资产链接、审查结论和阻塞项的 Ticket。 | 不作为 Agent 直接实现的垂直切片。 |
-| 垂直切片 Ticket | 契约冻结后生成的可独立验证实现单元，记录范围、阻塞关系、验收标准和验证证据。 | 只有通过必要门禁并具备直接实现条件时才能标记 `ready-for-agent`。 |
-| `ready-for-human` | 表示 Spec、设计、契约草案或其他资产仍需人工审查或确认的流程状态。 | 此状态不表示可以直接进入实现。 |
-| `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` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
-| 生命周期产物 | 生命周期工作单元形成并持久化、可被审查和引用的业务或工程结果。 | 文件存在不代表产物已经批准或仍然新鲜。 |
-| 工作单元 | 具有明确输入、输出、允许动作和完成条件的一次有界执行。 | 不等同于主阶段或门禁；一个主阶段可以包含多个工作单元。 |
-| 执行证据 | 用于证明工作单元结果、门禁裁决或完成结论的可读取引用和实际验证记录。 | 口头声明、计划执行的命令或无法解析的引用不构成执行证据。 |
-| 单一事实来源（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 或其他易变业务配置。 |
+`英文标识` 是 PascalCase 词干，不是英语释义。`## 业务术语` 必须填写该列；`## 流程术语` 填 `—`。代码类型名、字段名和契约 property 由该词干变形：类名 = 词干 + YSS 工程后缀；字段与 JSON property 为 camelCase；数据库列为 snake_case；枚举常量为 UPPER_SNAKE。工程后缀以 YSS skill 和当前工程惯例为准，不作为领域词写入本表。JSON 与 Java 字段不一致时，以 DTO wire shape / OpenAPI 为准，不在本表另开列。改中文术语或英文标识都是统一语言变更，必须先回写本表。`避免 / 备注` 同时记录禁用中文和禁用英文别名。
 
 只有在计划、分诊、调试或架构讨论中明确沉淀出稳定语言时，才新增术语。
+
+## 流程术语
+
+模板源与生命周期协作概念放在本节。`英文标识` 填 `—`，不回溯补译。
+
+| 术语 | 含义 | 英文标识 | 避免 / 备注 |
+|---|---|---|---|
+| Agent | 执行特定工作流步骤的 AI 协作者。 | — | 不要与人工审查者混用。 |
+| 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；旧规格称谓只在迁移记录中保留。 |
+| Spec Delta | 记录相对于既有冻结 Spec 基线的 `ADDED / MODIFIED / REMOVED` 行为、验收场景和测试映射。 | — | 不用于全新产品或全新模块，也不替代完整 Spec、OpenAPI 或架构资产。 |
+| Ticket | 在追踪平台上承载功能生命周期或可实现工作单元的通用追踪对象。 | — | GitHub Issues / GitLab Issues 是具体平台对象名称；领域资产统一称为 Ticket。 |
+| 功能父 Ticket | 汇总一个功能从 Spec 到契约冻结的阶段状态、资产链接、审查结论和阻塞项的 Ticket。 | — | 不作为 Agent 直接实现的垂直切片。 |
+| 垂直切片 Ticket | 契约冻结后生成的可独立验证实现单元，记录范围、阻塞关系、验收标准和验证证据。 | — | 只有通过必要门禁并具备直接实现条件时才能标记 `ready-for-agent`。 |
+| `ready-for-human` | 表示 Spec、设计、契约草案或其他资产仍需人工审查或确认的流程状态。 | — | 此状态不表示可以直接进入实现。 |
+| `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` 及原因，不生成空文档；门禁不是产物、工作单元或证据的统称。 |
+| 生命周期产物 | 生命周期工作单元形成并持久化、可被审查和引用的业务或工程结果。 | — | 文件存在不代表产物已经批准或仍然新鲜。 |
+| 工作单元 | 具有明确输入、输出、允许动作和完成条件的一次有界执行。 | — | 不等同于主阶段或门禁；一个主阶段可以包含多个工作单元。 |
+| 执行证据 | 用于证明工作单元结果、门禁裁决或完成结论的可读取引用和实际验证记录。 | — | 口头声明、计划执行的命令或无法解析的引用不构成执行证据。 |
+| 单一事实来源（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 或其他易变业务配置。 |
+
+## 业务术语
+
+`project-instance` 在本节新增产品对象。每一行必须有 PascalCase `英文标识`；缺该列视为统一语言未冻结。模板源不放虚构业务行。

package/template/wiki/raw/skills-lock-names.md

@@ -48,6 +48,7 @@ Derived names only. Do not copy hashes, paths, or the lock file.
 - `writing-for-agents`
 - `writing-fragments`
 - `writing-shape`
+- `yss-antd-design`
 - `yss-api-integration`
 - `yss-application`
 - `yss-audit-log`

package/template/wiki/raw/spec-template.md

@@ -73,7 +73,7 @@ owner: ai
 
 | 检查项 | 是 / 否 | 说明 / 处理 |
 |---|---|---|
-| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` |
+| 是否新增或改变统一语言 / 核心术语 |  | 需要回写 `CONTEXT.md` 的中文术语和 PascalCase `英文标识` |
 | 是否新增或改变限界上下文 / 模块边界 |  | 需要在产品总体设计中完成 Strategic DDD Check |
 | 是否改变上下文间协作关系 |  | 说明上游 / 下游 / 防腐层 / 共享内核关系 |
 | 是否新增或改变聚合、不变量、状态机 |  | 需要在系统概要设计 / 数据架构中完成 Tactical DDD Check |

package/template/wiki/raw/vertical-slice-ticket-template.md

@@ -129,4 +129,4 @@ Status: ready-for-human
 - [ ] 已回勾当前 `contract_id` / `contract_version`、全部工作单元和对应 `YSS Skill Execution Result`
 - [ ] 实际 changed files 均在合同允许路径内，预期证据齐全，验证结果包含执行时间
 - [ ] `new_impacts`、`drift`、`violation` 和重路由状态均有明确结论，合同未处于 `stale`
-- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR
+- [ ] 如领域或架构决策变化，已更新 `CONTEXT.md` / ADR；新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干

package/template/wiki/raw/yss-skill-registry.yaml

@@ -283,6 +283,12 @@ skills:
     instance_default_discoverable: false
     aliases: []
     impacts: [writing]
+  - id: yss-antd-design
+    layer: specialist
+    maturity: supported
+    instance_default_discoverable: false
+    aliases: []
+    impacts: [prototype]
   - id: yss-api-integration
     layer: specialist
     maturity: supported

package/template/wiki/wiki/Agent/345/205/245/345/217/243/350/247/204/345/210/231.md

@@ -4,7 +4,7 @@
 
 单一事实来源不得在说明文档里重复定义：领域与流程词汇以 `CONTEXT.md` 为准；Agent 入口以 `AGENTS.md` 为准；主阶段、门禁、产物、工作单元、证据和稳定 ID 以 `docs/process/lifecycle-registry.yaml` 为准（`docs/process/lifecycle-artifact-map.md` 只是派生阅读视图）；影响面触发与 `not-applicable` 以 `docs/process/harness-process-tailoring.md` 为准（见 [[影响面分诊与流程裁剪]]）；技能清单、来源、版本、哈希和投影目标以 `skills-lock.json` 为准。`docs/agents/yss-skill-registry.yaml` 当前 `status: shadow`，不作为 Router / 生命周期运行时入口。
 
-落地文档正文统一使用简体中文；英文专有名词、路径、schema、命令与协议 metadata 保持原样。新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。功能父 Ticket 汇总阶段证据；Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`；只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket 才能使用 `ready-for-agent`（见 [[Ticket与流程状态]]）。
+落地文档正文统一使用简体中文；英文专有名词、路径、schema、命令与协议 metadata 保持原样。业务术语必须已有 PascalCase `英文标识`；代码类型 / 字段与契约 property 使用该词干按 `CONTEXT.md` 文首规则变形；改中文术语或英文标识都先回写 `CONTEXT.md`。新流程统一使用 Spec、Ticket、`to-spec`、`to-tickets`。功能父 Ticket 汇总阶段证据；Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产使用 `ready-for-human`；只有通过必要门禁、阻塞边已清除并具备直接实现条件的垂直切片 Ticket 才能使用 `ready-for-agent`（见 [[Ticket与流程状态]]）。
 
 进入实现前先读 `docs/process/implementation-repo-integration.md` 并登记实现仓库，再由 `yss-router` 编译最小 skill 集合与当前实现合同（见 [[YSS路由与合同编译]]）。当前仓库默认是研发管理仓库，运行时代码优先在独立实现仓库；只有用户明确选择时才用 `apps/backend/<project>/` 或 `apps/frontend/<project>/`。`app/backend/`、`app/frontend/` 禁止作为工程输出（见 [[实现仓库与跨仓库契约]]）。前端测试、type-check 与构建优先 `pnpm`；后端校验、测试与编译优先项目根 `./mvnw`；不要默认 `npm` / `yarn` 或裸 `mvn`。根目录 `CLAUDE.md` 只引用 `AGENTS.md`，不是第二套入口规则。
 

package/template/wiki/wiki/Spec/345/237/272/347/272/277.md

@@ -6,7 +6,7 @@ Spec 是记录用户问题、解决方案、用户故事、关键决策、验收
 
 模板 `docs/templates/spec-template.md` 的 frontmatter 含 `pipeline`、`stage`、`status`、`owner`；`status` 默认 `ready-for-human`，`stage` 默认 `open`，`owner` 默认 `ai`。正文先挂功能父 Ticket，再写问题陈述、解决方案、用户故事、功能需求、非功能需求、验收标准（gherkin）、产品总体设计 / 功能架构、OpenAPI 影响、DDD 影响判断、测试决策、AI / 人工审查点、非目标范围和风险。Local 路径约定为 `docs/.scratch/<feature>/spec.md`，父 Ticket 为 `docs/.scratch/<feature>/parent-ticket.md`。
 
-验收标准写可观察结果，不写实现步骤。测试决策要标明主要测试 seam、代码库中的相似测试，以及单元 / 领域行为、API / 契约、前端组件、E2E 关键路径是否必需。DDD 影响判断只做轻量检查：统一语言变化回写 `CONTEXT.md`；限界上下文变化在产品总体设计中补 Strategic DDD Check；聚合、不变量或状态机变化在系统概要设计 / 数据架构中补 Tactical DDD Check。未触发时不另开流程阶段。
+验收标准写可观察结果，不写实现步骤。测试决策要标明主要测试 seam、代码库中的相似测试，以及单元 / 领域行为、API / 契约、前端组件、E2E 关键路径是否必需。DDD 影响判断只做轻量检查：统一语言变化回写 `CONTEXT.md` 的中文术语和 PascalCase `英文标识`；限界上下文变化在产品总体设计中补 Strategic DDD Check；聚合、不变量或状态机变化在系统概要设计 / 数据架构中补 Tactical DDD Check。未触发时不另开流程阶段。
 
 存在 UI 影响时，Spec 才强制低保真页面草图、状态矩阵、高保真 HTML 原型和用户确认；否则记录 `not-applicable` 及原因。UI 影响不等于 [[产品设计影响与原型]]：只有主流程、导航、权限体验、异常 / 恢复、状态流转或 API 反推才构成产品设计影响。OpenAPI 影响在 Spec 中先勾选「无 / 需要 API 影响分析 / 需要 review-only OpenAPI Draft」，Draft 路径为 `docs/.scratch/<feature>/api/<feature>.yaml`；Draft 在 Freeze 前只供评审，见 [[OpenAPI契约]]。
 

package/template/wiki/wiki/log.md

@@ -42,3 +42,10 @@ lint 脚本改为失败跨路径 wikilink、校验 manifest sha256，并要求 H
 - unmapped: (none)
 
 同步 raw 中的 `AGENTS.md` / `CONTEXT.md`，重放 `skill-names` 摘录（内容未变）。刷新 [[Agent入口规则]]、[[LLM Wiki]] 与 [[模板总览]] 中与 ingest / refresh 分界相关的句子；新增基础设施 `concept-table.md`；`CLAUDE.md` 补 Status / INGEST。未改其余命中页：AGENTS 仅增 ingest 入口句，CONTEXT 仅澄清 ingest 不替代权威源，锁文件只变 `effectiveHash`。
+
+## [2026-08-24] REFRESH | CONTEXT 英文标识词干
+- changed: AGENTS.md, CONTEXT.md, spec-template.md, vertical-slice-ticket-template.md, yss-skill-registry.yaml, skills-lock.json
+- articles: Agent入口规则, Spec基线, 垂直切片Ticket, 模板总览, 复盘与权威资产修订
+- unmapped: (none)
+
+同步 raw 中的 `CONTEXT.md` / `AGENTS.md` / Spec 与垂直切片模板。刷新上述文章中与 PascalCase `英文标识` 词干相关的句子。未改其余命中页。`yss-skill-registry.yaml` 与 `skills-lock.json` 为既有 live 漂移，仅对齐 raw / hash（补入 `yss-antd-design`），不改技能投影文章。

package/template/wiki/wiki//345/236/202/347/233/264/345/210/207/347/211/207Ticket.md

@@ -10,7 +10,7 @@ Spec 初稿、产品设计、原型、OpenAPI Draft 和待冻结资产一律使
 
 工作单元必须写验收行为、主 / 辅 skill、`behavior-tdd` 或 `controlled-generation`、允许写路径、预期证据和验证命令。业务规则、状态机、事务、权限、错误映射、复杂查询和用户可见交互必须 `behavior-tdd`；`controlled-generation` 只覆盖机械脚手架、样板、冻结客户端或配置，并记录 exception reason。涉及后端时必须填写 Backend 合同与 skill 表，不得只写「符合 YSS」。出现 `drift`、`violation` 或非空 `new_impacts` 时暂停受影响工作单元，不得先完成代码再补合同。
 
-完成定义要求：实现与测试通过，调试 / 原型代码已移除，合同与 `YSS Skill Execution Result` 已回勾，实际 changed files 均在允许路径内，验证结果含执行时间，重路由状态有明确结论且合同未 `stale`。路径越界、证据缺失、未执行验证时停止实现并重新路由，见 [[条件强制门禁]] 与 [[实现仓库与跨仓库契约]]。整条链路属于 [[产品研发生命周期]] 的 Ticket 正式化与垂直切片实现阶段。
+完成定义要求：实现与测试通过，调试 / 原型代码已移除，合同与 `YSS Skill Execution Result` 已回勾，实际 changed files 均在允许路径内，验证结果含执行时间，重路由状态有明确结论且合同未 `stale`。领域或架构决策变化时更新 `CONTEXT.md` / ADR，新增业务术语含 PascalCase `英文标识`，代码与契约字段能追溯到该词干。路径越界、证据缺失、未执行验证时停止实现并重新路由，见 [[条件强制门禁]] 与 [[实现仓库与跨仓库契约]]。整条链路属于 [[产品研发生命周期]] 的 Ticket 正式化与垂直切片实现阶段。
 
 ## 来源
 

package/template/wiki/wiki//345/244/215/347/233/230/344/270/216/346/235/203/345/250/201/350/265/204/344/272/247/344/277/256/350/256/242.md

@@ -4,7 +4,7 @@
 
 复盘与发布工作单元是 `work-unit.release-and-retrospective`：输入已审查候选、发布窗口和回滚点；输出发布 / 回滚证据和复盘记录；完成条件为人工发布裁决、fresh verification 和治理回流均完成（见 [[Fresh验证与独立审查]] 与 [[产品研发生命周期]]）。
 
-复盘输入包括验证证据、审查报告、Ticket 证据与 Git checkpoint（见 [[Ticket与流程状态]]）。落地文档可用 `docs/templates/retro-report-template.md`，包含「做得好的地方」「需要改进的地方」「改进动作」「沉淀去向」。发现回流到对应单一事实来源：领域词汇修订 `CONTEXT.md`，入口与硬门禁修订 `AGENTS.md`，主阶段 / 门禁 / 工作单元修订 `docs/process/lifecycle-registry.yaml`，影响面与 `not-applicable` 修订 `docs/process/harness-process-tailoring.md`，技能问题进入 `maintaining-skills` 并更新 `skills-lock.json`（见 [[模板维护流程]] 与 [[条件强制门禁]]）。
+复盘输入包括验证证据、审查报告、Ticket 证据与 Git checkpoint（见 [[Ticket与流程状态]]）。落地文档可用 `docs/templates/retro-report-template.md`，包含「做得好的地方」「需要改进的地方」「改进动作」「沉淀去向」。发现回流到对应单一事实来源：领域词汇修订 `CONTEXT.md`（含英文标识词干），入口与硬门禁修订 `AGENTS.md`，主阶段 / 门禁 / 工作单元修订 `docs/process/lifecycle-registry.yaml`，影响面与 `not-applicable` 修订 `docs/process/harness-process-tailoring.md`，技能问题进入 `maintaining-skills` 并更新 `skills-lock.json`（见 [[模板维护流程]] 与 [[条件强制门禁]]）。
 
 复盘修订仍按影响面分诊：命中触发条件才生成对应资产，未命中只记录 `not-applicable` 及原因，不生成空文档（见 [[影响面分诊与流程裁剪]]）。跨仓库契约偏差须同步到外部仓库责任边界，任一参与仓库未完成契约对齐和集成验证时，不得单独声称整体可发布（见 [[实现仓库与跨仓库契约]]）。
 

package/template/wiki/wiki//346/250/241/346/235/277/346/200/273/350/247/210.md

@@ -6,7 +6,7 @@ YSS Spec Project Template 是 Matt Pocock Engineering Skills × YSS × OpenAPI
 
 任务开始必须先读根目录 `yss-project.yaml`。当前仓库 `repository_mode` 为 `template-source`，走 [[模板维护流程]]，不默认生成具体产品的 Spec、原型、OpenAPI 或垂直切片 Ticket。`create-yss-spec` 创建或接管的产品仓库写入 `project-instance`，再进入 [[产品研发生命周期]]；CLI 只管理研发管理资产，不接管前后端运行时代码。身份判定细则见 [[仓库身份与路由]]。
 
-单一事实来源不得在 README 或用户指南里另写一套：领域与流程词汇以 `CONTEXT.md` 为准；Agent 入口、硬门禁与禁止事项以 `AGENTS.md` 为准（见 [[Agent入口规则]]）；主阶段、门禁、产物、工作单元、证据和稳定 ID 以 `docs/process/lifecycle-registry.yaml` 为准；技能清单、来源、版本、哈希和投影目标以 `skills-lock.json` 为准（见 [[技能投影与锁定]]）。
+单一事实来源不得在 README 或用户指南里另写一套：领域与流程词汇以 `CONTEXT.md` 为准（中文术语加 PascalCase `英文标识` 词干，见 [[Agent入口规则]]）；Agent 入口、硬门禁与禁止事项以 `AGENTS.md` 为准（见 [[Agent入口规则]]）；主阶段、门禁、产物、工作单元、证据和稳定 ID 以 `docs/process/lifecycle-registry.yaml` 为准；技能清单、来源、版本、哈希和投影目标以 `skills-lock.json` 为准（见 [[技能投影与锁定]]）。
 
 `.agents/skills` 是跨 Agent 共享技能的权威内容；各平台 root 中的共享技能是生成投影。模板发布阻断门禁是 `scripts/verify-template`，且与外部 `create-yss-spec` 的跨仓库契约未完成集成验证时不得声称可发布（见 [[模板发布门禁与验证]]）。本地知识库的 init / refresh / rebuild，或要把研究结果落成持久 wiki，走 [[LLM Wiki]]（落成持久 wiki 用 `ingest`；已映射 live 源变了用 `refresh`）；一次性一手资料笔记仍走 `research`。
 

package/template.snapshot.json

@@ -3,14 +3,14 @@
   "templateName": "yss-spec-project-template",
   "templateSource": "github:iloveZzz/yss-spec-project-template",
   "templateRepository": "https://github.com/iloveZzz/yss-spec-project-template.git",
-  "requestedRef": "7f6158b5f4997c81ebc0440366938a6d37484d76",
-  "templateCommit": "7f6158b5f4997c81ebc0440366938a6d37484d76",
+  "requestedRef": "986ded5d78e2d0bd816f7f8038aec6ef2d7c6d0a",
+  "templateCommit": "986ded5d78e2d0bd816f7f8038aec6ef2d7c6d0a",
   "encodedPaths": {
     ".codex/skills/data-analytics/.gitignore": ".codex/skills/data-analytics/__yss_dotfile__.gitignore",
     ".codex/skills/product-design/.npmignore": ".codex/skills/product-design/__yss_dotfile__.npmignore",
     ".codex/skills/product-design/templates/prototype/.npmrc": ".codex/skills/product-design/templates/prototype/__yss_dotfile__.npmrc",
     ".gitignore": "__yss_dotfile__.gitignore"
   },
-  "snapshotHash": "968c9df9d552c8041e32423c0c78a471e216859cc50b03660f79dbdf606149f1",
-  "generatedAt": "2026-08-23T14:47:09.357Z"
+  "snapshotHash": "e15b05f44ef09f9953338c6846345c1197d615f7d31370deb0b3c5cdc3195376",
+  "generatedAt": "2026-08-24T05:35:24.742Z"
 }