@gong-ym/ai-spec-auto 0.2.13 → 0.2.15

package/.agents/skills/domains/web/route-permission-map/SKILL.md

@@ -1,103 +1,103 @@
----
-name: route-permission-map
-description: 从路由配置、权限守卫和菜单/侧栏配置中整理“路由 ↔ 权限 ↔ 菜单”映射，并检查未保护路由、死链、权限不一致和懒加载问题。当用户说“路由和菜单对一下”“未保护路由”“路由权限映射”“菜单权限不一致”时使用。
-compatibility: Requires a local repository workspace with route definitions, menu/sidebar config, and permission guard code available for inspection.
----
-
-# 路由权限映射与审计
-
-## 使用时机
-
-当你需要：
-
-- 核对路由、菜单和权限是否一致
-- 审查未保护路由、死链或错误的菜单显隐
-- 梳理某个前端应用的权限边界
-
-## 核心原则
-
-- 先识别框架，再按对应分支扫描
-- 只根据仓库实际代码与配置建立映射，不臆测隐藏规则
-- 输出以映射表、问题项和修复建议为主
-- 若在当前协议流程中，优先把结论沉淀到 `checklist.md`、`verification-review-notes` 或用户指定文档
-
-## 步骤 1：识别前端框架
-
-先看 `package.json`：
-
-- `next` → Next.js
-- `vue` / `vue-router` → Vue
-- `react` + `react-router` / `react-router-dom` → React
-- 多应用仓库时，按当前目标应用所在子包判断
-
-## 步骤 2：定位三类来源
-
-必须同时找出：
-
-1. 路由定义
-2. 权限守卫或路由级权限元数据
-3. 菜单 / 侧栏配置
-
-优先提取这些字段：
-
-- `path`
-- `component / element / page`
-- `meta.roles / meta.permission / requiresAuth`
-- 菜单 `title / icon / hidden / children`
-- 是否懒加载
-
-## 步骤 3：建立映射表
-
-至少输出：
-
-| path | 路由来源 | 权限/角色 | 菜单标题 | 是否隐藏 | 是否懒加载 |
-|------|----------|-----------|----------|----------|------------|
-
-如果菜单来自接口，明确写出“菜单数据来自接口，需和前后端约定对齐”。
-
-## 步骤 4：执行四类检查
-
-### 1. 未保护路由
-
-- 除登录页、404、公开页外，未被任何 guard 或权限元数据覆盖的路由
-
-### 2. 死链
-
-- 菜单 path 在路由清单中不存在
-- redirect 目标不存在
-
-### 3. 菜单与权限不一致
-
-- 菜单做了权限控制但路由无守卫
-- 路由有权限要求但菜单无显隐控制
-
-### 4. 懒加载合理性
-
-- 首屏关键路由被过度懒加载
-- 子页面拆包过细，导致请求过多
-
-## 输出模板
-
-```md
-## 路由权限映射报告
-
-### 路由清单
-| path | 权限/角色 | 是否懒加载 | 来源 |
-|------|-----------|------------|------|
-
-### 菜单映射
-| 菜单 path | 菜单标题 | 路由存在 | 权限是否一致 |
-|-----------|----------|----------|--------------|
-
-### 发现的问题
-- 未保护路由：
-- 死链：
-- 菜单与权限不一致：
-- 懒加载建议：
-```
-
-## 注意事项
-
-- 路径统一按正斜杠比较
-- 区分公开页与“漏加守卫”的业务页
-- 只给出审计与修复建议，不自动改代码
+---
+name: route-permission-map
+description: 从路由配置、权限守卫和菜单/侧栏配置中整理“路由 ↔ 权限 ↔ 菜单”映射，并检查未保护路由、死链、权限不一致和懒加载问题。当用户说“路由和菜单对一下”“未保护路由”“路由权限映射”“菜单权限不一致”时使用。
+compatibility: Requires a local repository workspace with route definitions, menu/sidebar config, and permission guard code available for inspection.
+---
+
+# 路由权限映射与审计
+
+## 使用时机
+
+当你需要：
+
+- 核对路由、菜单和权限是否一致
+- 审查未保护路由、死链或错误的菜单显隐
+- 梳理某个前端应用的权限边界
+
+## 核心原则
+
+- 先识别框架，再按对应分支扫描
+- 只根据仓库实际代码与配置建立映射，不臆测隐藏规则
+- 输出以映射表、问题项和修复建议为主
+- 若在当前协议流程中，优先把结论沉淀到 `checklist.md`、`verification-review-notes` 或用户指定文档
+
+## 步骤 1：识别前端框架
+
+先看 `package.json`：
+
+- `next` → Next.js
+- `vue` / `vue-router` → Vue
+- `react` + `react-router` / `react-router-dom` → React
+- 多应用仓库时，按当前目标应用所在子包判断
+
+## 步骤 2：定位三类来源
+
+必须同时找出：
+
+1. 路由定义
+2. 权限守卫或路由级权限元数据
+3. 菜单 / 侧栏配置
+
+优先提取这些字段：
+
+- `path`
+- `component / element / page`
+- `meta.roles / meta.permission / requiresAuth`
+- 菜单 `title / icon / hidden / children`
+- 是否懒加载
+
+## 步骤 3：建立映射表
+
+至少输出：
+
+| path | 路由来源 | 权限/角色 | 菜单标题 | 是否隐藏 | 是否懒加载 |
+|------|----------|-----------|----------|----------|------------|
+
+如果菜单来自接口，明确写出“菜单数据来自接口，需和前后端约定对齐”。
+
+## 步骤 4：执行四类检查
+
+### 1. 未保护路由
+
+- 除登录页、404、公开页外，未被任何 guard 或权限元数据覆盖的路由
+
+### 2. 死链
+
+- 菜单 path 在路由清单中不存在
+- redirect 目标不存在
+
+### 3. 菜单与权限不一致
+
+- 菜单做了权限控制但路由无守卫
+- 路由有权限要求但菜单无显隐控制
+
+### 4. 懒加载合理性
+
+- 首屏关键路由被过度懒加载
+- 子页面拆包过细，导致请求过多
+
+## 输出模板
+
+```md
+## 路由权限映射报告
+
+### 路由清单
+| path | 权限/角色 | 是否懒加载 | 来源 |
+|------|-----------|------------|------|
+
+### 菜单映射
+| 菜单 path | 菜单标题 | 路由存在 | 权限是否一致 |
+|-----------|----------|----------|--------------|
+
+### 发现的问题
+- 未保护路由：
+- 死链：
+- 菜单与权限不一致：
+- 懒加载建议：
+```
+
+## 注意事项
+
+- 路径统一按正斜杠比较
+- 区分公开页与“漏加守卫”的业务页
+- 只给出审计与修复建议，不自动改代码

