create-yss-spec 1.1.2 → 1.1.4

package/template/docs/process/lifecycle-artifact-map.md

@@ -21,13 +21,13 @@ owner: ai
 | 主阶段 | 目标 | 必须产物 | 条件产物 | 下一门禁 |
 |---|---|---|---|---|
 | 1. 入口分诊 | 判断任务类型、风险等级、最近可信阶段和最小技能集 | 分诊结论或 issue 备注 | `yss-product-lifecycle` 路由结果、Git checkpoint 判断 | 是否需要 Discovery / PRD / API / 架构 / Issue |
-| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
-| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
-| 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
+| 2. 机会与 Discovery | 收敛用户、痛点、为什么现在做、MVP、非目标、成功标准、产品功能指引和下游影响信号 | `docs/discovery/<feature>-discovery.md` 或等价说明 | `competitive-intelligence` 竞品情报、`research` 技术 / 标准 / API 一手资料记录、竞品矩阵、机会说明、产品功能指引、下游影响清单、市场分析、用户痛点文档 | 是否足以进入业务架构和 PRD |
+| 3. 业务 / PRD / 功能架构 | 明确产品边界、用户旅程、功能域、模块边界、优先级、低保真原型和验收标准 | `docs/requirements/<feature>-prd.md`；`docs/design/<feature>-product-overview-design.md` | `grill-with-docs` 澄清记录、`prototype` 一次性验证结论、业务架构、CONTEXT 术语回填；不进入 PRD 生命周期的小改动可记录不适用原因 | PRD Review / 产品总体设计评审 / 产品设计准备度 |
+| 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计，对 UI、页面流、状态矩阵、异常路径、高保真体验和 PRD 回填做闭环 | 有 UI 时：交互说明、低保真原型评审结论、Ant Design v6 高保真 HTML 原型（可由系统 / Agent 在低保真评审通过后自动产出）、AntD CLI 校验证据和用户确认记录；无 UI 时：需求冻结记录 | 状态矩阵、页面地图、原型链接 | PRD 校准 / 工程契约与架构设计准备度 |
 | 5. 系统 / 数据架构与工程契约设计审查 | 合并 API 影响分析、契约草案、工程基线、系统架构、数据架构和 Design Review；Draft 仅用于评审，Freeze 前不得作为实现或生成客户端契约 | 系统概要设计或等价架构记录；Design Review 结论；有 API 时：API 影响记录和契约草案 / review-only OpenAPI Draft；有后端结构影响时：工程基线审查 | OpenAPI Draft Review、OpenSpec-style Spec Delta、工程基线审查、无 API 影响记录、数据架构、ADR、架构图 | OpenAPI Freeze 准备度 |
 | 6. 契约冻结与 Issue formalization | 冻结契约并把交付范围转成可执行 Issue，并明确受影响前后端工程是否已存在 | OpenAPI Freeze 记录或无 API 影响记录；垂直切片 Issue 入口 | `to-issues` 输出、实施路由记录、实现仓库 / 脚手架判定、Issue tracker 同步 | 垂直切片准备度 |
-| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`implement` / `tdd` 证据、`code-review` 报告、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
-| 8. 验证发布与复盘 | 保留发布、实施、验证和经验沉淀证据 | fresh verification、发布说明、复盘记录 | 实施记录、用户手册、AGENTS / CONTEXT / ADR 更新 | 下一轮规划 |
+| 7. 垂直切片与 TDD 实现 | 将冻结范围拆成端到端切片并按 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、测试 / 验证记录 | YSS skill routing、前后端脚手架初始化记录、`handoff` / 跨仓库交接记录、`implement` / `tdd` 证据、`code-review` 报告、`resolving-merge-conflicts` 记录、清理简化记录、Architecture Re-check | Fresh verification / Release Review |
+| 8. 验证发布与复盘 | 保留发布、实施、验证和经验沉淀证据 | fresh verification、发布说明、复盘记录 | 实施记录、用户手册、`writing-skills` 压力场景 / 流程修订验证、AGENTS / CONTEXT / ADR 更新 | 下一轮规划 |
 
 ## 21 个门禁 / 职责点映射
 
@@ -39,7 +39,7 @@ owner: ai
 | 3. 需求澄清 | 3. 业务 / PRD / 功能架构 | `grill-with-docs` 结论或等价澄清记录 | 新功能 / 较大改动必需 |
 | 4. 需求基线 / 功能架构 | 3. 业务 / PRD / 功能架构 | PRD；产品总体设计 / 功能架构资产；功能域、模块边界、低保真原型、验收标准 | 进入 PRD 初稿 / 需求基线流程时必需 |
 | 5. 页面 / 原型 / 交互设计 | 4. 产品设计与需求冻结 | 基于 PRD 初稿和产品总体设计 / 功能架构产出的交互说明、页面清单、状态矩阵 | 有 UI 时必需；缺产品总体设计时阻断 |
