@guru-ai-product/ai-product-kit 0.2.251113215925 → 0.2.251117160442

package/skills/aipk_design/update-requirements-from-design/SKILL.md

@@ -1,13 +1,13 @@
 ---
 name: update-requirements-from-design
-description: Update requirement documents based on design mockups. Use this when your task involves receiving composite design boards, splitting them into panels, syncing visual assets to requirement docs, verifying differences between design mockups and existing documentation, and generating standardized change records. This skill handles the complete workflow from design assets to updated requirement documentation.
+description: Update requirement documents based on design mockups (composite boards or individual UI frames). Use this when you need to split composite boards or directly align single/multiple standalone UI images with requirement docs, including syncing visuals, verifying differences, and generating change records.
 ---
 
 # Update Requirements from Design Skill
 
-**适用场景**：收到合成设计图（多屏拼板）后，需要切分设计图、同步更新需求文档中的插图、修正文案，并输出需求变动记录。当你看到任务中提到"基于设计图更新需求文档"、"根据视觉稿修改需求"、"核对设计图并更新需求"或类似描述时，立即使用本 Skill。
+**适用场景**：收到合成设计图（多屏拼板）或单张/多张独立 UI 图后，需要将视觉稿同步更新到需求文档中的插图与文案，并输出需求变动记录。当你看到任务中提到"基于设计图更新需求文档"、"根据视觉稿修改需求"、"核对设计图并更新需求"或类似描述时，立即使用本 Skill。
 
-处理流程：先用 [`./scripts/split-design-boards.js`](./scripts/split-design-boards.js) 自动切分合成设计图，再用 [`./scripts/sync-design-to-requirements.js`](./scripts/sync-design-to-requirements.js) 生成资产映射、批量入库，并同步需求文档/变动说明。
+处理流程：如果是合成图，先通过 [`./scripts/split-design-boards.js`](./scripts/split-design-boards.js) 拆分每个面板，再用 [`./scripts/sync-design-to-requirements.js`](./scripts/sync-design-to-requirements.js) 管理映射与入库；如果是单张或多张独立 UI 图，则在确认落库命名后直接调整需求文档，重点对齐图片与文案一致性，并在变动说明中汇总差异。
 
 > **注意**：脚本直接运行在 Node 环境，依赖集中安装在 [`./scripts/sharp-runtime/`](./scripts/sharp-runtime/) 中。首次使用或更新版本时，在该目录执行 `npm install`，即可获取 `sharp` 等运行时依赖，无需额外打包。
 
@@ -25,36 +25,54 @@ description: Update requirement documents based on design mockups. Use this when
 
 ```mermaid
 graph TD
-    A[收到合成设计图] --> B[自动切分设计图]
-    B --> C[生成映射模板CSV]
-    C --> D[手动填充映射信息]
-    D --> E[批量入库到assets目录]
-    E --> F[更新需求文档并比对差异]
-    F --> G[生成需求变动说明文档]
-    G --> H[清理临时文件]
-    
+    A[收到设计稿（合成或独立）] --> B{设计稿形式}
+    B -->|合成拼板| C[运行 split-design-boards.js 切分面板]
+    C --> D[生成映射模板并填充 file_slug/panel_title]
+    D --> E[运行 sync-design-to-requirements.js 批量入库]
+    B -->|单张或多张独立 UI 图| F[确认每张图的目标文档与命名]
+    F --> G[直接插入图片到需求文档的合适位置]
+    G --> H[核对文案、控件、交互与设计一致性]
+    E --> H
+    H --> I[生成需求变动说明、核对表与 check 记录]
+    I --> J[清理 .tmp 或确认不需要]
+
     style A fill:#e1f5ff
     style B fill:#fff4e1
     style C fill:#fff4e1
     style D fill:#ffe1f5
     style E fill:#fff4e1
-    style F fill:#e1ffe1
-    style G fill:#ffe1f5
-    style H fill:#ffe1e1
+    style F fill:#fff4e1
+    style G fill:#e1ffe1
+    style H fill:#ffe1f5
+    style I fill:#ffe1e1
+    style J fill:#ffe1f5
 ```
 
 ### 2.2 详细步骤
 