package/.agents/skills/domains/web/ui-verification/SKILL.md

@@ -1,114 +1,114 @@
----
-name: ui-verification
-description: 当用户需要按设计稿验收页面、复核 UI 还原质量或输出 UI 问题清单时，使用浏览器工具对实际页面与设计稿做可追踪比对并沉淀验收结论。
-compatibility: Requires browser tooling plus access to the target page, design source (.pen/Figma), and local docs/样式还原/ output paths.
----
-
-# UI 验收
-
-## 核心原则
-
-**最终验收标准**：以**实际运行页面的效果**与 **UI 稿（.pen 或 Figma）** 进行比对得出结论，而不是仅凭代码或分析清单推断。
-
-**工具选择**：优先使用 Cursor 的 Browser（`@Browser`），仅当不在 Cursor 或 Browser 不可用时使用 Playwright MCP。详见 `rules/tools-browser-navigation.md`。
-
-**比对方式**：必须进行可落地的比对之一或组合：页面截图 vs 设计稿截图，或页面元素 vs 设计稿元素。详见 `rules/tools-design-guidelines.md`。
-
-**验收顺序**：从上到下 → 从左到右 → 从外到里。先按顺序过一遍 P0（布局、层级、内容-文字与图片），再逐项比对 P1/P2 维度。详见 `rules/comparison-*.md`。
-
----
-
-## 使用时机
-
-当需要做「UI 还原验收」时使用本技能：
-- 实现完成后，需要对照设计稿检查还原度
-- 需要产出一份可追踪的 **UI 问题清单**，并据此修复与再验证
-- 需要做「分析不足反思」，反哺设计稿分析（design-analysis）
-
-## 环境依赖
-
-- 优先依赖 Browser 工具；不可用时再退回 Playwright MCP
-- 默认问题清单与反思文档写入 `docs/样式还原/`
-
-## 注意事项
-
-- 只看代码不看页面，验收结果无效
-- 没有设计稿时，本技能不能替代需求定义
-
----
-
-## 前置条件
-
-- **有可访问的实现页面**：本地或目标环境已启动；在 Cursor 中优先用 `@Browser` 打开目标 URL
-- **有设计稿可对照**：`.pen`（Pencil 设计稿）或 Figma 链接可访问
-- **有分析清单（推荐）**：`docs/样式还原/<名称>-UI分析清单.md` 可作为比对时的检查项
-
-若尚未有分析清单但已有设计稿，可先使用 `.agents/skills/design-analysis/SKILL.md` 产出分析清单。
-
----
-
-## 目标产出
-
-- **UI 问题清单**：`docs/样式还原/<名称>-UI问题清单.md`（详见 `rules/workflow-problem-list.md`）
-- **分析不足反思（可选）**：反哺 design-analysis（详见 `rules/workflow-reflection.md`）
-
----
-
-## 工作流程（5步）
-
-1. **使用浏览器工具查看实际页面**：在 Cursor 中优先使用 `@Browser`，获取实际页面可比对信息。详见 `rules/tools-browser-navigation.md` 和 `rules/tools-design-guidelines.md`
-2. **实际页面与设计稿比对**：截图比对或元素级比对，按 P0/P1/P2 维度逐项比对。详见 `rules/comparison-*.md`
-3. **产出 UI 问题清单**：将差异点记录到问题清单。详见 `rules/workflow-problem-list.md`
-4. **修复与再验证**：先修 P0，再 P1，再 P2；修复后必须再次使用 Browser 工具验证。详见 `rules/tools-browser-navigation.md`
-5. **反思分析不足（可选）**：将「哪些问题是因为分析没做到位」总结下来，反哺 design-analysis。详见 `rules/workflow-reflection.md`
-
----
-
-## 快速参考
-
-### 编写时的设计常识（应在实现阶段遵循）
-- `rules/writing-page-container-width.md` - 页面容器宽度规则
-- `rules/writing-list-layout.md` - 横向列表布局规则
-- `rules/writing-element-completeness.md` - 元素展示完整性规则
-- `rules/writing-alignment.md` - 对齐方式规则
-
-### 常见错误模式（验收时特别关注）
-- `rules/errors-page-container-width.md` - 页面容器宽度限制
-- `rules/errors-grid-container-width.md` - Grid 容器宽度问题
-- `rules/errors-css-priority.md` - CSS 优先级覆盖
-- `rules/errors-flex-layout.md` - Flex 布局问题
-- `rules/errors-flex-column-width.md` - 换行后列宽不一致
-- `rules/errors-alignment.md` - 对齐方式错误
-- `rules/errors-button-dimensions.md` - 按钮尺寸问题
-- `rules/errors-button-position.md` - 按钮定位问题
-
-### 比对维度（P0 级，验收时不得遗漏）
-- `rules/comparison-layout.md` - 布局比对
-- `rules/comparison-hierarchy.md` - 层级比对
-- `rules/comparison-content-text.md` - 文字内容比对
-- `rules/comparison-content-image.md` - 图片内容比对
-
-### 工具使用指南
-- `rules/tools-browser-navigation.md` - 浏览器工具打开页面
-- `rules/tools-design-guidelines.md` - 设计稿工具使用（Pencil/Figma）
-
-### 工作流程模板
-- `rules/workflow-problem-list.md` - UI 问题清单文档结构
-- `rules/workflow-reflection.md` - 反思分析不足模板
-- `rules/workflow-checklist.md` - 快速检查清单
-
----
-
-## 与其它技能的关系
-
-- **design-analysis**：依赖其产出的「UI 分析清单」；验收后的反思用于完善该技能
-- **create-proposal**：提案前置分析时若涉及设计稿，会在后置检查中确认 tasks.md 包含 UI 验收任务，引用本技能执行验收
-- **create-route / create-component**：修复问题时可能涉及路由或组件的样式与结构修改
-
----
-
-## 相关规范
-
-- `.agents/skills/design-analysis/SKILL.md` - 设计稿分析（产出分析清单）
-- `.agents/skills/create-proposal/SKILL.md` - 提案前置分析与 OpenSpec 增强层（后置检查中确认包含验收任务）
-- `.agents/rules/09-样式规范.md` - 设计稿颜色提取
+---
+name: ui-verification
+description: 当用户需要按设计稿验收页面、复核 UI 还原质量或输出 UI 问题清单时，使用浏览器工具对实际页面与设计稿做可追踪比对并沉淀验收结论。
+compatibility: Requires browser tooling plus access to the target page, design source (.pen/Figma), and local docs/样式还原/ output paths.
+---
+
+# UI 验收
+
+## 核心原则
+
+**最终验收标准**：以**实际运行页面的效果**与 **UI 稿（.pen 或 Figma）** 进行比对得出结论，而不是仅凭代码或分析清单推断。
+
+**工具选择**：优先使用 Cursor 的 Browser（`@Browser`），仅当不在 Cursor 或 Browser 不可用时使用 Playwright MCP。详见 `rules/tools-browser-navigation.md`。
+
+**比对方式**：必须进行可落地的比对之一或组合：页面截图 vs 设计稿截图，或页面元素 vs 设计稿元素。详见 `rules/tools-design-guidelines.md`。
+
+**验收顺序**：从上到下 → 从左到右 → 从外到里。先按顺序过一遍 P0（布局、层级、内容-文字与图片），再逐项比对 P1/P2 维度。详见 `rules/comparison-*.md`。
+
+---
+
+## 使用时机
+
+当需要做「UI 还原验收」时使用本技能：
+- 实现完成后，需要对照设计稿检查还原度
+- 需要产出一份可追踪的 **UI 问题清单**，并据此修复与再验证
+- 需要做「分析不足反思」，反哺设计稿分析（design-analysis）
+
+## 环境依赖
+
+- 优先依赖 Browser 工具；不可用时再退回 Playwright MCP
+- 默认问题清单与反思文档写入 `docs/样式还原/`
+
+## 注意事项
+
+- 只看代码不看页面，验收结果无效
+- 没有设计稿时，本技能不能替代需求定义
+
+---
+
+## 前置条件
+
+- **有可访问的实现页面**：本地或目标环境已启动；在 Cursor 中优先用 `@Browser` 打开目标 URL
+- **有设计稿可对照**：`.pen`（Pencil 设计稿）或 Figma 链接可访问
+- **有分析清单（推荐）**：`docs/样式还原/<名称>-UI分析清单.md` 可作为比对时的检查项
+
+若尚未有分析清单但已有设计稿，可先使用 `.agents/skills/design-analysis/SKILL.md` 产出分析清单。
+
+---
+
+## 目标产出
+
+- **UI 问题清单**：`docs/样式还原/<名称>-UI问题清单.md`（详见 `rules/workflow-problem-list.md`）
+- **分析不足反思（可选）**：反哺 design-analysis（详见 `rules/workflow-reflection.md`）
+
+---
+
+## 工作流程（5步）
+
+1. **使用浏览器工具查看实际页面**：在 Cursor 中优先使用 `@Browser`，获取实际页面可比对信息。详见 `rules/tools-browser-navigation.md` 和 `rules/tools-design-guidelines.md`
+2. **实际页面与设计稿比对**：截图比对或元素级比对，按 P0/P1/P2 维度逐项比对。详见 `rules/comparison-*.md`
+3. **产出 UI 问题清单**：将差异点记录到问题清单。详见 `rules/workflow-problem-list.md`
+4. **修复与再验证**：先修 P0，再 P1，再 P2；修复后必须再次使用 Browser 工具验证。详见 `rules/tools-browser-navigation.md`
+5. **反思分析不足（可选）**：将「哪些问题是因为分析没做到位」总结下来，反哺 design-analysis。详见 `rules/workflow-reflection.md`
+
+---
+
+## 快速参考
+
+### 编写时的设计常识（应在实现阶段遵循）
+- `rules/writing-page-container-width.md` - 页面容器宽度规则
+- `rules/writing-list-layout.md` - 横向列表布局规则
+- `rules/writing-element-completeness.md` - 元素展示完整性规则
+- `rules/writing-alignment.md` - 对齐方式规则
+
+### 常见错误模式（验收时特别关注）
+- `rules/errors-page-container-width.md` - 页面容器宽度限制
+- `rules/errors-grid-container-width.md` - Grid 容器宽度问题
+- `rules/errors-css-priority.md` - CSS 优先级覆盖
+- `rules/errors-flex-layout.md` - Flex 布局问题
+- `rules/errors-flex-column-width.md` - 换行后列宽不一致
+- `rules/errors-alignment.md` - 对齐方式错误
+- `rules/errors-button-dimensions.md` - 按钮尺寸问题
+- `rules/errors-button-position.md` - 按钮定位问题
+
+### 比对维度（P0 级，验收时不得遗漏）
+- `rules/comparison-layout.md` - 布局比对
+- `rules/comparison-hierarchy.md` - 层级比对
+- `rules/comparison-content-text.md` - 文字内容比对
+- `rules/comparison-content-image.md` - 图片内容比对
+
+### 工具使用指南
+- `rules/tools-browser-navigation.md` - 浏览器工具打开页面
+- `rules/tools-design-guidelines.md` - 设计稿工具使用（Pencil/Figma）
+
+### 工作流程模板
+- `rules/workflow-problem-list.md` - UI 问题清单文档结构
+- `rules/workflow-reflection.md` - 反思分析不足模板
+- `rules/workflow-checklist.md` - 快速检查清单
+
+---
+
+## 与其它技能的关系
+
+- **design-analysis**：依赖其产出的「UI 分析清单」；验收后的反思用于完善该技能
+- **create-proposal**：提案前置分析时若涉及设计稿，会在后置检查中确认 tasks.md 包含 UI 验收任务，引用本技能执行验收
+- **create-route / create-component**：修复问题时可能涉及路由或组件的样式与结构修改
+
+---
+
+## 相关规范
+
+- `.agents/skills/design-analysis/SKILL.md` - 设计稿分析（产出分析清单）
+- `.agents/skills/create-proposal/SKILL.md` - 提案前置分析与 OpenSpec 增强层（后置检查中确认包含验收任务）
+- `.agents/rules/09-样式规范.md` - 设计稿颜色提取