-| 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论；通过后必须产出 Ant Design v6 高保真 HTML 原型 | 有 UI 时必需 |
+| 6. 原型评审 | 4. 产品设计与需求冻结 | Prototype Review 结论；通过后必须产出 Ant Design v6 高保真 HTML 原型，可由系统 / Agent 自动生成；必须记录 AntD CLI 校验证据；产出后必须获得用户确认 | 有 UI 时必需 |
 | 7. PRD 校准 / 需求冻结 | 4. 产品设计与需求冻结 | 需求冻结记录或校准后的 PRD | 必需；无 UI 可轻量化 |
 | 8. API 影响分析 / 契约草案 | 5. 系统 / 数据架构与工程契约设计审查 | API 影响记录、契约草案 / OpenAPI Draft 或无 API 影响记录；Draft 在 Freeze 前仅可评审；中高风险变更补 OpenSpec-style Spec Delta | 有 API 影响时必需；Spec Delta 条件必需 |
 | 9. 工程基线 | 5. 系统 / 数据架构与工程契约设计审查 | 工程基线 / YSS DDD Review | 新服务 / 新模块 / 后端结构变化时必需 |
@@ -50,7 +50,7 @@ owner: ai
 | 14. Issue formalization | 6. 契约冻结与 Issue formalization | 垂直切片 Issue、`to-issues` 输出或等价任务记录，并记录受影响前后端工程存在性判定与脚手架初始化决策 | 正式垂直切片前必需 |
 | 15. 实施计划 | 7. 垂直切片与 TDD 实现 | 垂直切片 Issue、实施计划、Build Architecture Checklist、回滚点，以及缺失前后端工程时的脚手架初始化记录 | 正式开发前必需 |
 | 16. 开发实现 | 7. 垂直切片与 TDD 实现 | TDD 证据、代码实现、契约对齐、架构约束回勾 | 代码变更时必需 |
-| 17. 独立审查 | 7. 垂直切片与 TDD 实现 | Review Report、`code-review` 结论或 MR / PR 评论 | 合并 / 发布前必需 |
+| 17. 独立审查 | 7. 垂直切片与 TDD 实现 | Review Report、`code-review` 结论或 MR / PR 评论；发生 merge / rebase 冲突时补 `resolving-merge-conflicts` 记录 | 合并 / 发布前必需 |
 | 18. 清理简化 | 7. 垂直切片与 TDD 实现 | 清理项记录或 review 建议 | 有复用 / 可读性 / 性能问题时执行 |
 | 19. 验证发布 | 8. 验证发布与复盘 | fresh verification、发布说明、实施 / 回滚说明 | 发布 / 可合并结论前必需 |
 | 20. 复盘沉淀 | 8. 验证发布与复盘 | 复盘、CONTEXT / AGENTS / ADR 更新 | 发布后或阶段性复盘时必需 |
@@ -62,6 +62,7 @@ owner: ai
 | Discovery 收敛 | `docs/discovery/<feature>-discovery.md` | `docs/discovery/templates/discovery-template.md` |
 | 竞品情报简报 | `docs/discovery/reports/<feature>-competitive-intelligence.md` | `competitive-intelligence` 输出格式 |
 | 竞品矩阵 | `docs/discovery/reports/<feature>-competitive-matrix.md` | `docs/discovery/templates/competitive-matrix-template.md` |
+| 技术 / 标准 / API 调研 | `docs/discovery/reports/<feature>-research.md` 或 `docs/research/<feature>.md` | `research` 输出格式 |
 | PRD | `docs/requirements/<feature>-prd.md` | `docs/templates/prd-template.md` |
 | 业务架构 | `docs/architecture/<feature>-business-architecture.md` | `docs/architecture/templates/business-architecture-template.md` |
 | 功能架构 | `docs/architecture/<feature>-functional-architecture.md` | `docs/architecture/templates/functional-architecture-template.md` |
@@ -69,7 +70,8 @@ owner: ai
 | 交互说明 | `docs/design/<feature>-interaction-spec.md` | `docs/design/templates/interaction-spec-template.md` |
 | 状态矩阵 | `docs/design/<feature>-state-matrix.md` | `docs/design/templates/state-matrix-template.md` |
 | 原型评审 | `docs/design/<feature>-prototype-review.md` | `docs/design/templates/prototype-review-checklist.md` |
-| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | `high-fidelity-html-prototype` |
+| 高保真 HTML 原型 | `docs/design/prototypes/<feature>/index.html` | `product-design:index` 路由到 Product Design focused skill 产出 |
+| 高保真原型确认记录 | `docs/design/<feature>-prototype-confirmation.md` | `docs/design/templates/prototype-confirmation-template.md` |
 | 需求冻结 | `docs/requirements/<feature>-requirement-freeze.md` | `docs/templates/requirement-freeze-template.md` |
 | API 影响分析 / 契约草案 / OpenAPI Draft | API 影响记录、issue note 或 `docs/api/specs/<feature>.yaml` | `docs/templates/openapi-spec-template.yaml` |
 | OpenSpec-style Spec Delta | `docs/specs/<feature>-spec-delta.md` | `docs/templates/spec-delta-template.md` |
@@ -81,6 +83,7 @@ owner: ai
 | OpenAPI Freeze | `docs/api/<feature>-openapi-freeze.md` | `docs/api/templates/openapi-freeze-record-template.md` |
 | 垂直切片 Issue | GitLab / GitHub Issues 或 `docs/requirements/issues/<feature>-slice.md` | `docs/templates/vertical-slice-issue-template.md` |
 | 实现路由 | `docs/requirements/issues/<feature>-implementation-routing.md` | `docs/templates/implementation-routing-template.md` |
