@captain_z/zsk-skills 0.1.0

package/sdlc/verify/SKILL.md

@@ -0,0 +1,181 @@
+---
+name: zsk:verify
+description: Hard merge-to-main gate ("evidence before assertion") — DoD fully
+  green, FR coverage matrix complete, AC checklist ticked with links, validation
+  records with reproducible evidence. Stage 6 of the 7-stage SDLC. This is the
+  contract-view; the code-view is zsk:reviewing.
+category: stage
+domain: sdlc
+tier: core
+stage: 6
+variants:
+  - feature
+  - bugfix
+  - refactor
+related:
+  - ../reviewing/SKILL.md
+  - ../archive/SKILL.md
+  - ../dor-dod/SKILL.md
+  - ../task-evidence/SKILL.md
+  - ../../frontend/nfr-web/SKILL.md
+triggers:
+  - acceptance verification
+  - definition of done
+  - FR coverage matrix
+  - evidence before assertion
+  - AC checklist
+  - before merging
+---
+
+# Stage 6: Verify
+
+> **阶段定位**：验收 - Acceptance Verification
+> **回答的问题**：**做了对的东西吗**？是否满足 `spec.md` 的 AC / FR / NFR？证据是否足以支持"通过"？
+> **与 Reviewing 的边界**：Reviewing 看"代码写对了吗"（diff 视角），Verify 看"是否满足契约"（契约视角）。**证据来源不同**：Reviewing 的证据是 diff + comment；Verify 的证据是**可追溯的命令输出 / 截图 / 报告**。
+> **参考规范**：Scrum DoD、Acceptance Testing、FR 覆盖矩阵
+> **吸收硬原则**：
+> - **证据先于断言**（Superpowers `verification-before-completion`）— **最严格**的一条：未跑过的命令不得声称"通过"
+> - 所有"通过 / 完成 / 修复"的声明都必须附带**可追溯证据链接**
+
+## Skill 映射
+
+| 场景 | Primary Skill |
+| --- | --- |
+| 完成前自验 | `superpowers:verification-before-completion` |
+| 自审 | `self-review` / `check` |
+| 系统 QA | `qa` / `qa-only` |
+| 视觉 QA（前端） | `design-review` |
+| 性能 QA（前端） | `benchmark` |
+| 独立二审 | `codex review`（pass/fail 门禁模式） |
+
+## 变更类型差异
+
+| 类型 | Verify 侧重 |
+| --- | --- |
+| **Feature** | DoD 全绿 + FR 覆盖矩阵完整 + NFR 基线达标 |
+| **Bugfix** | 原复现步骤走通 + 回归套件全绿 + 邻近场景未回归 |
+| **Refactor** | 行为不变证据链 + 性能量化对照 + 包体积差 ≤ ±2% |
+
+## 证据先于断言（Iron Law）
+
+这是本阶段最硬的一条规则：
+
+- **所有"通过 / 完成 / 修复"声明都必须附带命令输出 / 报告链接 / 截图**
+- **未跑过**的命令**不得**声称"通过"
+- **从未跑过**的测试**不得**声称"绿"
+- **从未看过**的报告**不得**声称"达标"
+
+违反 = 门禁失败 = 禁止合并主干。
+
+## 1. Definition of Done（验收清单）
+
+> DoR 在 `zsk:coding`（进入 coding 阶段前的门禁）；DoD 在这里（合并主干前的门禁）。通用 + 变更类型专用清单见 [`zsk:dor-dod`](../dor-dod/SKILL.md)。
+
+### 通用 DoD
+- [ ] 代码通过 `zsk:reviewing` 流程并 Approve
+- [ ] 单元测试通过且覆盖关键分支
+- [ ] 集成 / E2E 测试通过（如适用）
+- [ ] `lint` / `type-check` / `build` 零 error
+- [ ] 相关文档已更新（`docs/{module}/tasks.md` 勾选到位）
+- [ ] **FR 覆盖矩阵**所有 P0 FR 都有"覆盖任务 + 验收证据"（见 [`zsk:task-evidence`](../task-evidence/SKILL.md)）
+- [ ] **校验记录**每行有证据链接
+
+> 前端项目补：视觉回归 / i18n / a11y / CWV 见 [`frontend/nfr-web`](../../frontend/nfr-web/SKILL.md)。
+
+### Bugfix 专用
+- [ ] 原复现步骤按 `proposal.md` 的步骤执行 → 不再复现（截图 / 录屏）
+- [ ] 新增回归测试在主干绿
+- [ ] 相邻场景无回归（无"按下葫芦浮起瓢"）
+- [ ] Changelog 更新 `Fixed` 章节
+- [ ] P0 / P1 → 进入 `zsk:archive` 的 Postmortem
+
+### Refactor 专用
+- [ ] 所有现有测试全绿（含 Characterization）
+- [ ] 视觉 / 性能 / 包体积对照无回退
+- [ ] 对外契约零变化
+- [ ] Changelog 仅写 `Changed` / `Removed`，**不能**写 `Added` / `Fixed`
+
+## 2. FR 覆盖矩阵（交叉引用闭环）
+
+> 模板与规则见 [`zsk:task-evidence`](../task-evidence/SKILL.md)。本阶段的核心产出，`spec.md` 的 FR / NFR 列表完整复制过来，每条必须有"覆盖任务 + 验收证据"。
+
+**规则**：
+- 每条 Spec 的 FR / NFR 都必须有至少一条覆盖任务 + 一条验收证据
+- 废弃的 FR 保留编号并标注 `(废弃)`，不可删除
+- 未覆盖的 FR = DoD 未达 = 不可合并
+
+## 3. AC 勾选（BDD 场景验证）
+
+`spec.md` 的 Acceptance Criteria 清单，在本阶段**逐条勾选 + 附证据**：
+
+```md
+## Acceptance Verification
+
+| AC 编号 | 场景 | 状态 | 证据 |
+| --- | --- | --- | --- |
+| AC-1 | Happy path：... | ✅ | {测试报告 / 录屏链接} |
+| AC-2 | Edge case：... | ✅ | {截图链接} |
+| AC-3 | Error：... | ✅ | {截图链接} |
+```
+
+每条 AC 对应至少一条可执行测试或手工回归证据。证据链接必须**可点开重现**。
+
+## 4. 校验记录（门禁证据）
+
+每个门禁一行，**每行必须有证据链接**：
+
+| 门禁 | 结果 | 证据链接 |
+| --- | --- | --- |
+| lint | ✅ | {CI 链接} |
+| type-check | ✅ | {CI 链接} |
+| 单元测试 | ✅ | {覆盖率报告} |
+| 集成测试 | ✅ | {链接} |
+| E2E 测试 | ✅ | {报告链接} |
+| 安全（依赖扫描） | ✅ | {audit 报告} |
+
+> 前端额外：视觉回归 / a11y / i18n / 性能 / 包体积对照 → 见 [`frontend/nfr-web`](../../frontend/nfr-web/SKILL.md)
+
+## 5. 变更类型专项验证
+
+### Feature — 端到端回路
+
+1. 按 `spec.md` 的 BDD 场景手动或 E2E 跑一遍
+2. NFR 基线逐项找证据
+3. FR 覆盖矩阵补完
+
+### Bugfix — 复现清零
+
+1. `git checkout` 到修复前 → 原复现步骤触发 bug（录屏）
+2. `git checkout` 到修复后 → 同样步骤不再触发（录屏）
+3. 回归套件 + 相邻场景全绿
+4. P0 / P1 → Postmortem 入 `zsk:archive`
+
+### Refactor — 行为不变证据链
+
+| 对照项 | 重构前 | 重构后 | 差 |
+| --- | --- | --- | --- |
+| 所有测试 | ✅ | ✅ | 0 |
+| 视觉快照 | {截图} | {截图} | 0 |
+| 性能评分 | {分数} | {分数} | ≥ 0 |
+| 包体积 | {KB} | {KB} | ≤ ±2% |
+| 对外契约 | 列 | 列 | 无新增 / 删除 |
+
+## 6. 工具组合建议（按栈）
+
+| 场景 | 通用 | 前端示例 |
+| --- | --- | --- |
+| 自动化 QA | `qa` / `qa-only` skill | 同 |
+| 视觉一致性 | — | `design-review` skill |
+| 性能基线对照 | — | `benchmark` skill（Lighthouse）|
+| 独立 AI 二审 | `codex review` | 同 |
+| 真实环境验证 | 按栈选运行环境工具 | `browse` / `gstack` / `connect-chrome` |
+
+## 质量门禁（进入 `zsk:archive` 前）
+
+- [ ] DoD 全绿
+- [ ] FR 覆盖矩阵完整（Spec 每条 P0 FR 都有任务 + 证据）
+- [ ] AC 逐条勾选，每条有证据
+- [ ] 校验记录全绿，每行有证据链接
+- [ ] 所有声明均满足"证据先于断言"
+- [ ] 变更类型专项验证通过
+- [ ] 前端项目：`frontend/nfr-web` 的专项证据齐全