package/.agents/skills/domains/web/ui-verification/evals/evals.json

@@ -1,16 +1,16 @@
-{
-  "skill_name": "ui-verification",
-  "evals": [
-    {
-      "id": "ui-verification-output-1",
-      "prompt": "用户要求对照设计稿验收页面并输出问题清单和反思。",
-      "files": [],
-      "expected_output": "输出应明确使用浏览器工具、说明对比方式，并沉淀 UI 问题清单与再验证要求。",
-      "assertions": [
-        "强调以实际页面对比设计稿而不是只看代码",
-        "包含问题清单产物",
-        "包含修复后重新验证要求"
-      ]
-    }
-  ]
-}
+{
+  "skill_name": "ui-verification",
+  "evals": [
+    {
+      "id": "ui-verification-output-1",
+      "prompt": "用户要求对照设计稿验收页面并输出问题清单和反思。",
+      "files": [],
+      "expected_output": "输出应明确使用浏览器工具、说明对比方式，并沉淀 UI 问题清单与再验证要求。",
+      "assertions": [
+        "强调以实际页面对比设计稿而不是只看代码",
+        "包含问题清单产物",
+        "包含修复后重新验证要求"
+      ]
+    }
+  ]
+}

package/.agents/skills/domains/web/ui-verification/evals/train_queries.json