+| 跨阶段 / 跨仓库交接 | Issue / MR / PR 评论或 `docs/implementation/<feature>-handoff.md` | `handoff` 或等价交接记录 |
 | 实现仓库登记 | 实施计划 / Issue / `docs/implementation/<feature>-repo-registry.md` | `docs/templates/implementation-repo-registry-template.md` |
 | 跨仓库切片记录 | 垂直切片 Issue / `docs/implementation/<feature>-cross-repo-slice.md` | `docs/templates/cross-repo-slice-template.md` |
 | Build Architecture Checklist | `docs/implementation/<feature>-build-architecture-checklist.md` 或实施计划 / Issue | `docs/templates/build-architecture-checklist-template.md` |
@@ -90,6 +93,7 @@ owner: ai
 | 实施记录 | `docs/implementation/<feature>-rollout.md` | `docs/templates/implementation-plan-template.md` |
 | 用户手册 | `docs/user-guide/<feature>.md` | `docs/user-guide/templates/user-guide-template.md` |
 | 复盘 | `docs/process/sprint-retros/<date>-<topic>.md` | `docs/templates/retro-report-template.md` |
+| 流程 / Skill 修订验证 | `docs/process/<topic>-skill-validation.md` 或 PR / Issue 评论 | `writing-skills` 压力场景与验证记录 |
 | Harness 工作单元映射 | `docs/process/harness-work-unit-map.md` | 直接维护 |
 | Harness 流程裁剪 | `docs/process/harness-process-tailoring.md` | 直接维护 |
 | 阶段 checkpoint | Issue / MR / PR 评论或阶段文档 | `docs/process/templates/stage-checkpoint-template.md` |
@@ -99,15 +103,20 @@ owner: ai
 - 每次开始前先判断任务类型和最近可信阶段；不要把小文案、局部样式、单点 Bug 套进完整新功能流程。
 - 判断流程裁剪时先引用 `docs/process/harness-process-tailoring.md`；该指南只能减少不相关产物，不能裁剪关键追踪关系、安全人审或 fresh verification。
 - Discovery 可以通过 `competitive-intelligence` 形成竞品情报、竞品矩阵、机会说明、产品功能指引和下游影响清单，但这些只是 PRD、功能架构、产品设计、API 和架构阶段的输入，不冻结后续设计。
+- 技术事实、框架行为、标准、第三方 API 或协议依据需要可追溯时，使用 `research` 或等价一手资料调研记录；其结论是 PRD、OpenAPI、架构或 ADR 的输入，不替代这些阶段资产。
+- 状态机、复杂业务规则或 UI 方向难以文字定稿时，可用 `prototype` 做一次性验证；必须把结论回填到 PRD、设计、ADR 或 Issue，且不得把 throwaway prototype 当作生产实现或高保真 AntD HTML 原型。
 - API 相关阶段必须区分“契约草案 / OpenAPI Draft”和“OpenAPI Freeze”：Draft 仅可用于评审和架构反审，Freeze 前不得作为前后端实现或生成客户端的稳定契约。
 - OpenSpec-style Spec Delta 只用于表达行为差异、验收场景和测试映射；它不替代 PRD、OpenAPI、Design Review 或垂直切片 Issue，也不要求创建额外变更目录。
 - API、权限、状态机、数据模型、跨端、新模块或高风险变更应在 Design Review / OpenAPI Freeze 前补充 Spec Delta；小文案、局部样式、配置微调和低风险 Bug 默认跳过。
 - OpenAPI Freeze 后直接进入 `to-issues` 或等价垂直切片拆分，不再要求额外变更目录或状态文件。
 - 进入实现前，必须先判断当前切片受影响的 frontend / backend 运行时代码工程是否已经存在且可复用；若不存在、不可复用或目录约定缺失，必须先记录原因并路由 `yss-ddd-scaffold-generator` 或 `yss-frontend-scaffold-generator` 初始化，再进入业务实现。
 - 进入垂直切片实现前，必须将系统架构、数据架构、ADR、工程基线、OpenAPI Freeze 结论和安全红线转译成 `Build Architecture Checklist`。
+- 跨线程、跨仓库、上下文过长或原型结论回流时，必须留下 `handoff` 或等价交接记录，至少包含来源资产、当前阶段、未决问题、验证命令和下一步责任人。
 - 每个垂直切片完成时必须回勾 `Build Architecture Checklist`，用 `implemented`、`seam-deferred`、`drift`、`violation` 或 `not-applicable` 标记状态，并提供证据或补齐落点。`drift` 触发 Architecture Re-check；`violation` 阻断继续 build。
 - Repository / Gateway / 持久化、权限 / 授权、审计、SQL / DDL / 迁移、文件上传下载、版本快照 / 元数据 / 血缘 / 查询索引、部署 / 回滚 / 运维约束，必须在 checklist 中逐项绑定切片和人审要求。
 - 每个主阶段结束都要做 issue tracker 同步：按用户明确选择或当前仓库主远端路由到 GitLab / GitHub，更新对应 PRD、垂直切片 Issue、里程碑或评论，记录阶段状态、完成范围、验证证据、阻塞项、下一步和安全人审点。
 - 每个主阶段结束都要做 Git checkpoint 判断：列出变更产物、Issue 同步状态、排除无关脏文件，并说明提交 / 推送 / 暂缓原因。
 - 触碰安全红线时，模板中必须标记 `TODO-HUMAN-REVIEW`，Agent 只能生成草案。
 - 任何“完成 / 可合并 / 可发布”结论必须有 fresh verification 证据。