package/system/adr/SKILL.md

@@ -0,0 +1,169 @@
+---
+name: zsk:adr
+description: Cross-module long-lived architectural decision record — context,
+  decision, rationale, alternatives considered, and consequences. Produces
+  docs/system/adrs/ADR-NNNN-{slug}.md. Not for single-module implementation
+  choices.
+category: resource
+domain: system
+tier: optional
+related:
+  - ../architecture/SKILL.md
+  - ../../sdlc/design/SKILL.md
+  - ../../sdlc/archive/SKILL.md
+triggers:
+  - architecture decision record
+  - ADR template
+  - MADR
+  - cross-module decision
+  - tech selection
+  - deprecated superseded
+---
+
+# System: ADR（架构决策记录模板）
+
+> **定位**：跨模块、长生命周期、可追溯的系统级决策
+> **参考规范**：Michael Nygard《Documenting Architecture Decisions》、MADR（Markdown Any Decision Records）
+> **填充位置**：`docs/system/adrs/ADR-NNNN-{kebab-slug}.md`（NNNN 从 0001 递增，不复用不跳号）
+
+## 什么算 ADR
+
+**适合 ADR 的决策**：
+
+- 跨模块的技术选型（状态管理 / UI 库 / 构建工具）
+- 系统架构变更（拆分模块 / 替换依赖 / 升级主版本）
+- 工程约定的系统级变化（状态管理库选型 / 统一 commit 规范 / API 契约来源）
+- 有替代方案、需要权衡、具有"宪法"性质的选择
+
+**不适合 ADR 的**（放 `design.md` 或 `../standards/code-standards.md`）：
+
+- 单模块内部实现选择
+- 代码风格细节（命名 / 格式）
+- 临时方案 / 实验性改动
+
+## ADR 生命周期
+
+```text
+Proposed → Accepted → (optional) Deprecated / Superseded by ADR-N
+```
+
+| 状态 | 含义 |
+| --- | --- |
+| `Proposed` | 已起草，待评审 |
+| `Accepted` | 已批准并生效 |
+| `Deprecated` | 不再推荐，但未被替代 |
+| `Superseded by ADR-N` | 被新 ADR 取代 |
+| `Rejected` | 评审后放弃（保留记录） |
+
+**ADR 不可修改**（除状态字段和"后续说明"）。决策需要变化时写新 ADR 并标注 Superseded。
+
+## 模板
+
+```md
+# ADR-{NNNN}：{决策名}
+
+> 状态：Proposed / Accepted / Deprecated / Superseded by ADR-{N} / Rejected
+> 日期：{YYYY-MM-DD}
+> 提案人：{姓名}
+> 评审人：{列表}
+> 影响范围：全项目 / {模块列表}
+
+## 上下文（Context）
+
+{什么问题、什么触发、为什么现在需要决策}
+
+## 决策（Decision）
+
+{选择的方案，单行能讲清更好}
+
+## 理由（Rationale）
+
+{为什么选这个，关键权衡依据}
+
+## 替代方案（Alternatives Considered）
+
+### A. {方案名}（选定 / 放弃）
+
+- **做法**：
+- **优势**：
+- **劣势**：
+- **为什么{选 / 放弃}**：
+
+### B. {方案名}（放弃）
+
+### C. {方案名}（放弃）
+
+## 后果（Consequences）
+
+### 正面
+- ...
+
+### 负面 / 成本
+- ...
+
+### 需要后续跟进
+- [ ] {项}：负责人 {姓名}，期限 {日期}
+
+## 合规约束（约束哪些文件 / 规范）
+
+- `standards/{x}.md`：{新增 / 修改的约束}
+- `SYSTEM-SPEC.md`：{索引更新}
+- 模块 `design.md` 的 ADR：{约束模块级决策需引用本 ADR}
+
+## 后续说明（Updates）
+
+> 本节可追加。原决策主体不修改。
+
+- {YYYY-MM-DD}：{补充说明}
+```
+
+## 编号规则
+
+- 从 `ADR-0001` 开始
+- 4 位数字，左补零
+- 被 Rejected / Deprecated 的 ADR **也占用编号**（不复用）
+- 文件名：`ADR-NNNN-{kebab-slug}.md`（slug 与标题一致）
+
+## 索引维护
+
+`docs/system/adrs/README.md` 必须维护：
+
+```md
+# ADR Index
+
+| 编号 | 标题 | 状态 | 日期 |
+| --- | --- | --- | --- |
+| ADR-0001 | 状态管理选型 | Accepted | YYYY-MM-DD |
+| ADR-0002 | UI 组件库选型 | Accepted | YYYY-MM-DD |
+| ADR-0003 | 路由库与版本锁定 | Accepted | YYYY-MM-DD |
+| ADR-0004 | i18n 入口与多语同步 | Accepted | YYYY-MM-DD |
+| ADR-0005 | API 契约来源 | Accepted | YYYY-MM-DD |
+```
+
+## 示例 ADR（建议首批起草）
+
+新项目建议首批登记以下五类决策（具体选型由项目决定）：
+
+1. **ADR-0001**：状态管理选型（异步状态 / 共享状态 / 禁用清单）
+2. **ADR-0002**：UI 组件库选型（引用路径、Design Token 来源）
+3. **ADR-0003**：路由库与版本锁定（何时升级）
+4. **ADR-0004**：i18n 入口与多语同步规则（key 命名空间、fallback、ICU）
+5. **ADR-0005**：API 契约来源（后端事实源 / 前端自写类型等）
+
+## 与其他文件的关系
+
+| 文件 | 关系 |
+| --- | --- |
+| `SYSTEM-SPEC.md` | 摘要索引 ADR 关键决策 |
+| `system/architecture.md` | 引用 ADR 解释架构选择 |
+| `standards/*.md` | 操作规范实现 ADR 的决策 |
+| 模块 `design.md` | 模块 ADR 遵守系统 ADR 约束 |
+
+## 质量门禁
+
+- [ ] 编号连续不跳号
+- [ ] 包含 Context / Decision / Rationale / Alternatives / Consequences 五段
+- [ ] 至少列出 2 个替代方案及放弃原因
+- [ ] 影响范围明确
+- [ ] 索引已更新
+- [ ] 状态生命周期遵守（不修改已 Accepted 的主体）