@@ -1,18 +1,18 @@
-[
-  {
-    "query": "按设计稿验收这个页面并产出 UI 问题清单",
-    "should_trigger": true
-  },
-  {
-    "query": "帮我检查页面和 figma 是否一致",
-    "should_trigger": true
-  },
-  {
-    "query": "根据设计稿先梳理开发任务",
-    "should_trigger": false
-  },
-  {
-    "query": "帮我新建页面路由",
-    "should_trigger": false
-  }
-]
+[
+  {
+    "query": "按设计稿验收这个页面并产出 UI 问题清单",
+    "should_trigger": true
+  },
+  {
+    "query": "帮我检查页面和 figma 是否一致",
+    "should_trigger": true
+  },
+  {
+    "query": "根据设计稿先梳理开发任务",
+    "should_trigger": false
+  },
+  {
+    "query": "帮我新建页面路由",
+    "should_trigger": false
+  }
+]

package/.agents/skills/domains/web/ui-verification/evals/validation_queries.json

@@ -1,18 +1,18 @@
-[
-  {
-    "query": "做一次 UI 还原验收，输出问题清单",
-    "should_trigger": true
-  },
-  {
-    "query": "用浏览器对照设计稿检查当前页面",
-    "should_trigger": true
-  },
-  {
-    "query": "我只有需求文字，没有设计稿",
-    "should_trigger": false
-  },
-  {
-    "query": "帮我写提案里的 design.md",
-    "should_trigger": false
-  }
-]
+[
+  {
+    "query": "做一次 UI 还原验收，输出问题清单",
+    "should_trigger": true
+  },
+  {
+    "query": "用浏览器对照设计稿检查当前页面",
+    "should_trigger": true
+  },
+  {
+    "query": "我只有需求文字，没有设计稿",
+    "should_trigger": false
+  },
+  {
+    "query": "帮我写提案里的 design.md",
+    "should_trigger": false
+  }
+]