+- 发生 merge / rebase 冲突时，必须按 `resolving-merge-conflicts` 或等价流程记录双方意图、取舍和重新验证结果。
+- 修改 AGENTS、流程模板或技能说明时，必须按 `writing-skills` 思路补充压力场景或验证说明，避免流程规则只停留在不可执行文字。

package/template/docs/process/product-prototype-workflow.md

@@ -0,0 +1,82 @@
+# 产品原型工作流
+
+本文定义 YSS Harness 中有 UI 功能的最小产品原型链路。目标是用 `grill-with-docs` 问清需求，用 `product-design:index` 统一原型产出入口，用 `antd` CLI 固化 Ant Design v6 事实校验，并由 YSS 生命周期负责评审、用户确认和 PRD / OpenAPI 回填。
+
+## 适用范围
+
+- 新产品、新模块或较大 UI 功能。
+- 影响主流程、权限状态、异常状态、页面导航或 OpenAPI 反推清单的 UI 变更。
+- 已进入 PRD 初稿 / 需求基线流程，且存在用户界面的功能。
+
+小文案、局部样式、配置微调或不进入 PRD 生命周期的低风险变更，可在影响面评估中说明不适用。
+
+## 标准链路
+
+```text
+grill-with-docs
+-> PRD / 产品总体设计
+-> yss-design-system
+-> product-design:index
+-> Product Design focused skills
+-> antd CLI 校验
+-> prototype-review
+-> 用户确认
+-> PRD 校准 / OpenAPI Draft
+```
+
+## 职责边界
+
+| 环节 | 主入口 | 职责 |
+|---|---|---|
+| 需求质询 | `grill-with-docs` | 澄清用户、痛点、边界、反例、验收标准和领域术语 |
+| 设计系统基线 | `yss-design-system` | 固定 YSS / Ant Design 企业级设计风格、token 和组件使用约束 |
+| 原型路由 | `product-design:index` | 根据输入路由到 Product Design focused skill；不直接承担产出 |
+| 原型产出 | `$get-context` / `$ideate` / `$prototype` / `$image-to-code` / `$url-to-code` | 产出低保真 / 高保真页面、交互说明、可演示原型和可分享资产 |
+| AntD 事实校验 | `antd` CLI | 查询 Ant Design v6 设计语言、组件 API、demo、token 和 semantic 信息 |
+| 阶段评审 | `prototype-review` | Fail-closed 评审页面流、状态矩阵、权限、异常、OpenAPI 反推和验收标准 |
+| 用户确认 | `docs/design/templates/prototype-confirmation-template.md` | 记录高保真 HTML 原型是否被用户确认，并决定能否进入 PRD 校准 / OpenAPI Draft |
+
+## 产物要求
+
+有 UI 的功能至少沉淀：
+
+- PRD 初稿：`docs/requirements/<feature>-prd.md`
+- 产品总体设计 / 功能架构：`docs/design/<feature>-product-overview-design.md`
+- 交互说明：`docs/design/<feature>-interaction-spec.md`
+- 状态矩阵：`docs/design/<feature>-state-matrix.md`
+- 原型评审：`docs/design/<feature>-prototype-review.md`
+- 高保真 HTML 原型：`docs/design/prototypes/<feature>/index.html`
+- 用户确认记录：`docs/design/<feature>-prototype-confirmation.md`
+
+高保真 HTML 原型必须使用 Ant Design v6。系统 / Agent 可以自动产出，但产出后必须获得用户确认并记录确认结果；未确认前不得进入 PRD 校准、需求冻结或 UI 驱动 OpenAPI Draft。
+
+## AntD CLI 门禁
+
+原型产出前，必须按涉及组件查询 Ant Design v6 事实，不得凭记忆写组件 API：
+
+```bash
+antd design.md --version 6.0.0 --format json
+antd info <Component> --version 6.0.0 --format json
+antd demo <Component> <demo> --version 6.0.0 --format json
+antd token <Component> --version 6.0.0 --format json
+antd semantic <Component> --version 6.0.0 --format json
+```
+
+原型产出后，必须记录：
+
+- 查询过的组件和命令。
+- 采用的 demo / token / semantic 结论。
+- `antd lint <prototype path> --format json` 的结果；若原型目录不支持 lint，记录不适用原因和替代人工校验。
+
+## 回退规则
+
+- 需求边界不清：回到 `grill-with-docs`。
+- 缺产品总体设计 / 功能架构：回到 `docs/design/<feature>-product-overview-design.md`。
+- 没有视觉目标且需要新 UI：按 Product Design 规则先走 `$get-context`，再走 `$ideate`，展示 3 个视觉方向并等待用户选择。
+- 原型评审阻断：回到 Product Design focused skill 补齐页面流、状态矩阵、权限或异常路径。
+- 用户未确认：不得进入 PRD 校准 / OpenAPI Draft。
+- 触碰安全红线：标记 `TODO-HUMAN-REVIEW`，不得直接交付生产实现。
+
+## 兼容策略
+
+`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 暂不物理删除，只作为历史兼容入口或产物门禁名称保留。新的产品原型产出默认使用 `product-design:index`。跑通 2 到 3 个真实 UI 功能后，再评估是否删除 legacy 技能。

package/template/docs/user-guide/product-lifecycle-workflow.md

@@ -172,7 +172,7 @@ docs/process/lifecycle-artifact-map.md
 
 ### 6.3 设计产品和契约
 
-有 UI 时先走设计系统、产品设计、低保真原型评审和 Ant Design v6 高保真 HTML 原型。涉及 API 时，先生成 review-only OpenAPI Draft：
+有 UI 时先走设计系统、`product-design:index` 路由的产品设计、低保真原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录。涉及 API 时，先生成 review-only OpenAPI Draft：
 
 ```text
 基于 PRD 和产品设计，生成 OpenAPI 3.1 Draft。