-1. **自动切分设计图**：运行 [`scripts/split-design-boards.js`](./scripts/split-design-boards.js) 将合成图拆成临时 PNG（详见第3节）。
-2. **生成映射模板CSV**：执行 `node scripts/sync-design-to-requirements.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
-3. **手动填充映射信息**：在 CSV 中补齐 `panel_title`（截图上方蓝色标题原文）与 `file_slug`（希望落库的文件名，推荐 kebab-case），必要时填写 `version`、`notes`（详见第5节）。
-4. **批量入库到assets目录**：确认映射后，运行 `scripts/sync-design-to-requirements.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
-5. **更新需求文档并比对差异**：在需求文档中更新图片引用与文案，同时比对设计图与文档的一致性，记录不一致项（详见第7节）。
-6. **生成需求变动说明文档**：依照 [`需求变动说明模板`](../requirements/changes/template/需求变动说明文档模板.md) 在**需求文档版本文件夹下的 `changes/` 目录**中生成版本记录（详见第8节）。**重要**：变动说明文档必须保存在需求文档版本文件夹下的 `changes/` 目录中，例如 `../../sample/docs/requirement/v1.3.0/changes/YYYYMMDD_需求文档变动说明_*.md`。在删除 `.tmp` 目录前，必须将 `mapping.csv` 的内容以表格形式直接写入需求变动说明文档的附录中（推荐），或将其复制到需求文档版本文件夹下的 `changes/` 目录下（带时间戳命名，如 `YYYYMMDD_mapping.csv`）。同时附上脚本命令行和相关 issue/PR 链接。
-7. **清理临时文件**：完成所有步骤后，删除 `.tmp` 目录下的所有临时文件（包括切分的 PNG 和 `mapping.csv`），保持工作区整洁（详见第9节）。
+1. **自动切分设计图**（合成拼板）: 运行 [`scripts/split-design-boards.js`](./scripts/split-design-boards.js) 将合成图拆成临时 PNG（详见第3节）。
+2. **生成映射模板CSV**（合成拼板）: 执行 `node scripts/sync-design-to-requirements.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
+3. **手动填充映射信息**（合成拼板）: 在 CSV 中补齐 `panel_title`（截图上方蓝色标题原文）与 `file_slug`（希望落库的文件名，推荐 kebab-case），必要时填写 `version`、`notes`（详见第5节）。
+4. **批量入库到assets目录**（合成拼板）: 确认映射后，运行 `scripts/sync-design-to-requirements.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
+5. **更新需求文档并比对差异**：不论图是合成板还是独立 UI 图，都需要更新需求文档中的图片引用、文案与交互，并对照设计稿核对一致性（详见第7节）。
+6. **生成需求变动说明文档**：依照 [`需求变动说明模板`](../requirements/changes/template/需求变动说明文档模板.md) 在**需求文档版本文件夹下的 `changes/` 目录**中生成版本记录（详见第8节），并在附录保留 `mapping.csv` 内容或其等价记录（如直接粘贴表格或上传时间戳 CSV）。
+7. **清理临时文件或确认无需切分**：合成图需要删除 `.tmp` 中的切分文件（详见第9节），单张 UI 图仅需确认引用已更新并在变动说明/核对表中记录视觉稿来源即可。
 
 **⚠️ 重要提示**：步骤5中的"比对差异"是必要步骤，必须在步骤6（生成需求变动说明）之前完成，以确保变动说明文档中包含完整的差异核对信息。
 