package/.agents/skills/domains/web/ui-verification/rules/comparison-content-image.md

@@ -1,34 +1,34 @@
----
-title: 图片内容比对规则（P0）
-impact: CRITICAL
-impactDescription: 图片缺失/布局错均为 P0，验收时不得遗漏
-tags: comparison, content, image, p0, critical
----
-
-## 图片内容比对规则（P0）
-
-**P0 级要求**：图片缺失、布局错为 P0，验收时不得遗漏。
-
-**比对内容**：
-- **内容 - 图片**：所有图片/占位图区域是否存在、尺寸与布局（含多图拼接）是否正确。
-
-**验收顺序**（必须按以下顺序进行，避免漏检）：
-1. **从上到下**：从页面最上方区域逐块检查到最下方，顺序与布局一致。
-2. **从左到右**：同一行或同一层级内，按从左到右依次检查，不跳过。
-3. **从外到里**：每个区块内按「外层容器 → 内层容器 → 叶子元素」逐层检查。
-
-**图片检查要点**：
-- 检查所有图片/占位图区域是否存在
-- 检查图片尺寸是否正确
-- 检查图片位置是否正确
-- 检查多图拼接方式是否正确（1/2/3/4 图拼接）
-- 检查图片比例是否正确
-- 检查占位图尺寸与布局是否正确
-
-**验收时检查**：
-- [ ] 所有图片/占位图区域是否存在？
-- [ ] 图片尺寸是否正确？
-- [ ] 图片位置是否正确？
-- [ ] 多图拼接方式是否正确（1/2/3/4 图拼接）？
-- [ ] 图片比例是否正确？
-- [ ] 占位图尺寸与布局是否正确？
+---
+title: 图片内容比对规则（P0）
+impact: CRITICAL
+impactDescription: 图片缺失/布局错均为 P0，验收时不得遗漏
+tags: comparison, content, image, p0, critical
+---
+
+## 图片内容比对规则（P0）
+
+**P0 级要求**：图片缺失、布局错为 P0，验收时不得遗漏。
+
+**比对内容**：
+- **内容 - 图片**：所有图片/占位图区域是否存在、尺寸与布局（含多图拼接）是否正确。
+
+**验收顺序**（必须按以下顺序进行，避免漏检）：
+1. **从上到下**：从页面最上方区域逐块检查到最下方，顺序与布局一致。
+2. **从左到右**：同一行或同一层级内，按从左到右依次检查，不跳过。
+3. **从外到里**：每个区块内按「外层容器 → 内层容器 → 叶子元素」逐层检查。
+
+**图片检查要点**：
+- 检查所有图片/占位图区域是否存在
+- 检查图片尺寸是否正确
+- 检查图片位置是否正确
+- 检查多图拼接方式是否正确（1/2/3/4 图拼接）
+- 检查图片比例是否正确
+- 检查占位图尺寸与布局是否正确
+
+**验收时检查**：
+- [ ] 所有图片/占位图区域是否存在？
+- [ ] 图片尺寸是否正确？
+- [ ] 图片位置是否正确？
+- [ ] 多图拼接方式是否正确（1/2/3/4 图拼接）？
+- [ ] 图片比例是否正确？
+- [ ] 占位图尺寸与布局是否正确？