create-yss-spec 1.1.3 → 2.0.0

package/template/docs/architecture/README.md

@@ -11,7 +11,7 @@
 | 产物 | 产出阶段 | 重点问题 | 建议文件 |
 |------|----------|----------|----------|
 | 业务架构 | 机会探索 / Discovery / 产品定义 | 用户是谁、价值流是什么、产品在业务生态中的边界在哪里 | `<feature>-business-architecture.md` |
-| 产品总体设计 / 功能架构 | PRD 初稿之后、页面 / 原型 / 交互设计之前 | 用户主流程、业务对象、功能域、模块边界、页面/API/数据影响、优先级、依赖和 MVP 非目标范围是什么 | `<feature>-product-overview-design.md` 或 `<feature>-functional-architecture.md` |
+| 产品总体设计 / 功能架构 | Spec 初稿之后、页面 / 原型 / 交互设计之前 | 用户主流程、业务对象、功能域、模块边界、页面/API/数据影响、优先级、依赖和 MVP 非目标范围是什么 | `<feature>-product-overview-design.md` 或 `<feature>-functional-architecture.md` |
 | 系统概要设计 / 系统总体架构 | 工程基线 / 系统 / 数据架构设计 | 服务/模块如何构建、部署、集成、运维、回滚和演进 | `<feature>-system-overview-design.md`、`<feature>-system-architecture.md` 或 `<feature>-architecture.md` |
 | 数据架构 | 详细设计 / 持久化开发前 | 概念/逻辑/物理模型、元模型、版本、血缘、查询、索引和存储策略是什么 | `<feature>-data-architecture.md` |
 