package/system/architecture/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: zsk:architecture
+description: Project system architecture documentation — C4 context diagram,
+  tech stack baseline, module boundaries, routing, auth flow, data flow
+  (request/state/contract), deployment topology, related ADRs. Frontend
+  micro-frontend topology is an optional add-on section.
+category: resource
+domain: system
+tier: optional
+related:
+  - ../adr/SKILL.md
+  - ../../sdlc/design/SKILL.md
+triggers:
+  - system architecture
+  - C4 model
+  - tech stack baseline
+  - module boundaries
+  - module federation
+  - auth flow
+  - data flow
+---
+
+# System: Architecture（系统架构）
+
+> **定位**：**本项目**总体架构事实源的**模板** — 模块边界、路由、鉴权流、数据流；（可选）模块联邦拓扑
+> **填充位置**：本文件是**模板**；实际架构填到 `docs/system/architecture.md` 或并入 `SYSTEM-SPEC.md` 的架构章节
+> **参考规范**：C4 Model（Simon Brown）、4+1 架构视图（Kruchten）、ADR（Michael Nygard）
+
+## 何时需要
+
+- 新工程初始化
+- 大规模架构调整
+- 新成员 onboarding 材料
+- 跨模块决策回溯
+
+## 标准结构（通用骨架）
+
+1. 总览（Context）
+2. 技术栈与版本基线
+3. 模块边界与职责
+4. 路由策略
+5. 鉴权与权限流
+6. 数据流（请求 / 状态 / 缓存）
+7. 环境与部署拓扑
+8. 跨模块共享能力
+9. 关联 ADR
+10. **（可选 · 前端微前端场景）** 模块联邦拓扑
+
+## 最小模板
+
+```md
+# {项目} 系统架构
+
+> 版本：{YYYY-MM-DD}
+> 维护人：{姓名}
+> 关联规约：`SYSTEM-SPEC.md`
+> ADR 索引：`docs/system/adrs/`
+
+## 1. 总览（C4 Context）
+
+\`\`\`mermaid
+flowchart LR
+  User[用户] --> App[应用]
+  App --> SvcA[{domain-a} 服务]
+  App --> SvcB[{domain-b} 服务]
+\`\`\`
+
+## 2. 技术栈基线
+
+| 层 | 选型 | 版本 | 说明 |
+| --- | --- | --- | --- |
+| 框架 | `{{config.stack.framework}}` | `{{版本}}` |  |
+| 语言 | `{{config.stack.language}}` | `{{版本}}` | strict 模式 |
+| 构建 | `{{config.stack.build_tool}}` |  |  |
+| 测试框架 | `{{config.stack.test_framework}}` |  |  |
+| HTTP 客户端 | `{{config.stack.http_client}}` |  |  |
+
+> 前端额外可补：路由 / 样式 / UI 库 / 状态库等 — 见 `frontend/*` 领域的 skills。
+
+## 3. 模块边界与职责
+
+| 模块 | 职责 | 事实源 | 负责人 |
+| --- | --- | --- | --- |
+| `{module-a}` | {职责} | `docs/{module-a}/` |  |
+| `{module-b}` | {职责} | `docs/{module-b}/` |  |
+
+### 共享能力
+
+| 能力 | 位置 | 说明 |
+| --- | --- | --- |
+| 请求客户端 | `{{config.paths.services_entry}}` | 统一出口 |
+| 工具函数 | `{{config.paths.utils_root}}` | 公共纯函数 |
+
+## 4. 路由策略
+
+- 路由方案：{项目实际方案}
+- 入口：{路由文件路径}
+- 权限守卫：{策略}
+
+## 5. 鉴权与权限流
+
+\`\`\`mermaid
+sequenceDiagram
+  User->>App: 登录
+  App->>Auth: 校验凭证
+  Auth-->>App: Token + 用户信息
+  App->>API: 携带 Token 请求
+  API-->>App: 数据 / 401 / 403
+\`\`\`
+
+- Token：{存储方式}
+- 权限判断：UI 防误操作 + **后端最终校验**（见 `quality/security-owasp`）
+- 越权：401 跳登录；403 跳无权限页
+
+## 6. 数据流
+
+### 请求层
+- 入口：`{{config.stack.http_client}}`
+- 客户端：`{{config.paths.services_entry}}` 按服务域导出
+- 归一化：service 层吸收响应差异
+
+### 状态层
+- 组件本地：本地状态 API
+- 异步状态：`{{config.stack.state_async}}`（见 ADR）
+- 跨模块：`{{config.stack.state_shared}}`（见 ADR）
+
+### 契约层
+- 类型定义来自后端：`{{config.paths.api_contracts}}/{service}/`
+- 前端只同步 + 消费
+
+## 7. 环境与部署
+
+| 环境 | 用途 | 后端域名 |
+| --- | --- | --- |
+| dev | 本地开发 | `{dev-domain}` |
+| test | 集成测试 | `{test-domain}` |
+| pre | 预发 | `{pre-domain}` |
+| prod | 生产 | `{prod-domain}` |
+
+部署流水线：{Jenkins / GitHub Actions / 其他}
+
+## 8. 关联 ADR
+
+| ADR | 决策 | 状态 |
+| --- | --- | --- |
+| ADR-0001 | {决策名} | Accepted |
+| ADR-0002 | {决策名} | Accepted |
+
+## 9. （前端微前端场景）模块联邦拓扑
+
+> 仅当项目采用 Module Federation / 类似 MF 架构时填本节。
+
+### 本应用暴露
+
+| 暴露点 | 实现文件 | 消费方 |
+| --- | --- | --- |
+| `./AppEntry` | `{{config.paths.mf_expose_entry}}` | Shell 主应用 |
+
+### 本应用消费
+
+| 远端 | 来源 | 用途 |
+| --- | --- | --- |
+
+### 拓扑图
+
+\`\`\`mermaid
+flowchart LR
+  Shell[Shell 主应用] --> AppA[应用 A 微前端]
+  Shell --> AppB[应用 B 微前端]
+\`\`\`
+```
+
+## 质量门禁
+
+- [ ] 总览图（Mermaid C4）存在
+- [ ] 技术栈基线含版本号
+- [ ] 模块边界与负责人明确
+- [ ] 鉴权流时序图
+- [ ] 数据流三层（请求 / 状态 / 契约）
+- [ ] 关联 ADR 索引
+- [ ] 与 `SYSTEM-SPEC.md` 交叉一致
+- [ ] （前端 MF 场景）模块联邦暴露 / 消费清单完整

package/system/glossary/SKILL.md

@@ -0,0 +1,141 @@
+---
+name: zsk:glossary
+description: Project Ubiquitous Language maintenance — single source for
+  business terms, domain entities, state names, technical terms, and acronyms.
+  Eliminates same-concept-different-names confusion across modules and backend
+  contracts.
+category: resource
+domain: system
+tier: optional
+related:
+  - ../../sdlc/spec/SKILL.md
+triggers:
+  - glossary
+  - ubiquitous language
+  - DDD terms
+  - business term
+  - acronym list
+  - deprecated terms
+---
+
+# System: Glossary（全局术语表）
+
+> **定位**：项目统一语言（Ubiquitous Language，DDD 概念） — 跨模块术语的单一事实源
+> **参考规范**：Eric Evans《Domain-Driven Design》、EVA / BDD 术语一致性原则
+> **填充位置**：`docs/system/glossary.md`
+> **维护纪律**：术语一旦纳入，跨所有文档 / 代码 / UI 文案统一使用
+
+## 为什么需要
+
+- 避免同一概念在不同模块有不同叫法（例"组织" vs "机构" vs "单位"）
+- 避免同一个词指代不同含义（例"范围" = 适用范围 还是 数据范围？）
+- 对 AI 编程友好：AI 在不同会话中对术语的解读保持一致
+- 对后端契约友好：字段名 / 枚举值与业务术语对齐
+
+## 术语分类
+
+| 类别 | 示例（举例说明，不代表任何具体项目） |
+| --- | --- |
+| **业务概念** | 业务中的核心名词，如 "订单"、"工单"、"项目" 等 |
+| **领域实体** | 代码中的类型 / 字段名，如 `Order`、`Ticket` |
+| **状态 / 动作** | "启用 / 禁用"、"发起 / 撤回"、"审批中" 等 |
+| **技术概念** | 架构或运行时名词，如 模块联邦、虚拟根节点、懒加载 |
+| **缩略语** | NFR、ADR、RCA、DoR、DoD、MF |
+
+## 模板
+
+```md
+# 项目术语表
+
+> 版本：{YYYY-MM-DD}
+> 维护人：{姓名}
+> 关联：`{{config.paths.srs}}`、各模块 `spec.md` 的术语表章节
+
+## 约定
+
+- 中文术语为主，英文标识（用于代码 / 字段名）跟随
+- 每条术语：**中文名 | 英文标识 | 定义 | 使用场景 | 对应代码字段**
+- 消除歧义：标注"不要与 X 混淆"
+- 禁用词：列出曾用但已废弃的叫法
+
+## 业务概念
+
+> 以下仅为结构示例，实际术语应来自本项目的 SRS / PRD 与代码。
+
+### {业务概念中文名}（{英文标识}）
+
+- **定义**：一句话说清"它是什么"
+- **场景**：它在哪些业务流程 / 页面出现
+- **代码字段**：`{fieldName}` / `{alternateField}`
+- **不要混淆**：
+  - "{本术语}" ≠ "{易混淆术语}"（差别是 ...）
+
+### {另一业务概念}（{英文标识}）
+
+- **定义**：...
+- **场景**：...
+- **代码字段**：...
+
+## 状态与动作
+
+### {实体}状态
+
+| 状态 | 代码 | 说明 |
+| --- | --- | --- |
+| {状态名} | `{code}` | {含义} |
+
+### {流程}状态
+
+| 状态 | 代码 | 说明 |
+| --- | --- | --- |
+| {状态名} | `{code}` | {含义} |
+
+## 技术概念
+
+### {技术名词}（{英文}）
+
+- **定义**：该名词在本项目中的具体含义（不要照搬通用百科定义）
+- **代码入口**：`{相关文件路径}`
+
+## 缩略语
+
+| 缩写 | 全称 | 含义 |
+| --- | --- | --- |
+| NFR | Non-Functional Requirement | 非功能需求 |
+| ADR | Architecture Decision Record | 架构决策记录 |
+| RCA | Root Cause Analysis | 根因分析 |
+| DoR | Definition of Ready | 准入定义 |
+| DoD | Definition of Done | 完成定义 |
+| MF | Module Federation | 模块联邦 |
+| BDD | Behavior-Driven Development | 行为驱动开发 |
+| TDD | Test-Driven Development | 测试驱动开发 |
+| WCAG | Web Content Accessibility Guidelines | Web 内容可访问性指南 |
+| a11y | accessibility（首尾字母 + 中间 11 字符） | 可访问性 |
+| i18n | internationalization（首尾字母 + 18 字符） | 国际化 |
+| MCP | Model Context Protocol | 模型上下文协议 |
+| SRS | Software Requirements Specification | 软件需求规格 |
+| UE | User Experience | 用户体验 |
+
+## 废弃词汇（Deprecated Terms）
+
+> 历史用过但已废弃，避免再用。
+
+| 废弃词 | 替代词 | 废弃日期 |
+| --- | --- | --- |
+```
+
+## 维护规则
+
+- 新增术语必须同步到本文件
+- 修改术语定义必须通过 ADR（影响面大）
+- 每个模块 `spec.md` 的术语表只列**模块特有**术语，通用术语引用本文件
+- 发现代码 / 文档中有未登记术语，先录入本文件再使用
+
+## 质量门禁
+
+- [ ] 每条术语含"定义 + 场景 + 代码字段 + 混淆提醒"
+- [ ] 无歧义（同一概念一个叫法）
+- [ ] 缩略语有全称
+- [ ] 废弃词汇有替代方案
+- [ ] 与 `{{config.paths.srs}}` 交叉一致
+- [ ] 与后端接口字段交叉一致