@@ -206,7 +206,7 @@ OpenAPI Freeze 或无 API 影响记录完成后使用 `to-issues`：
 
 - Draft 阶段允许调整接口，但不能被当成稳定实现契约。
 - Freeze 后的契约变更必须回到 API 影响分析、架构 / 数据设计和 Design Review，不能边写代码边悄悄改接口。
-- OpenAPI 不得只基于 PRD 反推：必须结合产品总体设计 / 功能架构；有 UI 时还必须结合页面 / 原型 / 交互说明、状态矩阵、低保真原型评审和 Ant Design v6 高保真 HTML 原型。
+- OpenAPI 不得只基于 PRD 反推：必须结合产品总体设计 / 功能架构；有 UI 时还必须结合页面 / 原型 / 交互说明、状态矩阵、低保真原型评审、Ant Design v6 高保真 HTML 原型、AntD CLI 校验证据和用户确认记录。
 - OpenAPI Freeze 后进入 `to-issues`，再进入前后端实现和契约测试。
 
 ## 8. 验证、发布和复盘

package/template/docs/user-guide/product-rd-lifecycle-best-practices.md

@@ -147,9 +147,9 @@ skills 是让 AI 按规程工作的“操作手册”，不是关键词装饰。
 | 模糊需求追问 | `grill-with-docs` | 先问清，不让 AI 猜规则；稳定术语写 `CONTEXT.md` |
 | 生成 PRD 初稿 / 需求基线 | `to-prd` 或 PRD 模板 | 只基于已确认事实，不把待确认项写成需求 |
 | 产品总体设计 / 功能架构 | `docs/design/templates/product-overview-design-template.md` | PRD 初稿后的必要产物；必须包含低保真原型 / 页面草图；进入页面 / 原型 / 交互设计、PRD 校准或 OpenAPI Draft 前必须完成 |
-| 页面和交互设计 | `product-design-prototype`、`wireframe-prototype`、`docs/design/` | 基于 PRD 初稿和产品总体设计细化页面流、状态和交互，再回填 PRD 并反推 API |
+| 页面和交互设计 | `product-design:index`、Product Design focused skills、`docs/design/` | 基于 PRD 初稿和产品总体设计细化页面流、状态和交互，再回填 PRD 并反推 API |
 | 原型评审 | `prototype-review` | 未通过时回到产品设计；通过后进入高保真 HTML 原型，不直接进入 PRD 校准 / API 影响分析 / 契约草案 |
-| 高保真 HTML 原型 | `high-fidelity-html-prototype` | 低保真评审通过后的强制产物；必须使用 Ant Design v6，并基于官方 `@ant-design/cli` / Ant Design For Agents 指引，输出 `docs/design/prototypes/<feature>/index.html` |
+| 高保真 HTML 原型 | `product-design:index` 路由到 Product Design focused skill；`antd` CLI | 低保真评审通过后的强制产物；必须使用 Ant Design v6，输出 `docs/design/prototypes/<feature>/index.html`，记录 AntD CLI 校验证据并获得用户确认 |
 | API 契约 | API 影响分析 / 契约草案 / OpenAPI Freeze 流程 | Draft 可讨论，Freeze 才可开发 |
 | 正式变更设计 | `to-issues` / Matt skills | 复用 PRD，聚焦技术方案、风险和测试 seam |
 | 拆切片 | `to-issues` | 必须是端到端垂直切片 |