@@ -26,11 +26,11 @@ docs/architecture/diagrams/<feature>-system-architecture.excalidraw
 docs/architecture/diagrams/<feature>-data-model.excalidraw
 ```
 
-使用 `excalidraw-diagram-generator` 生成图时，图只作为审查辅助；发现的问题必须回写到 PRD、OpenAPI、ADR、系统 / 数据架构设计 或对应架构文档。
+使用 `excalidraw-diagram-generator` 生成图时，图只作为审查辅助；发现的问题必须回写到 Spec、OpenAPI、ADR、系统 / 数据架构设计 或对应架构文档。
 
 推荐模板：
 
-- `docs/design/templates/product-overview-design-template.md`：PRD 初稿之后、页面 / 原型 / 交互设计之前的产品总体设计 / 功能架构评审稿。
+- `docs/design/templates/product-overview-design-template.md`：Spec 初稿之后、页面 / 原型 / 交互设计之前的产品总体设计 / 功能架构评审稿。
 - `docs/architecture/templates/system-overview-design-template.md`：系统 / 数据架构与工程契约设计审查阶段的系统概要设计评审稿，承接 API 影响分析 / 契约草案 / OpenAPI Draft 与工程基线，并在 OpenAPI Freeze 前反向校验 Draft。
 
 ---
@@ -57,7 +57,7 @@ delegate_task(
 ```python
 delegate_task(
     goal="根据技术讨论记录，自动生成 ADR",
-    context="使用 docs/adr/template.md 模板"
+    context="使用 docs/templates/adr-template.md 模板"
 )
 ```
 

package/template/docs/architecture/templates/architecture-review-checklist.md

@@ -7,17 +7,17 @@
 ## 0. 架构产物完整性
 
 - [ ] 业务架构清楚：用户旅程、价值流、业务能力、角色/组织模型、外部系统边界和 MVP 非目标范围已记录，或明确说明不适用。
-- [ ] 功能架构清楚：功能域、模块边界、优先级、依赖关系和 PRD 回填项已记录。
+- [ ] 功能架构清楚：功能域、模块边界、优先级、依赖关系和 Spec 回填项已记录。
 - [ ] 系统总体架构清楚：服务/模块边界、部署、集成、权限、性能、可靠性、可观测性、发布和回滚策略已记录。
 - [ ] 数据架构清楚：概念/逻辑/物理模型、元模型、版本、血缘、查询/搜索、索引、存储和迁移约束已记录，或明确说明无持久化影响。
 - [ ] 数据模型、元数据、版本或血缘类产品已在 Repository / MyBatis / 持久化开发前完成数据架构。
-- [ ] 架构图如已生成，已引用明确上游文档，且图中发现的问题已回写到 PRD、OpenAPI、ADR、系统 / 数据架构设计 或 Issue。
+- [ ] 架构图如已生成，已引用明确上游文档，且图中发现的问题已回写到 Spec、OpenAPI、ADR、系统 / 数据架构设计 或 Ticket。
 
 ## 0.1 DDD 轻量门禁
 
 > DDD 检查嵌入现有阶段，不默认新增阶段或独立文档。只有当本节无法说明清楚时，才升级为独立 Strategic / Tactical DDD 设计文档。
 
-- [ ] 若为小改动，已完成 DDD impact check，并确认不影响统一语言、上下文边界、聚合、API、数据、权限或安全红线。
+- [ ] 若为小改动，已完成 DDD impact check，并确认不影响统一语言、上下文边界、聚合、API、数据、权限或风险 / 回滚约束。
 - [ ] Strategic DDD Check 已完成或明确不适用：统一语言、核心/支撑/通用子域、限界上下文、上下文映射和非目标范围清楚。
 - [ ] Tactical DDD Check 已完成或明确不适用：聚合根、Entity、Value Object、领域服务、不变量、一致性边界和 Repository / Gateway seam 清楚。
 - [ ] OpenAPI 契约使用上下文的公开语言，不直接暴露内部聚合、Repository 或持久化表结构。
@@ -67,7 +67,7 @@
 ## 5. 可维护性 (Maintainability)
 
 - [ ] 架构决策已记录为 ADR
-- [ ] 契约草案 / OpenAPI Draft 已经工程基线、系统/数据架构和 Issue 校验，并在开发前完成 OpenAPI Freeze
+- [ ] 契约草案 / OpenAPI Draft 已经工程基线、系统/数据架构和 Ticket 校验，并在开发前完成 OpenAPI Freeze
 - [ ] 关键流程有日志 (结构化日志，含 trace_id)
 - [ ] 监控指标已定义 (RED: Rate/Errors/Duration)
 - [ ] 告警规则已配置 (P99 延迟、错误率、磁盘)

package/template/docs/architecture/templates/business-architecture-template.md

@@ -7,8 +7,8 @@ owner: ai
 
 # <功能名称>业务架构
 
-> 适用场景：新产品、新业务域或较大模块进入 PRD 前。
-> 本文明确产品为谁创造价值、位于什么业务流程和外部生态中，不替代 PRD、功能架构或系统架构。
+> 适用场景：新产品、新业务域或较大模块进入 Spec 前。
+> 本文明确产品为谁创造价值、位于什么业务流程和外部生态中，不替代 Spec、功能架构或系统架构。
 
 ## 1. 输入材料
 
@@ -49,9 +49,9 @@ owner: ai
 |-----------------|------|-------------|----------|
 |  | 上游 / 下游 / 协作方 |  |  |
 
-## 7. PRD 输入
+## 7. Spec 输入
 
-- 必须进入 PRD 的业务规则：
+- 必须进入 Spec 的业务规则：
 - 需要补充的验收标准：
 - 需要回写 `CONTEXT.md` 的术语：
 - 需要进入 OpenAPI / 系统架构的边界：
@@ -60,11 +60,11 @@ owner: ai
 
 - [ ] 用户旅程、价值流、能力地图、角色 / 组织模型清楚。
 - [ ] 外部系统边界和 MVP 非目标范围清楚。
-- [ ] PRD 所需的业务规则和验收线索已列出。
-- [ ] 安全红线和人工审查点已标注。
+- [ ] Spec 所需的业务规则和验收线索已列出。
+- [ ] 风险与人工审查点已标注。
 
 ## 9. 下一步门禁
 
 - 结论：Approved / Blocked
-- 下一步：PRD baseline / 继续业务架构
+- 下一步：Spec baseline / 继续业务架构
 - 阻断项：

package/template/docs/architecture/templates/data-architecture-template.md

@@ -14,7 +14,7 @@ owner: ai
 
 | 资产 | 路径 / 链接 | 状态 | 备注 |
 |------|-------------|------|------|
-| PRD / 需求冻结 |  |  |  |
+| Spec / 需求冻结 |  |  |  |
 | 产品总体设计 / 功能架构 |  |  |  |
 | API 影响记录 / 契约草案 / OpenAPI Draft |  |  |  |
 | 系统概要设计 |  |  |  |
@@ -41,7 +41,7 @@ owner: ai
 
 ## 5. 物理模型草案
 
-> 数据库迁移脚本属于安全红线，Agent 只能生成模板或草案，必须标记 `TODO-HUMAN-REVIEW`。
+> 数据库迁移脚本属于风险 / 回滚约束，Agent 必须记录验证证据、责任人和回滚约束。
 
 | 表 / 存储 | 主键 | 关键字段 | 索引建议 | 备注 |
 |-----------|------|----------|----------|------|
@@ -66,14 +66,14 @@ owner: ai
 | OpenAPI schema |  | 是 / 否 |  |
 | Repository 接口 |  | 是 / 否 |  |
 | MyBatis / Mapper |  | 是 / 否 |  |
-| 数据迁移 |  | 是 / 否 | `TODO-HUMAN-REVIEW` |
+| 数据迁移 |  | 是 / 否 | 人工确认项 |
 
 ## 9. 完成标准
 
 - [ ] 概念 / 逻辑 / 物理模型草案清楚，且不以表结构替代业务概念。
 - [ ] 版本、血缘、审计、查询、索引和存储策略已说明。
 - [ ] OpenAPI schema、Repository、MyBatis 影响已标注；schema 依赖数据模型时已列出 Draft 回改项。
-- [ ] 数据迁移、原生 SQL 等安全红线已标记 `TODO-HUMAN-REVIEW`。
+- [ ] 数据迁移、原生 SQL 等风险影响、验证证据和责任人已记录。
 - [ ] 可进入 Design Review / OpenAPI Freeze，或阻断项已列出。
 
 ## 10. 下一步门禁

package/template/docs/architecture/templates/engineering-baseline-review-template.md

@@ -14,7 +14,7 @@ owner: ai
 
 | 资产 | 路径 / 链接 | 状态 | 备注 |
 |------|-------------|------|------|
-| PRD / 需求冻结 |  |  |  |
+| Spec / 需求冻结 |  |  |  |
 | 产品总体设计 / 功能架构 |  |  |  |
 | API 影响记录 / 契约草案 / OpenAPI Draft / 无 API 影响记录 |  |  |  |
 | 既有工程结构 |  |  |  |
@@ -29,7 +29,7 @@ owner: ai
 | 是否影响 Adapter / Application / Domain / Infrastructure 分层 | 是 / 否 |  |
 | 是否新增 Gateway / Repository | 是 / 否 |  |
 | 是否影响统一响应 / DTO / VO / Query / CMD | 是 / 否 |  |
-| 是否触碰安全红线 | 是 / 否 |  |
+| 是否存在高风险变更、人工确认项或回滚约束 | 是 / 否 |  |
 
 ## 3. YSS DDD 分层检查
 
@@ -48,6 +48,7 @@ owner: ai
 | 新服务骨架 | `yss-ddd-scaffold-generator` | 是 / 否 |  |
 | 后端基线检查 | `yss-backend-scaffold-parent` | 是 / 否 |  |
 | 领域建模 | `yss-domain` / `yss-backend-scaffold-domain` | 是 / 否 |  |
+| Application 用例编排 / 事务边界 | `yss-backend-scaffold-application` | 是 / 否 |  |
 | Repository / MyBatis | `yss-repository` / `yss-mybatis` | 是 / 否 |  |
 | Web Controller / DTO | `yss-web-controller` / `yss-dto` | 是 / 否 |  |
 
@@ -58,7 +59,7 @@ owner: ai
 - [ ] Controller 不穿透 Repository。
 - [ ] 对象转换优先 MapStruct，重复 mapping 有处理策略。
 - [ ] 所需 YSS skills 已最小化选择。
-- [ ] 安全红线已标记 `TODO-HUMAN-REVIEW`。
+- [ ] 风险影响、验证证据和责任人已记录。
 
 ## 6. 下一步门禁
 

package/template/docs/architecture/templates/functional-architecture-template.md

@@ -7,14 +7,14 @@ owner: ai
 
 # <功能名称>功能架构
 
-> 适用场景：PRD 初稿之后、PRD 校准之前，需要明确功能域、模块边界、优先级、页面 / API / 数据影响。
+> 适用场景：Spec 初稿之后、Spec 校准之前，需要明确功能域、模块边界、优先级、页面 / API / 数据影响。
 > 本文可独立成文，也可与产品总体设计合并；不替代交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
 
 ## 1. 输入材料
 
 | 资产 | 路径 / 链接 | 状态 | 备注 |
 |------|-------------|------|------|
-| PRD 初稿 |  |  |  |
+| Spec 初稿 |  |  |  |
 | 业务架构 |  |  |  |
 | Discovery |  |  |  |
 | CONTEXT 术语 |  |  |  |
@@ -50,7 +50,7 @@ owner: ai
 |-------------|------|------|----------|
 |  | 业务 / 技术 / 外部系统 |  |  |
 
-## 7. PRD 回填项
+## 7. Spec 回填项
 
 | 编号 | 回填内容 | 影响章节 | 优先级 | 状态 |
 |------|----------|----------|--------|------|
@@ -59,13 +59,13 @@ owner: ai
 ## 8. 完成标准
 
 - [ ] 功能域、模块边界、优先级和依赖清楚。
-- [ ] MVP / 非目标范围与 PRD 一致。
+- [ ] MVP / 非目标范围与 Spec 一致。
 - [ ] 页面、API、数据、权限和审计影响已显式标注。
-- [ ] PRD 回填项已分清阻断项和非阻断项。
-- [ ] 可进入产品设计 / PRD 校准。
+- [ ] Spec 回填项已分清阻断项和非阻断项。
+- [ ] 可进入产品设计 / Spec 校准。
 
 ## 9. 下一步门禁
 
 - 结论：Approved / Blocked
-- 下一步：产品设计 / PRD 校准 / OpenAPI 无影响记录
+- 下一步：产品设计 / Spec 校准 / OpenAPI 无影响记录
 - 阻断项：

package/template/docs/architecture/templates/system-overview-design-template.md

@@ -15,7 +15,7 @@ owner: ai
 
 | 资产 | 路径 / 链接 | 状态 | 备注 |
 |------|-------------|------|------|
-| PRD / PRD 校准 |  |  |  |
+| Spec / 校准记录 |  |  |  |
 | 产品总体设计 / 功能架构 |  |  |  |
 | 产品设计 / 原型 / 交互说明 |  |  |  |
 | API 影响记录 / 契约草案 / OpenAPI Draft |  |  |  |
@@ -92,18 +92,17 @@ owner: ai
 | 可观测性 |  |  |
 | 发布 / 回滚 |  |  |
 
-## 10. 安全红线与人工审查
+## 10. 风险 / 回滚约束与人工确认
 
-| 风险点 | 是否触碰红线 | 处理方式 | 状态 |
+| 风险点 | 是否涉及 | 处理方式 | 状态 |
 |--------|--------------|----------|------|
 | 支付逻辑 | 否 |  |  |
 | 数据库迁移脚本 | 否 |  |  |
 | 认证 / 授权中间件 | 否 |  |  |
 | 加密算法实现 | 否 |  |  |
-| SQL 原生查询 | 否 |  |  |
 | 公共基础库 API | 否 |  |  |
 
-触碰红线时必须标记 `TODO-HUMAN-REVIEW`，并在实现前取得人工确认。
+如存在需要人工确认的风险事项，必须在实现前写明确认结论。
 
 ## 11. ADR 候选
 
@@ -118,7 +117,7 @@ owner: ai
 - [ ] 状态流、失败路径、幂等、并发和回滚策略清楚。
 - [ ] 数据架构需求已明确；涉及持久化、元模型、版本或血缘时已有数据架构。
 - [ ] Tactical DDD Check 已完成，或明确说明本次变更不影响领域模型 / 聚合 / 持久化边界。
-- [ ] 安全红线和人工审查点已标记。
+- [ ] 风险与人工审查点已标记。
 - [ ] 需要 ADR 的决策已列出。
 - [ ] 可进入 Design Review，或明确阻断项。
 

package/template/docs/architecture/templates/tech-design-template.md

@@ -1,6 +1,6 @@
 # 技术方案：[功能名称]
 
-> 版本: 0.1 | 作者: | 日期: | 关联: PRD-xxx / ADR-xxx
+> 版本: 0.1 | 作者: | 日期: | 关联: Spec-xxx / ADR-xxx
 
 ---
 
@@ -26,7 +26,7 @@
 
 ### 功能架构
 
-（功能域、模块边界、优先级、模块依赖、MVP / 非目标范围；说明哪些内容需要回填 PRD。）
+（功能域、模块边界、优先级、模块依赖、MVP / 非目标范围；说明哪些内容需要回填 Spec。）
 
 相关图：`docs/architecture/diagrams/<feature>-functional-modules.excalidraw`
 

package/template/docs/design/README.md

@@ -7,9 +7,9 @@
 - `docs/design/design.md`：从本地 `Product-Design-System` 引入并整理的 Ant Design 企业级设计系统说明，后续页面设计、交互说明、原型评审和前端实现默认引用该文件。
 - `docs/design/tokens/`：随仓库保存的主题、亮色 / 暗色 / 紧凑 token 和 CSS 变量快照，后续实现不得依赖本机 Downloads 目录。
 
-产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 PRD / OpenAPI 回填。
+产品原型产出默认以 `product-design:index` 为主入口。该 skill 只负责路由，实际按 Product Design plugin 规则进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill；YSS 生命周期仍负责校验低保真评审、高保真 HTML 原型、AntD CLI 校验证据、用户确认和 Spec / OpenAPI 回填。
 
-进入 PRD 初稿 / 需求基线流程后，必须先沉淀产品总体设计 / 功能架构，再进入页面 / 原型 / 交互设计、PRD 校准、API 影响分析 / 契约草案或实现。产品总体设计文档必须包含低保真原型 / 页面草图，用于验证页面结构、关键操作和主流程。无 UI 的功能也需要产品总体设计 / 功能架构来说明功能域、业务对象、模块边界、API / 数据影响和不适用的页面状态；只有不进入 PRD 生命周期的小改动可在影响面评估中记录不适用原因。
+进入 Spec 初稿 / 需求基线流程后，必须先沉淀产品总体设计 / 功能架构，再进入页面 / 原型 / 交互设计、Spec 校准、API 影响分析 / 契约草案或实现。产品总体设计文档必须包含低保真原型 / 页面草图，用于验证页面结构、关键操作和主流程。无 UI 的功能也需要产品总体设计 / 功能架构来说明功能域、业务对象、模块边界、API / 数据影响和不适用的页面状态；只有不进入 Spec 生命周期的小改动可在影响面评估中记录不适用原因。
 
 进入 API 影响分析 / 契约草案前，有用户界面的功能还必须沉淀：
 
@@ -26,21 +26,21 @@
 
 推荐模板：
 
-- `docs/design/templates/product-overview-design-template.md`：PRD 初稿之后、页面 / 原型 / 交互设计之前，用于团队评审产品总体设计、功能架构、低保真原型、页面/API/数据影响和 PRD 回填项；它是后续交互设计输入，不替代详细交互说明。
-- `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、PRD 回填项和 OpenAPI 反推清单。
+- `docs/design/templates/product-overview-design-template.md`：Spec 初稿之后、页面 / 原型 / 交互设计之前，用于团队评审产品总体设计、功能架构、低保真原型、页面/API/数据影响和 Spec 回填项；它是后续交互设计输入，不替代详细交互说明。
+- `docs/design/templates/interaction-spec-template.md`：页面、流程、交互、Spec 回填项和 OpenAPI 反推清单。
 - `docs/design/templates/state-matrix-template.md`：loading、empty、error、readonly、no-permission、conflict 等状态。
