@guru-ai-product/ai-product-kit 0.2.251113190105 → 0.2.251113193628

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/mcp/skills/aipk_init_project/template/AGENTS_TEMPLATE.md +1 -1
  2. package/mcp/src/server.js +1 -1
  3. package/package.json +1 -1
  4. package/skills/aipk_design/GURU_AI.md +5 -3
  5. package/skills/aipk_design/SKILL.md +1 -1
  6. package/skills/aipk_design/auto_panel_splitter/SKILL.md +14 -12
  7. package/skills/aipk_design/auto_panel_splitter/scripts/auto_panel_splitter_bundle.js +10467 -0
  8. package/skills/aipk_design/auto_panel_splitter/scripts/panel_asset_mapper_bundle.js +10521 -0
  9. package/skills/aipk_development/GURU_AI.md +1 -1
  10. package/skills/aipk_init_project/GURU_AI.md +2 -2
  11. package/skills/aipk_init_project/template/AGENTS_TEMPLATE.md +1 -1
  12. package/skills/aipk_operations/GURU_AI.md +1 -1
  13. package/skills/aipk_requirements/GURU_AI.md +1 -1
  14. package/skills/aipk_skill_generate/GURU_AI.md +1 -1
  15. package/skills/aipk_tool_prompts/GURU_AI.md +1 -1
package/mcp/skills/aipk_init_project/template/AGENTS_TEMPLATE.md CHANGED
@@ -19,7 +19,7 @@ Use these MCP tools to load a Skill by name. The server maps known Skill names t
19
19
 
20
20
  <skill>
21
21
  <name>design</name>
22
- <description>Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, and discover the right sub-skill before handling new mocks.</description>
22
+ <description>Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, compare and verify differences between design mockups and requirements, and discover the right sub-skill before handling new mocks.</description>
23
23
  <tool>product_kit_skill</tool>
24
24
  <arguments>{"skill_name": "aipk_design"}</arguments>
25
25
  </skill>