+### 2.3 单张/多张独立 UI 图处理
+
+- **适用情况**：用户直接提供一张 UI 图或一组独立 UI 图（非拼板），此时无需运行拆分脚本，也不需要生成 `mapping.csv` 模板。
+- **步骤概览**：
+  1. **确认图片落点**：与产品方/设计确认每张 UI 图在需求文档中的对应章节、状态和预期命名，并将这些信息记录在临时表格（至少包含 `file_slug`、`version`、`panel_title`/描述与设计来源链接）。
+  2. **准备资产**：将图片复制到目标 `assets/` 目录（可手动复制或调试 `scripts/sync-design-to-requirements.js --doc-slug --iteration --dry-run`），确保文件名与后续文档引用一致，比如 `doc-slug-assets/xxx.png`。
+  3. **更新需求文档**：在对应章节插入 `![描述](./assets/文件名.png)`，修正文案、交互描述，并按照第7节的核对表逐一确认文案、按钮、字段状态与设计一致。
+  4. **记录差异与来源**：在变动说明的附录或手动表格中列出每张图片的命名、版本、设计链接（如 Figma 或 Sketch 链接），说明该图是新图还是覆盖旧图，便于审计。
+  5. **生成核对表**：仍需执行第7.2节要求，将文案/设计对齐核对表保存在需求文档版本的 `check/` 目录（如 `check/YYYYMMDD_文案设计对齐核对表.md`）。
+  6. **完成变动说明**：使用第8节的模版生成变动说明，附上每张独立 UI 图的简要处理说明，且在附录中包含该临时表格的内容。
+
+**注意**：即便没有拆分步骤，也必须保留差异说明、截图来源（上传时间/设计链接/版本号）、核对表，并确保需求变动说明文档说明本流程的差异与依据，便于审计与检索。
+
 ## 3. 自动切分设计图
 
 ### 3.1 输入与输出约定

package/skills/aipk_development/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-13T13:59:26.059Z
+Last refreshed: 2025-11-17T08:04:42.861Z
 
 | File | Last Modified (UTC) |
 | --- | --- |

package/skills/aipk_init_project/GURU_AI.md

@@ -1,10 +1,10 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-13T13:59:26.059Z
+Last refreshed: 2025-11-17T08:04:42.861Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `scripts/check_agents.sh` | 2025-11-13T09:03:47.702Z |
 | `skill.ini` | 2025-11-13T09:47:02.793Z |
 | `SKILL.md` | 2025-11-13T10:06:33.764Z |
-| `template/AGENTS_TEMPLATE.md` | 2025-11-13T13:59:26.014Z |
+| `template/AGENTS_TEMPLATE.md` | 2025-11-17T08:04:42.787Z |

package/skills/aipk_init_project/template/AGENTS_TEMPLATE.md

@@ -34,49 +34,7 @@ Usage notes:
 </usage>
 
 <available_skills>
-
-<skill>
-<name>design</name>
-<description>Central hub for automation-ready design-to-requirement workflows. When agents receive composite design boards and need to update requirement documents with new visuals, verify differences between mockups and existing docs, and sync changes systematically, they consult this index to discover the appropriate sub-skill (update-requirements-from-design) for handling design-driven requirement updates.</description>
-<location>.claude/skills/aipk_design</location>
-</skill>
-
-<skill>
-<name>development</name>
-<description>Development phase index pointing to the single authoritative implementation plan template.</description>
-<location>.claude/skills/aipk_development</location>
-</skill>
-
-<skill>
-<name>init-project</name>
-<description>Initialize the project Agents playbook, sync the skills inventory into AGENTS.md/templates, and verify the workspace includes a complete AGENTS.md file.</description>
-<location>.claude/skills/aipk_init_project</location>
-</skill>
-
-<skill>
-<name>operations</name>
-<description>Canonical entry point for every post-release operating guide; maps scenarios to the available Skills and explains how to invoke them.</description>
-<location>.claude/skills/aipk_operations</location>
-</skill>
-
-<skill>
-<name>requirements</name>
-<description>Central repository for requirement discovery, documentation, review, and change management assets.</description>
-<location>.claude/skills/aipk_requirements</location>
-</skill>
-
-<skill>
-<name>skill-creation</name>
-<description>Standards and methods for creating Agent Skills that extend Claude's capabilities. Use when creating or updating Skills, rules, or documentation that should follow Skill structure.</description>
-<location>.claude/skills/aipk_skill_generate</location>
-</skill>
-
-<skill>
-<name>tool_prompts</name>
-<description>Catalog of reusable prompts for AI tooling workflows, including their usage guidance and file locations.</description>
-<location>.claude/skills/aipk_tool_prompts</location>
-</skill>
-
+{{skills_section}}
 </available_skills>
 <!-- SKILLS_TABLE_END -->
 