-- `docs/design/templates/prototype-review-checklist.md`：进入 PRD 校准 / API 影响分析 / 契约草案前的原型评审门禁。
+- `docs/design/templates/prototype-review-checklist.md`：进入 Spec 校准 / API 影响分析 / 契约草案前的原型评审门禁。
 - `docs/design/templates/prototype-confirmation-template.md`：高保真 HTML 原型产出后的用户确认记录。
 
 推荐技能：
 
 - `yss-design-system`：项目设计系统与 Ant Design 企业级 UI 风格基线；页面设计、原型评审、UI 实现和主题 token 落地时默认先引用。
 - `product-design:index`：产品原型产出的主路由；根据输入是否有 URL、截图、Figma、代码目标或视觉方向，进入 `$get-context`、`$ideate`、`$prototype`、`$image-to-code`、`$url-to-code`、`$share` 或 `$design-qa` 等 focused skill。
-- Product Design focused skills：基于 PRD 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
+- Product Design focused skills：基于 Spec 初稿和产品总体设计 / 功能架构，产出低保真 / 高保真页面、原型、交互设计资产和可分享原型；高保真 HTML 原型默认由该路由链路产出。
 - `antd`：Ant Design v6 组件、demo、token、semantic 和 design.md 查询工具；生成或修改高保真 HTML 原型前后必须留下 CLI 校验证据。