@@ -471,17 +471,19 @@ docs/design/data-modeling-state-matrix.md
 docs/design/data-modeling-prototype-review.md
 ```
 
-推荐使用 `product-design-prototype` 作为入口，并按需要追加专项 skill：
+推荐使用 `product-design:index` 作为产品原型主入口，并按 Product Design plugin 规则路由到 focused skill：
 
 | 目标 | 推荐技能 / 工具 | 说明 |
 |---|---|---|
-| 页面清单、用户流、状态矩阵、PRD 回填项、OpenAPI 反推 | `product-design-prototype` | 基于 PRD 初稿和产品总体设计后的原型入口 |
-| 低保真线框、流程草图 | `wireframe-prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
+| 页面清单、用户流、状态矩阵、PRD 回填项、OpenAPI 反推 | `product-design:index` -> `$get-context` / `$prototype` | 基于 PRD 初稿和产品总体设计后的原型入口 |
+| 低保真线框、流程草图 | `product-design:index` -> `$ideate` / `$prototype`；Excalidraw / Markdown wireframe | 适合快速讨论，不绑定工程依赖 |
 | 高保真或设计系统协作 | Figma / Penpot，必要时使用 `figma` / `figma-use` | 适合设计团队和组件规范沉淀 |
-| 高保真可交互 HTML 原型 | `high-fidelity-html-prototype`；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 PRD 校准和 API 反推前的体验确认 |
+| 高保真可交互 HTML 原型 | `product-design:index` -> `$prototype` / `$image-to-code` / `$url-to-code`；`antd` CLI；Ant Design v6 | 低保真原型评审通过后的必需产物，用于 PRD 校准和 API 反推前的体验确认 |
 | 图谱、血缘、流程编排画布 | tldraw / xyflow | 适合数据血缘、任务流、关系图等画布型体验 |
 | 进入高保真前门禁 | `prototype-review` | 未通过则回到原型阶段 |
 
+`product-design-prototype`、`wireframe-prototype`、`high-fidelity-html-prototype` 仅作为历史兼容入口或产物门禁名称保留；新的产品原型产出默认使用 `product-design:index`。
+
 如果团队使用 Figma、即时设计、Axure 或其它原型工具，可以在 `docs/design/data-modeling-interaction-spec.md` 中保存链接、版本、评审记录和关键截图说明。第一版不强制引入 Excalidraw、Figma、Penpot、tldraw 或 xyflow 作为项目依赖。
 
 数据建模 MVP 的页面清单示例：
@@ -531,9 +533,10 @@ docs/design/data-modeling-prototype-review.md
 推荐提示词：
 
 ```text
-使用 product-design-prototype。
+使用 product-design:index。
 基于 docs/requirements/data-modeling-prd.md 和 docs/design/data-modeling-product-overview-design.md，
 为“数据中台数据建模 MVP”输出页面 / 原型 / 交互设计资产。
+请先按 Product Design plugin 规则路由到合适的 focused skill：$get-context / $ideate / $prototype / $image-to-code / $url-to-code。
 请生成页面清单、用户主路径、异常路径、低保真线框说明、交互状态矩阵、权限状态、空态/加载态/错误态，
 并明确这些设计如何反推 OpenAPI 字段、错误结构、分页筛选和前端验收标准。
 保存到 docs/design/data-modeling-interaction-spec.md。
@@ -1022,9 +1025,10 @@ docs/user-guide/
 ### 20.4 页面 / 原型 / 交互设计
 
 ```text
-使用 product-design-prototype。
+使用 product-design:index。
 基于 <PRD 路径> 和 docs/design/<feature>-product-overview-design.md，为 <功能名> 输出页面 / 原型 / 交互设计资产。
 如果缺少产品总体设计 / 功能架构，先阻断并要求补齐；不要直接继续生成交互设计。
+请先按 Product Design plugin 规则路由到合适的 focused skill：$get-context / $ideate / $prototype / $image-to-code / $url-to-code。
 请生成页面清单、用户主路径、异常路径、低保真线框说明、交互状态矩阵、权限状态、空态/加载态/错误态。
 请明确这些设计如何反推 OpenAPI 字段、错误结构、分页筛选、权限和前端验收标准。
 请同时列出需要回填 PRD 的需求缺口、验收标准或非目标范围。
@@ -1044,12 +1048,13 @@ docs/user-guide/
 ### 20.6 高保真 HTML 原型
 
 ```text
-使用 high-fidelity-html-prototype。
+使用 product-design:index，并路由到合适的 Product Design focused skill。
 基于 <PRD 路径>、docs/design/<feature>-product-overview-design.md、docs/design/<feature>-interaction-spec.md、docs/design/<feature>-state-matrix.md 和 docs/design/<feature>-prototype-review.md，
 为 <功能名> 生成 Ant Design v6 高保真可交互 HTML 原型。
 输出路径必须是 docs/design/prototypes/<feature>/index.html。
+产出前必须使用 `antd` CLI 查询设计语言、组件 API、demo、token 和 semantic 信息，不要凭记忆写 Ant Design v6 组件。
 请覆盖主流程、关键异常、loading/empty/error/no-permission/readonly/disabled/conflict/success 状态、表单校验、弹窗/抽屉、响应式断点。
-完成后给出 Ant Design v6 版本依据、`@ant-design/cli` 查询过的组件 / token / demo 和本地浏览器验证证据。
+完成后给出 Ant Design v6 版本依据、`antd` CLI 查询过的组件 / token / demo / semantic、本地浏览器验证证据，并使用 docs/design/templates/prototype-confirmation-template.md 记录用户确认。
 ```
 
 ### 20.7 PRD 校准 / 需求冻结