package/skills/aipk_operations/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-13T13:59:26.059Z
+Last refreshed: 2025-11-17T08:04:42.861Z
 
 | File | Last Modified (UTC) |
 | --- | --- |

package/skills/aipk_requirements/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-13T13:59:26.059Z
+Last refreshed: 2025-11-17T08:04:42.861Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
@@ -10,16 +10,18 @@ Last refreshed: 2025-11-13T13:59:26.059Z
 | `changes/template/需求变动说明生成Prompt.md` | 2025-11-12T10:41:15.859Z |
 | `changes/template/需求变动说明生成指南.md` | 2025-11-12T10:41:15.859Z |
 | `documentation/SKILL.md` | 2025-11-13T12:30:17.269Z |
-| `documentation/template/1_产品定位与分析.md` | 2025-11-12T10:41:15.860Z |
-| `documentation/template/2_功能需求.md` | 2025-11-12T10:41:15.860Z |
-| `documentation/template/3_商业化策略.md` | 2025-11-12T10:41:15.860Z |
-| `documentation/template/4_用户界面与体验.md` | 2025-11-12T10:41:15.860Z |
+| `documentation/template/1_产品定位与分析.md` | 2025-11-17T06:49:33.762Z |
+| `documentation/template/2_功能需求.md` | 2025-11-17T06:49:38.006Z |
+| `documentation/template/3_商业化策略.md` | 2025-11-17T06:43:53.421Z |
+| `documentation/template/4.1_用户体验流程与信息架构.md` | 2025-11-17T06:49:16.631Z |
+| `documentation/template/4.2_关键界面.md` | 2025-11-17T07:16:19.040Z |
+| `documentation/template/4.3_交互与响应式设计.md` | 2025-11-17T06:43:51.131Z |
 | `documentation/template/AI 应用类APP通用埋点文档.xlsx` | 2025-11-12T10:41:15.861Z |
 | `documentation/template/Draft_产品需求草稿.md` | 2025-11-12T10:41:15.862Z |
 | `documentation/template/Draft_用户旅程草稿.md` | 2025-11-12T10:41:15.862Z |
-| `documentation/template/index.md` | 2025-11-12T10:41:15.862Z |
+| `documentation/template/index.md` | 2025-11-17T06:43:52.439Z |
 | `documentation/template/埋点规范文档.md` | 2025-11-12T10:41:15.862Z |
-| `documentation/template/需求迭代模板.md` | 2025-11-12T10:41:15.863Z |
+| `documentation/template/需求迭代模板.md` | 2025-11-17T06:43:45.748Z |
 | `documentation/template/需求迭代索引.md` | 2025-11-12T10:41:15.863Z |
 | `initiative_planning/SKILL.md` | 2025-11-12T10:41:15.863Z |
 | `initiative_planning/template/SWOT分析模板.md` | 2025-11-12T10:41:15.864Z |

package/skills/aipk_requirements/documentation/template/1_/344/272/247/345/223/201/345/256/232/344/275/215/344/270/216/345/210/206/346/236/220.md

@@ -6,17 +6,19 @@
 
 ---
 
-## 1. 产品概述
+## 1. 产品定位与分析
 
-### 1.1 产品背景
+### 1.1 产品概述
+
+#### 1.1.1 产品背景
 
 [描述产品的背景情况，包括市场需求、业务机会、竞争环境等]
 
-### 1.2 产品定位
+#### 1.1.2 产品定位
 
 [描述产品的市场定位、目标用户群体和核心价值主张]
 
-### 1.3 产品目标
+#### 1.1.3 产品目标
 
 [列出产品的主要目标，可以包括业务目标、用户目标和技术目标]
 
@@ -24,7 +26,7 @@
 - 目标2：[具体描述]
 - 目标3：[具体描述]
 
-### 1.4 成功指标
+#### 1.1.4 成功指标
 
 [定义产品成功的关键指标，应该是具体、可衡量的]
 
@@ -35,17 +37,17 @@
 | 业务收入 | [指标] | [目标] | [方法] |
 | 其他 | [指标] | [目标] | [方法] |
 