-- `prototype-review`：原型阶段评审门禁；未通过则不要进入 PRD 校准 / API 影响分析 / 契约草案。
+- `prototype-review`：原型阶段评审门禁；未通过则不要进入 Spec 校准 / API 影响分析 / 契约草案。
 - 兼容入口：`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
-- `excalidraw-diagram-generator`：根据已形成的 Discovery、PRD、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
+- `excalidraw-diagram-generator`：根据已形成的 Discovery、Spec、OpenAPI Draft、Architecture 或 系统 / 数据架构设计 生成 `.excalidraw` 图；用于说明和审查，不替代文本规格。
 
 推荐目录：
 

package/template/docs/design/design.md

@@ -202,7 +202,7 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 
 ## 设计审查清单
 
-进入 PRD 校准、API 影响分析 / 契约草案或前端实现前，带 UI 的需求应检查：
+进入 Spec 校准、API 影响分析 / 契约草案或前端实现前，带 UI 的需求应检查：
 
 - 是否引用本文件作为设计系统基线。
 - 页面清单、用户主路径、异常路径和权限状态是否明确。
@@ -218,3 +218,12 @@ Inter, system-ui, -apple-system, Segoe UI, Helvetica Neue, Arial, sans-serif
 - 将 `docs/design/tokens/variables.css` 中的 `--brand-*` 变量纳入项目 token 管理。
 - 如果项目启用暗色模式，补充 `docs/design/tokens/tokens.dark.json` 的使用规范和截图验收。
 - 如果项目存在高密度表格 / 审批 / 运营台，补充 `docs/design/tokens/tokens.compact.json` 的适用边界。
+
+## Ant Design v6 原型补充基线
+
+本节根据 `antdv6-design.md` 的设计说明提炼，用于高保真原型和后续前端实现，不替代项目 token。
+
+- 先按 `bg-layout`、`bg-container`、`bg-elevated`、文本、边框、状态、圆角和阴影等 semantic token 角色设计，再映射到 `ConfigProvider`、组件 token 或 CSS variables；不得用页面局部色值替代主题层。
+- 默认亮色使用 `theme.defaultAlgorithm`；暗色和紧凑密度通过 theme algorithm 切换，禁止手工反色或逐控件压缩。
+- 每个决策区域只保留一个 single primary action。保存、提交、审批、发布、导出和重试等动作必须提供 interaction feedback；不可逆或高风险动作使用确认弹窗。
+- 对实际字号、图标和背景复核 accessibility contrast。默认 token 不足时，通过种子 token 或组件 token 调整，不引入单页特例色。

package/template/docs/design/diagrams/README.md

@@ -2,7 +2,7 @@
 
 本目录用于保存产品设计、交互说明和流程评审中的 Excalidraw 可视化补充材料。
 
-图稿只用于辅助评审和沟通，需求边界仍以 PRD、交互说明、OpenAPI Draft、系统 / 数据架构设计 等文本资产为准。评审中发现的边界、状态或接口缺口，需要回写到对应文本资产，不能只停留在图稿里。
+图稿只用于辅助评审和沟通，需求边界仍以 Spec、交互说明、OpenAPI Draft、系统 / 数据架构设计 等文本资产为准。评审中发现的边界、状态或接口缺口，需要回写到对应文本资产，不能只停留在图稿里。
 
 推荐命名：
 

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

@@ -1,12 +1,12 @@
 # <功能名称> 交互说明模板
 
-> 适用时机：PRD 初稿和产品总体设计 / 功能架构完成之后，PRD 校准 / API 影响分析 / 契约草案之前；仅用于有用户界面影响的功能。
+> 适用时机：Spec 初稿和产品总体设计 / 功能架构完成之后，Spec 校准 / API 影响分析 / 契约草案之前；仅用于有用户界面影响的功能。
 
 ## 1. 输入资产
 
 | 资产 | 路径 / 链接 | 说明 |
 |---|---|---|
-| PRD 初稿 | `docs/requirements/<feature>-prd.md` | 原型评审后需要回填和校准 |
+| Spec 初稿 | `docs/requirements/<feature>-spec.md` | 原型评审后需要回填和校准 |
 | 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` | 必需；缺失时先返回产品总体设计阶段 |
 | 领域术语 | `CONTEXT.md` | 核心名词、状态和业务规则 |
 | Discovery | `docs/discovery/<feature>-discovery.md` | 可选 |