package/mcp/src/server.js CHANGED
@@ -29,7 +29,7 @@ const PRODUCT_KIT_SKILLS = {
29
29
 
30
30
  // Skill 描述映射
31
31
  const SKILL_DESCRIPTIONS = {
32
- "aipk_design": "Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, and discover the right sub-skill before handling new mocks.",
32
+ "aipk_design": "Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, compare and verify differences between design mockups and requirements, and discover the right sub-skill before handling new mocks.",
33
33
  "aipk_development": "Development phase index pointing to the single authoritative implementation plan template.",
34
34
  "aipk_operations": "Canonical entry point for every post-release operating guide; maps scenarios to the available Skills and explains how to invoke them.",
35
35
  "aipk_requirements": "Central repository for requirement discovery, documentation, review, and change management assets.",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guru-ai-product/ai-product-kit",
3
- "version": "0.2.251113190105",
3
+ "version": "0.2.251113193628",
4
4
  "description": "Sync the AI Product Kit Skill bundle through npx without cloning the repository.",
5
5
  "bin": {
6
6
  "ai-product-kit": "bin/setup.js",
package/skills/aipk_design/GURU_AI.md CHANGED
@@ -1,10 +1,12 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T11:01:06.000Z
3
+ Last refreshed: 2025-11-13T11:36:28.857Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
+ | `auto_panel_splitter/scripts/auto_panel_splitter_bundle.js` | 2025-11-13T11:33:40.478Z |
7
8
  | `auto_panel_splitter/scripts/auto_panel_splitter.js` | 2025-11-12T10:41:15.854Z |
9
+ | `auto_panel_splitter/scripts/panel_asset_mapper_bundle.js` | 2025-11-13T11:33:49.334Z |
8
10
  | `auto_panel_splitter/scripts/panel_asset_mapper.js` | 2025-11-12T10:41:15.855Z |
9
- | `auto_panel_splitter/SKILL.md` | 2025-11-12T10:41:15.854Z |
10
- | `SKILL.md` | 2025-11-12T10:41:15.853Z |
11
+ | `auto_panel_splitter/SKILL.md` | 2025-11-13T11:34:28.517Z |
12
+ | `SKILL.md` | 2025-11-13T11:01:24.584Z |
package/skills/aipk_design/SKILL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: design
3
- description: Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, and discover the right sub-skill before handling new mocks.
3
+ description: Central hub for automation-ready design workflows, describing how agents split composite boards, prep visual assets, sync requirement docs, compare and verify differences between design mockups and requirements, and discover the right sub-skill before handling new mocks.
4
4
  ---
5
5
 
6
6
  # 设计阶段 Skill
package/skills/aipk_design/auto_panel_splitter/SKILL.md CHANGED
@@ -5,7 +5,9 @@ description: Split composite design boards, align requirement docs with new visu
5
5
 
6
6
  # Auto Panel Splitter Skill
7
7
 
8
- 处理最新视觉稿时使用本 Skill：先用 [`./scripts/auto_panel_splitter.js`](./scripts/auto_panel_splitter.js) 自动切分设计图，再用 [`./scripts/panel_asset_mapper.js`](./scripts/panel_asset_mapper.js) 生成映射、批量入库，并同步需求文档/变动说明。
8
+ 处理最新视觉稿时使用本 Skill：先用 [`./scripts/auto_panel_splitter_bundle.js`](./scripts/auto_panel_splitter_bundle.js) 自动切分设计图，再用 [`./scripts/panel_asset_mapper_bundle.js`](./scripts/panel_asset_mapper_bundle.js) 生成映射、批量入库，并同步需求文档/变动说明。
9
+
10
+ > **注意**：项目已提供打包好的独立脚本，内置所有依赖（包括 sharp），无需额外安装。使用 `bundled/` 目录下的版本即可。源代码位于 `scripts/` 目录，如需修改请重新打包。
9
11
 
10
12
  <!-- rule: Agents must complete the entire pipeline end-to-end without依赖人工手动操作或 GUI 工具。 -->
11
13
 
@@ -41,10 +43,10 @@ graph TD
41
43
 
42
44
  ### 2.2 详细步骤
43
45
 
44
- 1. **自动切分设计图**：运行 [`scripts/auto_panel_splitter.js`](./scripts/auto_panel_splitter.js) 将合成图拆成临时 PNG（详见第3节）。
45
- 2. **生成映射模板CSV**：执行 `node scripts/panel_asset_mapper.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
46
+ 1. **自动切分设计图**：运行 [`scripts/auto_panel_splitter_bundle.js`](./scripts/auto_panel_splitter_bundle.js) 将合成图拆成临时 PNG（详见第3节）。
47
+ 2. **生成映射模板CSV**：执行 `node scripts/panel_asset_mapper_bundle.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
46
48
  3. **手动填充映射信息**：在 CSV 中补齐 `panel_title`（截图上方蓝色标题原文）与 `file_slug`（希望落库的文件名，推荐 kebab-case），必要时填写 `version`、`notes`（详见第5节）。
47
- 4. **批量入库到assets目录**：确认映射后，运行 `scripts/panel_asset_mapper.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
49
+ 4. **批量入库到assets目录**：确认映射后，运行 `scripts/panel_asset_mapper_bundle.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
48
50
  5. **更新需求文档并比对差异**：在需求文档中更新图片引用与文案，同时比对设计图与文档的一致性，记录不一致项（详见第7节）。
49
51
  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 链接。
50
52
  7. **清理临时文件**：完成所有步骤后，删除 `.tmp` 目录下的所有临时文件（包括切分的 PNG 和 `mapping.csv`），保持工作区整洁（详见第9节）。
@@ -62,7 +64,7 @@ graph TD
62
64
  ### 3.2 运行脚本
63
65
 
64
66
  ```bash
65
- node scripts/auto_panel_splitter.js \
67
+ node scripts/auto_panel_splitter_bundle.js \
66
68
  --input ../design/assets/source/20241115_checkout.png \
67
69
  --output .tmp/checkout-panels \
68
70
  --prefix checkout \
@@ -92,7 +94,7 @@ node scripts/auto_panel_splitter.js \
92
94
  ### 4.2 运行脚本
93
95
 
94
96
  ```bash
95
- node scripts/panel_asset_mapper.js \
97
+ node scripts/panel_asset_mapper_bundle.js \
96
98
  --source .tmp/checkout-panels \
97
99
  --mapping .tmp/checkout-panels/mapping.csv \
98
100
  --init-mapping
@@ -195,7 +197,7 @@ ai-calorie_10.png,11-第一阶段完成,,11-第一阶段完成,
195
197
  **资产入库命令**：
196
198
 
197
199
  ```bash
198
- node scripts/panel_asset_mapper.js \
200
+ node scripts/panel_asset_mapper_bundle.js \
199
201
  --source .tmp/checkout-panels \
200
202
  --mapping .tmp/checkout-panels/mapping.csv \
201
203
  --destination ../../sample/docs/requirement/v1.3.0/assets \
@@ -327,9 +329,9 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
327
329
  - 比对差异核对表的发现（如有不一致项，见第7.2节）
328
330
  5. **包含映射信息**：在"附录"章节中必须包含 `mapping.csv` 的内容（见第6.5节）。**注意**：由于 `.tmp` 目录会在第9节被删除，因此必须将 `mapping.csv` 的内容以表格形式直接写入文档中（推荐），或先将其复制到**需求文档版本文件夹下的 `changes/`** 目录下再在文档中引用。
329
331
  6. **记录命令**：在"附录"章节中附上完整的脚本命令行，包括：
330
- - 切分命令（`scripts/auto_panel_splitter.js`，见第3节）
331
- - 生成映射命令（`scripts/panel_asset_mapper.js --init-mapping`，见第4节）
332
- - 入库命令（`scripts/panel_asset_mapper.js`，见第6节）
332
+ - 切分命令（`scripts/auto_panel_splitter_bundle.js`，见第3节）
333
+ - 生成映射命令（`scripts/panel_asset_mapper_bundle.js --init-mapping`，见第4节）
334
+ - 入库命令（`scripts/panel_asset_mapper_bundle.js`，见第6节）
333
335
  - 相关 issue/PR 链接（如有）
334
336
  7. **包含核对表**：将第7.2节生成的文案/设计对齐核对表包含在文档的"文档级变动详情"或"附录"章节中。
335
337
  8. **生成文案/设计对齐核对表**：将第7.2节生成的文案/设计对齐核对表保存为 Markdown 文件到**需求文档版本文件夹下的 `check/`** 目录（如 `../../sample/docs/requirement/v1.3.0/check/YYYYMMDD_文案设计对齐核对表.md`）。**重要**：check 目录应保存的是文案/设计对齐核对表（记录设计图与需求文档的一致性比对），而非图片 diff 比对表（图片文件的哈希值比对）。核对表使用 Markdown 格式，包含表格和必要的说明文字。
@@ -354,7 +356,7 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
354
356
 
355
357
  ## 10. 附加资源
356
358
 
357
- - [自动切分脚本](./scripts/auto_panel_splitter.js) — 面板检测与裁切逻辑
358
- - [资产映射脚本](./scripts/panel_asset_mapper.js) — 映射管理与批量入库
359
+ - [自动切分脚本](./scripts/auto_panel_splitter_bundle.js) — 面板检测与裁切逻辑（独立打包版，内含所有依赖）
360
+ - [资产映射脚本](./scripts/panel_asset_mapper_bundle.js) — 映射管理与批量入库（独立打包版，内含所有依赖）
359
361
  - [需求文档 Skill](../requirements/documentation/SKILL.md) — 需求文档结构与质检
360
362
  - [需求变动 Skill](../requirements/changes/SKILL.md) — 需求变动说明模板与执行清单