package/template/scripts/verify-template

@@ -38,27 +38,14 @@ matt_skill_roots=(
 )
 
 removed_flow_paths=(
-  ".comet"
   "docs/superpowers"
   "openspec"
-  ".codex/rules/comet-phase-guard.md"
-  ".claude/rules/comet-phase-guard.md"
-  ".trae/rules/comet-phase-guard.md"
-  ".pi/extensions/comet-commands.ts"
   ".agent/workflows"
   ".claude/commands/opsx"
   ".pi/prompts"
 )
 
 removed_skill_names=(
-  "comet"
-  "comet-archive"
-  "comet-build"
-  "comet-design"
-  "comet-hotfix"
-  "comet-open"
-  "comet-tweak"
-  "comet-verify"
   "openspec-apply-change"
   "openspec-archive-change"
   "openspec-bulk-archive-change"
@@ -98,7 +85,6 @@ legacy_text_paths=(
 legacy_text_patterns=(
   "active change"
   "openspec/changes"
-  ".comet.yaml"
   "openspec list"
   "test-driven-development"
   "requesting-code-review"

package/template/skills-lock.json

@@ -1,28 +1,23 @@
 {
   "version": 2,
-  "source": {
-    "name": "mattpocock/skills",
-    "sourceType": "github",
-    "ref": "272f99b22574f50e4266791c86b9302682970e23",
-    "path": "skills/engineering"
-  },
-  "additionalSources": {
-    "competitive-intelligence": {
-      "name": "anthropics/knowledge-work-plugins",
-      "sourceType": "github",
-      "ref": "main",
-      "path": "sales/skills/competitive-intelligence"
-    }
-  },
   "skills": {
     "ask-matt": {
-      "skillPath": "skills/engineering/ask-matt/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/ask-matt/SKILL.md",
+      "computedHash": "2d3f523c8bf1ebbd4d5ecaa1e2678ec629f157248669f1edba807de1d0feb031"
     },
     "code-review": {
-      "skillPath": "skills/engineering/code-review/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/code-review/SKILL.md",
+      "computedHash": "4a17d9d3e0fc87ae48544d371a820fac5a4a78f4c05e7e6b3229094fbf8a7e26"
     },
     "codebase-design": {
-      "skillPath": "skills/engineering/codebase-design/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/codebase-design/SKILL.md",
+      "computedHash": "2426dc4accf1a85dedfb560edb3a877ec8828b7375ea08c970df2b6c900a2a22"
     },
     "competitive-intelligence": {
       "skillPath": "sales/skills/competitive-intelligence/SKILL.md",
@@ -32,40 +27,88 @@
       "skillPath": "skills/engineering/diagnosing-bugs/SKILL.md"
     },
     "domain-modeling": {
-      "skillPath": "skills/engineering/domain-modeling/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/domain-modeling/SKILL.md",
+      "computedHash": "67343881f5def98487d56243155716110afbcbf22ec92421c882d532b941cb17"
+    },
+    "grill-me": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/grill-me/SKILL.md",
+      "computedHash": "f321507f77702a54af1db66549ec1685fc625390d06c57d7949cdcda8eb1b5c7"
     },
     "grill-with-docs": {
-      "skillPath": "skills/engineering/grill-with-docs/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
+      "computedHash": "e7ef25bbee50cda2eb7b3a8ef541db0a0396dad7d369f7d14fb610671dd1864b"
+    },
+    "grilling": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/grilling/SKILL.md",
+      "computedHash": "1de9e777a60b184b29412fadacb7bbde8c14bb7037e5c4d9d086c941281d1742"
+    },
+    "handoff": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/productivity/handoff/SKILL.md",
+      "computedHash": "5d0f81e38abe6b984e1feaa731927de5291d040982106ac513cf54ec240e00ec"
     },
     "implement": {
       "skillPath": "skills/engineering/implement/SKILL.md"
     },
     "improve-codebase-architecture": {
-      "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/improve-codebase-architecture/SKILL.md",
+      "computedHash": "8bf292143ca93b00276a0de0fc5f84f2381f4690c5b0d32e99fa283a072f392f"
     },
     "prototype": {
-      "skillPath": "skills/engineering/prototype/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/prototype/SKILL.md",
+      "computedHash": "e70c8933d30153a4da47865829d356824b2a830367275e3b00c7b431a1544a79"
     },
     "research": {
-      "skillPath": "skills/engineering/research/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/research/SKILL.md",
+      "computedHash": "87d17f5103899fbe179b552a85485d50f2316ca5b3128f5716af7d88817533e1"
     },
     "resolving-merge-conflicts": {
       "skillPath": "skills/engineering/resolving-merge-conflicts/SKILL.md"
     },
     "setup-matt-pocock-skills": {
-      "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/setup-matt-pocock-skills/SKILL.md",
+      "computedHash": "a7d798f49081ea5b2606e8bcafa3bc2b34177cfaa24d71c2ddf2d433f4006a4a"
     },
     "tdd": {
-      "skillPath": "skills/engineering/tdd/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/tdd/SKILL.md",
+      "computedHash": "c9326b88419cfba1d54dd713b7ddb23020e6a93f4b0d13aea58cebba58cda2ee"
     },
     "to-issues": {
-      "skillPath": "skills/engineering/to-issues/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-issues/SKILL.md",
+      "computedHash": "4406ded5e0fb356b9ac8be777270f62d3c5d206a0bc848aaadb19919702a1892"
     },
     "to-prd": {
-      "skillPath": "skills/engineering/to-prd/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/to-prd/SKILL.md",
+      "computedHash": "5a733e19d825f22e83de52e68b8840c9fd2fa7501282277a122c1aa28a922059"
     },
     "triage": {
-      "skillPath": "skills/engineering/triage/SKILL.md"
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "skillPath": "skills/engineering/triage/SKILL.md",
+      "computedHash": "b77ea99c2e6e97815b373cc476ad4cc1835d3e736867b764602147be71f6c131"
     }
   }
 }