@@ -14,7 +14,7 @@
 | 原型 / 线框图 | `<链接或导出图片路径>` | Excalidraw / Figma / Penpot / tldraw / Axure / Markdown |
 | 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | 低保真原型评审通过后补齐；必须使用 Ant Design v6；可由系统 / Agent 自动产出；产出后必须获得用户确认 |
 | AntD CLI 校验证据 | `<命令输出或记录路径>` | `antd design.md/info/demo/token/semantic --version 6.0.0 --format json` |
-| 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选；通常应先完成产品设计和 PRD 校准 |
+| 现有 API 草案 | `docs/api/specs/<feature>.yaml` | 可选；通常应先完成产品设计和 Spec 校准 |
 
 ## 2. 页面地图
 
@@ -92,9 +92,9 @@
 | 发布确认 | 发布接口携带草稿版本或版本 token | 需要冲突响应 |
 | 版本历史 | 版本列表接口 | 包含操作人、时间和变更摘要 |
 
-## 7. PRD 校准记录
+## 7. Spec 校准记录
 
-| 原型发现 | 需要回填 PRD 的内容 | 负责人 / 状态 |
+| 原型发现 | 需要回填 Spec 的内容 | 负责人 / 状态 |
 |---|---|---|
 | 字段级校验需要页面定位 | 增加字段级错误展示验收标准 | 产品 / 待确认 |
 | 已发布版本只读 | 增加发布版本不可修改规则 | 产品 / 已确认 |