-## 2. 用户分析
+### 1.2 用户分析
 
-### 2.1 目标用户群体
+#### 1.2.1 目标用户群体
 
 [描述产品的主要用户群体，可以包括人口统计学特征、行为特征、需求特征等]
 
-### 2.2 用户角色
+#### 1.2.2 用户角色
 
 [定义产品中的主要用户角色]
 
-#### 角色1：[角色名称]
+##### 角色1：[角色名称]
 
 - **描述**：[角色的简要描述]
 - **特征**：[该角色的主要特征]
@@ -53,34 +55,34 @@
 - **痛点**：[该角色当前面临的主要问题]
 - **使用场景**：[该角色使用产品的典型场景]
 
-#### 角色2：[角色名称]
+##### 角色2：[角色名称]
 
 [同上结构]
 
-### 2.3 用户旅程
+#### 1.2.3 用户旅程
 
 [描述用户使用产品的典型流程和体验]
 
-## 3. 市场分析
+### 1.3 市场分析
 
-### 3.1 市场概况
+#### 1.3.1 市场概况
 
 [描述目标市场的规模、增长趋势、主要特点等]
 
-### 3.2 竞品分析
+#### 1.3.2 竞品分析
 
 [分析主要竞争对手的产品，包括优势、劣势和差异化点]
 
-#### 竞品1：[竞品名称]
+##### 竞品1：[竞品名称]
 
 - **优势**：[列出主要优势]
 - **劣势**：[列出主要劣势]
 - **差异化**：[与我们产品的主要区别]
 
-#### 竞品2：[竞品名称]
+##### 竞品2：[竞品名称]
 
 [同上结构]
 
-### 3.3 市场机会
+#### 1.3.3 市场机会
 
 [基于市场分析，指出产品可以抓住的主要市场机会]

package/skills/aipk_requirements/documentation/template/2_/345/212/237/350/203/275/351/234/200/346/261/202.md

@@ -6,13 +6,13 @@
 
 ---
 
-## 4. 功能需求
+## 2. 功能需求
 
-### 4.1 功能概述
+### 2.1 功能概述
 
 [概述产品的主要功能模块和结构]
 
-### 4.2 核心功能
+### 2.2 核心功能
 
 [详细描述产品的核心功能]
 
@@ -30,38 +30,38 @@
 
 [同上结构]
 
-### 4.3 次要功能
+### 2.3 次要功能
 
 [描述产品的次要或辅助功能，结构同上]
 
-### 4.4 未来功能
+### 2.4 未来功能
 
 [描述计划在未来版本中实现的功能，结构同上]
 
-## 5. 非功能需求
+### 2.5 非功能需求
 
-### 5.1 性能需求
+#### 2.5.1 性能需求
 
 [仅在明确或必须时填写]
 
-### 5.2 安全需求
+#### 2.5.2 安全需求
 
 [仅在明确或必须时填写]
 
-### 5.3 可用性需求
+#### 2.5.3 可用性需求
 
 [仅在明确或必须时填写]
 
-### 5.4 多语言支持
+#### 2.5.4 多语言支持
 
 **默认支持**：支持多语言国际化
 
 **特殊情况**：[仅在需要限制支持语言时填写具体语言列表]
 
-### 5.5 兼容性需求
+#### 2.5.5 兼容性需求
 
 [仅在明确或必须时填写]
 
-### 5.6 其他非功能需求
+#### 2.5.6 其他非功能需求
 
 [仅在明确或必须时填写]

package/skills/aipk_requirements/documentation/template/3_/345/225/206/344/270/232/345/214/226/347/255/226/347/225/245.md

@@ -2,7 +2,7 @@
 
 ## 文档导航
 
-← **[上一部分：功能需求](./2_功能需求.md)** | **[下一部分：用户界面与体验](./4_用户界面与体验.md)** → | 📋 **[返回索引](./index.md)**
+← **[上一部分：功能需求](./2_功能需求.md)** | **[下一部分：用户体验流程与信息架构](./4.1_用户体验流程与信息架构.md)** → | 📋 **[返回索引](./index.md)**
 
 ---