package/template/.codex/skills/yss-anti-scheduler/SKILL.md

@@ -1,53 +0,0 @@
----
-name: yss-anti-scheduler
-description: 用于 YSS anti-corrosion anti-scheduler、DolphinScheduler SDK、调度器 API client、工作流/任务/租户/资源中心客户端接入和排障。
----
-
-# yss-anti-scheduler
-
-Use this skill for YSS 调度器防腐层组件. Keep implementation grounded in the local project and resolvable YSS backend component source.
-
-中文说明：本技能用于 YSS 调度器防腐层组件，覆盖统一 Scheduler API 以及 DolphinScheduler、DM Scheduler、XXL-JOB、ElasticJob 等后端适配。执行时优先读取源码索引，避免凭记忆猜类名、配置项或接入方式。
-
-## Source Index First
-
-- Backend source location is environment-specific; resolve it with `yss-source-index/references/source-location.md`.
-- Generated index: `references/source-index.md`
-- Component path hints: `yss-microservice-components/yss-component-anti-corrosion/yss-component-anti-scheduler`
-
-Read `references/source-index.md` as a path-hint index whenever the task depends on exact modules, annotations, auto configuration, properties, controllers, clients, repositories, DTOs, handlers, or troubleshooting.
-
-## Workflow
-
-1. Identify whether the task targets the unified scheduler API, a concrete scheduler backend, generated SDK client calls, workflow/task/resource APIs, cron/schedule behavior, or execution/log troubleshooting.
-2. Read `references/source-index.md`, then start from the unified API module before touching a backend adapter.
-3. Prefer `SchedulerFacadeApi` as the application-facing entry point; it combines execution commands, cron commands, executor operations, and query operations.
-4. For execution behavior, inspect `SchedulerExecutor`; for query/log/history behavior, inspect `SchedulerQuery`; for schedule expression behavior, inspect `SchedulerCronCommand` and `SchedulerCron`.
-5. Choose the concrete backend adapter only after the target scheduler is known: DM Scheduler, DolphinScheduler, XXL-JOB, or ElasticJob.
-6. For raw REST/API interactions, inspect the generated SDK module matching the backend (`dm-scheduler-sdk`, `dolphinscheduler-sdk`, `xxljob-sdk`) and its `ApiClient`/server configuration.
-7. Keep backend-specific models isolated behind the anti-corrosion API unless the task is explicitly adapter development.
-
-## Capability Split
-
-- Unified API: `yss-component-anti-scheduler-api`, especially `SchedulerFacadeApi`, `SchedulerExecutor`, `SchedulerQuery`, `SchedulerCronCommand`, and `SchedulerFactory`.
-- DM Scheduler adapter: `yss-component-anti-scheduler-dmscheduler` plus `dm-scheduler-sdk`.
-- DolphinScheduler adapter: `yss-component-anti-scheduler-dolphin` plus `dolphinscheduler-sdk`.
-- XXL-JOB adapter: `yss-component-anti-scheduler-xxljob` plus `xxljob-sdk`.
-- ElasticJob adapter: `yss-component-anti-scheduler-elasticjob`.
-- Cross-domain APIs: task flow, task definition/instance, workflow execution, resource/file, tenant/user, datasource, quality, tag, variable, and log APIs in generated clients.
-
-## Checklist
-
-- Required dependency or scheduler adapter module is present.
-- Target scheduler backend is identified before using backend-specific APIs.
-- Scheduler host/token/auth/server configuration is externalized.
-- Task group, task instance, cron, and log identifiers use the component domain model consistently.
-- `stop`, `taskInstance`, subtask, and other default methods may be unsupported by some backends; check implementation before relying on them.
-- Backend-specific DTOs do not leak into business modules unless the adapter boundary is the task.
-- Execution/log/retry operations are checked against scheduler permissions and environment.
-
-## Do Not
-
-- Do not invent class names or configuration keys without checking the source index.
-- Do not replace component extension points with business-local framework code.
-- Do not broaden the task into unrelated YSS components unless the user asks.

package/template/.codex/skills/yss-anti-scheduler/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "yss-anti-scheduler"
-  short_description: "YSS component skill for yss-anti-scheduler"
-  default_prompt: "Use yss-anti-scheduler for this YSS backend component task."