@@ -115,4 +115,4 @@
 | 已确认 | 已发布版本只读 | 产品 | 已确认 |
 | 待确认 | 管理员是否可以废弃已发布版本 | 产品 / 架构 | 待确认 |
 | 非目标 | 审批流 | 产品 | MVP 排除 |
-| 人工审查 | 数据库迁移生成 | 人工 | TODO-HUMAN-REVIEW |
+| 人工审查 | 数据库迁移生成 | 人工 | 人工确认项 |

package/template/docs/design/templates/product-overview-design-template.md

@@ -7,8 +7,8 @@ owner: ai
 
 # <功能名称> 产品总体设计与功能架构
 
-> 适用时机：PRD 初稿之后、页面 / 原型 / 交互设计之前。
-> 本文用于明确功能域、模块边界、MVP 范围、页面清单、低保真原型、状态 / 权限影响、OpenAPI 反推点和 PRD 回填项；它是页面 / 原型 / 交互设计的上游输入，不替代 PRD、交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
+> 适用时机：Spec 初稿之后、页面 / 原型 / 交互设计之前。
+> 本文用于明确功能域、模块边界、MVP 范围、页面清单、低保真原型、状态 / 权限影响、OpenAPI 反推点和 Spec 回填项；它是页面 / 原型 / 交互设计的上游输入，不替代 Spec、交互说明、契约草案 / OpenAPI Draft 或系统概要设计。
 
 ## 1. 输入资产
 
@@ -16,7 +16,7 @@ owner: ai
 |------|-------------|------|------|
 | Discovery / 竞品分析 |  |  |  |
 | 业务架构 |  |  |  |
-| PRD 初稿 |  |  |  |
+| Spec 初稿 |  |  |  |
 | CONTEXT 术语 |  |  |  |
 | 其他约束 |  |  |  |
 
@@ -60,7 +60,7 @@ owner: ai
 - [ ] 核心域、支撑域、通用域或“不适用”的判断已明确。
 - [ ] 每个 P0 能力都能归属到一个限界上下文或明确为跨上下文协作。
 - [ ] 上下文协作关系已说明，不把内部模型直接泄露为跨上下文契约。
-- [ ] 本节足以支撑 PRD 校准和 API 影响分析 / 契约草案；否则列为阻断项。
+- [ ] 本节足以支撑 Spec 校准和 API 影响分析 / 契约草案；否则列为阻断项。
 
 ## 7. 页面 / API / 数据影响
 
@@ -96,7 +96,7 @@ owner: ai
 |-------------|----------------|--------------|-----------------------------|--------------------|
 |  |  |  |  |  |
 
-## 9. PRD 回填项
+## 9. Spec 回填项
 
 | 编号 | 回填内容 | 影响章节 | 优先级 | 状态 |
 |------|----------|----------|--------|------|
@@ -106,7 +106,7 @@ owner: ai
 
 | 问题 / 决策 | 选项 | 建议 | 负责人 | 截止点 | 状态 |
 |-------------|------|------|--------|--------|------|
-|  |  |  |  | PRD 校准前 / API 影响分析前 | 待确认 |
+|  |  |  |  | Spec 校准前 / API 影响分析前 | 待确认 |
 
 ## 11. 评审清单
 
@@ -116,8 +116,8 @@ owner: ai
 - [ ] Strategic DDD Check 已完成，或明确说明本次变更不影响领域边界。
 - [ ] 页面、API、数据、权限和审计影响已显式标注。
 - [ ] 低保真原型 / 页面草图已覆盖 P0 页面、主流程和关键异常路径，并能支撑后续交互设计。
-- [ ] PRD 回填项已列出，并分清阻断项和非阻断项。
-- [ ] 安全红线已标记 `TODO-HUMAN-REVIEW`。
+- [ ] Spec 回填项已列出，并分清阻断项和非阻断项。
+- [ ] 风险影响、验证证据和责任人已记录。
 - [ ] 可进入页面 / 原型 / 交互设计，或明确阻断项。
 
 ## 12. 结论

package/template/docs/design/templates/prototype-confirmation-template.md

@@ -1,13 +1,13 @@
 # <功能名称> 高保真原型确认记录
 
-> 适用时机：Ant Design v6 高保真 HTML 原型产出后、PRD 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。未确认前不得进入下游门禁。
+> 适用时机：Ant Design v6 高保真 HTML 原型产出后、Spec 校准 / 需求冻结 / UI 驱动 OpenAPI Draft 前。未确认前不得进入下游门禁。
 
 ## 1. 原型信息
 
 | 项目 | 内容 |
 |---|---|
 | 功能名称 |  |
-| PRD | `docs/requirements/<feature>-prd.md` |
+| Spec | `docs/requirements/<feature>-spec.md` |
 | 产品总体设计 / 功能架构 | `docs/design/<feature>-product-overview-design.md` |
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |
@@ -34,9 +34,9 @@
 |---|---|
 | 确认人 |  |
 | 确认时间 |  |
-| 确认方式 | 口头 / 评论 / Issue / 会议纪要 / 其他 |
+| 确认方式 | 口头 / 评论 / Ticket / 会议纪要 / 其他 |
 | 确认结论 | 通过 / 需调整 / 暂缓 |
-| 是否允许进入 PRD 校准 | 是 / 否 |
+| 是否允许进入 Spec 校准 | 是 / 否 |
 | 是否允许进入 API 影响分析 / OpenAPI Draft | 是 / 否 |
 
 ## 4. 调整项

package/template/docs/design/templates/prototype-review-checklist.md

@@ -1,12 +1,12 @@
 # <功能名称> 原型评审清单
 
-> 适用时机：配合 `prototype-review` 使用。评审采用 fail-closed：有阻断项时必须回到产品设计阶段；产品原型产出以 `product-design:index` 路由到 Product Design focused skill 为主；低保真评审通过后必须产出高保真 HTML 原型，可由系统 / Agent 自动产出；产出后必须获得用户确认，确认前不能直接进入 PRD 校准或 API 影响分析 / 契约草案。
+> 适用时机：配合 `prototype-review` 使用。评审采用 记录阻塞原因：有阻断项时必须回到产品设计阶段；产品原型产出以 `product-design:index` 路由到 Product Design focused skill 为主；低保真评审通过后必须产出高保真 HTML 原型，可由系统 / Agent 自动产出；产出后必须获得用户确认，确认前不能直接进入 Spec 校准或 API 影响分析 / 契约草案。
 
 ## 评审输入
 
 | 输入 | 路径 / 链接 | 是否具备 |
 |---|---|---|
-| PRD | `docs/requirements/<feature>-prd.md` |  |
+| Spec | `docs/requirements/<feature>-spec.md` |  |
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` |  |
 | 原型 / 线框图 | `<链接或导出图片路径>` |  |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` |  |
@@ -29,9 +29,9 @@
 | AntD v6 设计语言、组件 API、demo、token 和 semantic 已用 `antd` CLI 查询并记录 |  |  |
 | 高保真 HTML 原型未使用旧原型技能作为主入口，已通过 `product-design:index` 路由产出或记录例外原因 |  |  |
 | 前端验收、组件状态和数据依赖已明确 |  |  |
-| 安全红线已标记人工审查 |  |  |
+| 风险 / 回滚约束和人工确认项已记录 |  |  |
 
-## PRD 校准就绪度
+## Spec 校准就绪度
 
 | 范围 | 是否就绪 | 说明 |
 |---|---|---|
@@ -39,7 +39,7 @@
 | 流程 / 状态设计发现的需求缺口 |  |  |
 | 原型证明需要排除的非目标 |  |  |
 | 待确认决策已排除在冻结范围外 |  |  |
-| PRD 中已补充设计资产链接 |  |  |
+| Spec 中已补充设计资产链接 |  |  |
 
 ## API 影响分析 / 契约草案就绪度
 

package/template/docs/design/templates/state-matrix-template.md

@@ -1,6 +1,6 @@
 # <功能名称> 状态矩阵模板
 
-> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 PRD 校准和 API 影响分析 / 契约草案之前补齐页面状态。
+> 适用时机：配合 `product-design:index` 路由后的 Product Design focused skill 使用，在 Spec 校准和 API 影响分析 / 契约草案之前补齐页面状态。
 
 | 页面 / 组件 | 状态 | 触发条件 | 界面行为 | API / 数据要求 | 验收点 |
 |---|---|---|---|---|---|

package/template/docs/discovery/IDEATION.md

@@ -20,7 +20,7 @@ Ideation 不等同于  Matt skills `需求澄清`：
 市场 / 竞品 / 用户事实 <-> 机会构想假设 <-> MVP 边界
 ```
 
-如果只有一个模糊主题，可以先 Ideation 再 Discovery；如果已经有竞品、用户或行业材料，应先 Discovery 再 Ideation。二者循环到 PRD 前，必须收敛用户、痛点、做什么、不做什么和成功标准。
+如果只有一个模糊主题，可以先 Ideation 再 Discovery；如果已经有竞品、用户或行业材料，应先 Discovery 再 Ideation。二者循环到 Spec 前，必须收敛用户、痛点、做什么、不做什么和成功标准。
 
 ---
 
@@ -92,5 +92,5 @@ Substitute / Combine / Adapt / Modify / Put to another use / Eliminate / Reverse
 ```
 人类提主题或 Discovery 事实 → AI 发散候选机会 → 人类选择 Top 10
 → AI 挑战者分析 → Discovery 验证证据 → AI 连接者找模式
-→ 收敛 MVP 边界 → 确认是否进入 PRD / Issue 或  Matt skills 需求澄清 技术方案设计
+→ 收敛 MVP 边界 → 确认是否进入 Spec / Ticket 或  Matt skills 需求澄清 技术方案设计
 ```

package/template/docs/discovery/README.md

@@ -12,7 +12,7 @@ Discovery 不是固定排在 Ideation 后面的单向步骤。它和机会构想
 市场 / 竞品 / 用户事实 <-> 机会构想假设 <-> MVP 边界
 ```
 
-进入 PRD 前必须收敛为：
+进入 Spec 前必须收敛为：
 
 - 用户是谁。
 - 痛点是什么。
@@ -43,7 +43,7 @@ Discovery 不是固定排在 Ideation 后面的单向步骤。它和机会构想
 
 ## 竞品分析
 
-推荐优先使用 `competitive-intelligence`，把公开证据、事实 / 推断、置信度和 PRD 输入分开记录。竞品分析结论只能作为 Discovery / PRD 输入，不能直接冻结为需求。
+推荐优先使用 `competitive-intelligence`，把公开证据、事实 / 推断、置信度和 Spec 输入分开记录。竞品分析结论只能作为 Discovery / Spec 输入，不能直接冻结为需求。
 
 ### 分析维度
 产品功能 / 用户体验 / 技术能力 / 商业模式 / 用户口碑 / 市场表现
@@ -65,12 +65,12 @@ Discovery 不是固定排在 Ideation 后面的单向步骤。它和机会构想
 
 ## Discovery 收敛产物
 
-Discovery 的结论用于影响 PRD、功能架构、产品设计、API 和架构阶段，但不替代这些阶段的正式产物。
+Discovery 的结论用于影响 Spec、功能架构、产品设计、API 和架构阶段，但不替代这些阶段的正式产物。
 
 - 机会说明。
 - MVP 范围和非目标范围。
 - 产品功能指引 / 能力候选地图。
-- 下游影响清单：UI、API、数据、权限、外部系统、发布回滚和安全红线。
+- 下游影响清单：UI、API、数据、权限、外部系统、发布回滚和风险 / 回滚约束。
 
 ---
 

package/template/docs/discovery/templates/competitive-analysis-template.md

@@ -1,7 +1,7 @@
 # [主题] 竞品深度分析报告
 
-> AI 辅助生成，人工审核补充。  
-> 建议配套产物：`competitive-matrix-template.md` 用于横向功能矩阵，本模板用于深度分析和 PRD 前置输入。  
+> AI 辅助生成，人工审核补充。
+> 建议配套产物：`competitive-matrix-template.md` 用于横向功能矩阵，本模板用于深度分析和 Spec 前置输入。
 > 使用 `grill-with-docs` 时，请把稳定术语同步沉淀到 `CONTEXT.md`，只有出现难以回滚、非显而易见且存在真实取舍的决策时才新增 ADR。
 
 ## 0. 文档信息
@@ -204,7 +204,7 @@ flowchart LR
 
 ## 8. Grilling 问题清单
 
-> 本节用于把竞品分析继续压成 PRD 前的产品边界。明确的问题可进入 PRD；稳定术语进入 `CONTEXT.md`；重大取舍再考虑 ADR。
+> 本节用于把竞品分析继续压成 Spec 前的产品边界。明确的问题可进入 Spec；稳定术语进入 `CONTEXT.md`；重大取舍再考虑 ADR。
 
 1. 首要用户是谁？是否只能先服务一个角色？
 2. 第一高频场景是什么？是新建、改造、迁移、治理，还是消费？
@@ -251,7 +251,7 @@ flowchart LR
 
 1. [补充调研 / 用户访谈 / 厂商验证]
 2. [进入 grill-with-docs 继续澄清的问题]
-3. [生成 PRD]
+3. [生成 Spec]
 4. [判断是否需要 OpenAPI / 垂直切片 issue]
 
 ## 12. 参考资料