@guru-ai-product/ai-product-kit 0.2.251113205658 → 0.2.251113212000

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 (14) hide show
  1. package/package.json +1 -1
  2. package/skills/aipk_design/GURU_AI.md +5 -7
  3. package/skills/aipk_design/SKILL.md +1 -1
  4. package/skills/aipk_design/update-requirements-from-design/SKILL.md +13 -13
  5. package/skills/aipk_design/update-requirements-from-design/scripts/{auto_panel_splitter.js → split-design-boards.js} +10 -0
  6. package/skills/aipk_design/update-requirements-from-design/scripts/{panel_asset_mapper.js → sync-design-to-requirements.js} +10 -0
  7. package/skills/aipk_development/GURU_AI.md +1 -1
  8. package/skills/aipk_init_project/GURU_AI.md +2 -2
  9. package/skills/aipk_operations/GURU_AI.md +1 -1
  10. package/skills/aipk_requirements/GURU_AI.md +1 -1
  11. package/skills/aipk_skill_generate/GURU_AI.md +1 -1
  12. package/skills/aipk_tool_prompts/GURU_AI.md +1 -1
  13. package/skills/aipk_design/update-requirements-from-design/scripts/split-design-boards-bundle.js +0 -10476
  14. package/skills/aipk_design/update-requirements-from-design/scripts/sync-design-to-requirements-bundle.js +0 -10530
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guru-ai-product/ai-product-kit",
3
- "version": "0.2.251113205658",
3
+ "version": "0.2.251113212000",
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,12 +1,10 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
- | `SKILL.md` | 2025-11-13T12:10:39.018Z |
8
- | `update-requirements-from-design/scripts/auto_panel_splitter.js` | 2025-11-12T10:41:15.854Z |
9
- | `update-requirements-from-design/scripts/panel_asset_mapper.js` | 2025-11-12T10:41:15.855Z |
7
+ | `SKILL.md` | 2025-11-13T13:11:54.681Z |
10
8
  | `update-requirements-from-design/scripts/sharp-runtime/node_modules/.bin/semver` | 2025-11-13T12:53:04.813Z |
11
9
  | `update-requirements-from-design/scripts/sharp-runtime/node_modules/.package-lock.json` | 2025-11-13T12:53:10.727Z |
12
10
  | `update-requirements-from-design/scripts/sharp-runtime/node_modules/@img/colour/color.cjs` | 2025-11-13T12:53:05.063Z |
@@ -119,6 +117,6 @@ Last refreshed: 2025-11-13T12:56:59.149Z
119
117
  | `update-requirements-from-design/scripts/sharp-runtime/node_modules/sharp/src/utilities.h` | 2025-11-13T12:53:05.420Z |
120
118
  | `update-requirements-from-design/scripts/sharp-runtime/package-lock.json` | 2025-11-13T12:53:10.725Z |
121
119
  | `update-requirements-from-design/scripts/sharp-runtime/package.json` | 2025-11-13T12:53:10.715Z |
122
- | `update-requirements-from-design/scripts/split-design-boards-bundle.js` | 2025-11-13T12:54:06.060Z |
123
- | `update-requirements-from-design/scripts/sync-design-to-requirements-bundle.js` | 2025-11-13T12:54:08.708Z |
124
- | `update-requirements-from-design/SKILL.md` | 2025-11-13T12:31:35.709Z |
120
+ | `update-requirements-from-design/scripts/split-design-boards.js` | 2025-11-13T13:11:29.610Z |
121
+ | `update-requirements-from-design/scripts/sync-design-to-requirements.js` | 2025-11-13T13:11:32.947Z |
122
+ | `update-requirements-from-design/SKILL.md` | 2025-11-13T13:13:10.700Z |
package/skills/aipk_design/SKILL.md CHANGED
@@ -15,7 +15,7 @@ description: Central hub for automation-ready design-to-requirement workflows. W
15
15
 
16
16
  - **Update Requirements from Design**（`./update-requirements-from-design/`）
17
17
  - 基于设计图更新需求文档的完整工作流：切分合成设计板、准备视觉资产、同步需求文档、比对验证设计与需求的差异，并生成标准的需求变动记录。
18
- - 包含 `split-design-boards-bundle.js`（自动切分合成图）与 `sync-design-to-requirements-bundle.js`（资产映射与批量入库）等自动化工具。
18
+ - 包含 `split-design-boards.js`（自动切分合成图）与 `sync-design-to-requirements.js`（资产映射与批量入库）等自动化工具。
19
19
  - **适用场景**：任务中提到"基于设计图更新需求"、"收到合成设计稿"、"根据视觉稿修改需求"时立即使用。
20
20
 
21
21
  如需扩展新的设计场景，请在 `skills/aipk_design/` 下创建子目录，按照模板完成 `SKILL.md`、`references/` 等结构，并在本文件的"当前可用的设计 Skill"中登记用途与入口路径。
package/skills/aipk_design/update-requirements-from-design/SKILL.md CHANGED
@@ -7,9 +7,9 @@ description: Update requirement documents based on design mockups. Use this when
7
7
 
8
8
  **适用场景**：收到合成设计图（多屏拼板）后，需要切分设计图、同步更新需求文档中的插图、修正文案，并输出需求变动记录。当你看到任务中提到"基于设计图更新需求文档"、"根据视觉稿修改需求"、"核对设计图并更新需求"或类似描述时，立即使用本 Skill。
9
9
 
10
- 处理流程：先用 [`./scripts/split-design-boards-bundle.js`](./scripts/split-design-boards-bundle.js) 自动切分合成设计图，再用 [`./scripts/sync-design-to-requirements-bundle.js`](./scripts/sync-design-to-requirements-bundle.js) 生成资产映射、批量入库，并同步需求文档/变动说明。
10
+ 处理流程：先用 [`./scripts/split-design-boards.js`](./scripts/split-design-boards.js) 自动切分合成设计图，再用 [`./scripts/sync-design-to-requirements.js`](./scripts/sync-design-to-requirements.js) 生成资产映射、批量入库，并同步需求文档/变动说明。
11
11
 
12
- > **注意**：项目已提供打包好的独立脚本，内置所有依赖（包括 sharp），无需额外安装。源代码位于 `scripts/` 目录，如需修改请重新打包。
12
+ > **注意**：脚本直接运行在 Node 环境，依赖集中安装在 [`./scripts/sharp-runtime/`](./scripts/sharp-runtime/) 中。首次使用或更新版本时，在该目录执行 `npm install`，即可获取 `sharp` 等运行时依赖，无需额外打包。
13
13
 
14
14
  <!-- rule: Agents must complete the entire pipeline end-to-end without依赖人工手动操作或 GUI 工具。 -->
15
15
 
@@ -45,10 +45,10 @@ graph TD
45
45
 
46
46
  ### 2.2 详细步骤
47
47
 
48
- 1. **自动切分设计图**：运行 [`scripts/split-design-boards-bundle.js`](./scripts/split-design-boards-bundle.js) 将合成图拆成临时 PNG（详见第3节）。
49
- 2. **生成映射模板CSV**：执行 `node scripts/sync-design-to-requirements-bundle.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
48
+ 1. **自动切分设计图**：运行 [`scripts/split-design-boards.js`](./scripts/split-design-boards.js) 将合成图拆成临时 PNG（详见第3节）。
49
+ 2. **生成映射模板CSV**：执行 `node scripts/sync-design-to-requirements.js --source <tmp> --mapping <tmp>/mapping.csv --init-mapping`，脚本会扫描全部 PNG 并生成映射模板（详见第4节）。
50
50
  3. **手动填充映射信息**：在 CSV 中补齐 `panel_title`（截图上方蓝色标题原文）与 `file_slug`（希望落库的文件名，推荐 kebab-case），必要时填写 `version`、`notes`（详见第5节）。
51
- 4. **批量入库到assets目录**：确认映射后，运行 `scripts/sync-design-to-requirements-bundle.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
51
+ 4. **批量入库到assets目录**：确认映射后，运行 `scripts/sync-design-to-requirements.js`（可指定 `--destination` 或 `--doc-slug/--iteration`）完成重命名与复制（详见第6节）。
52
52
  5. **更新需求文档并比对差异**：在需求文档中更新图片引用与文案，同时比对设计图与文档的一致性，记录不一致项（详见第7节）。
53
53
  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 链接。
54
54
  7. **清理临时文件**：完成所有步骤后，删除 `.tmp` 目录下的所有临时文件（包括切分的 PNG 和 `mapping.csv`），保持工作区整洁（详见第9节）。
@@ -66,7 +66,7 @@ graph TD
66
66
  ### 3.2 运行脚本
67
67
 
68
68
  ```bash
69
- node scripts/split-design-boards-bundle.js \
69
+ node scripts/split-design-boards.js \
70
70
  --input ../design/assets/source/20241115_checkout.png \
71
71
  --output .tmp/checkout-panels \
72
72
  --prefix checkout \
@@ -96,7 +96,7 @@ node scripts/split-design-boards-bundle.js \
96
96
  ### 4.2 运行脚本
97
97
 
98
98
  ```bash
99
- node scripts/sync-design-to-requirements-bundle.js \
99
+ node scripts/sync-design-to-requirements.js \
100
100
  --source .tmp/checkout-panels \
101
101
  --mapping .tmp/checkout-panels/mapping.csv \
102
102
  --init-mapping
@@ -199,7 +199,7 @@ ai-calorie_10.png,11-第一阶段完成,,11-第一阶段完成,
199
199
  **资产入库命令**：
200
200
 
201
201
  ```bash
202
- node scripts/sync-design-to-requirements-bundle.js \
202
+ node scripts/sync-design-to-requirements.js \
203
203
  --source .tmp/checkout-panels \
204
204
  --mapping .tmp/checkout-panels/mapping.csv \
205
205
  --destination ../../sample/docs/requirement/v1.3.0/assets \
@@ -331,9 +331,9 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
331
331
  - 比对差异核对表的发现（如有不一致项，见第7.2节）
332
332
  5. **包含映射信息**：在"附录"章节中必须包含 `mapping.csv` 的内容（见第6.5节）。**注意**：由于 `.tmp` 目录会在第9节被删除，因此必须将 `mapping.csv` 的内容以表格形式直接写入文档中（推荐），或先将其复制到**需求文档版本文件夹下的 `changes/`** 目录下再在文档中引用。
333
333
  6. **记录命令**：在"附录"章节中附上完整的脚本命令行，包括：
334
- - 切分命令（`scripts/split-design-boards-bundle.js`，见第3节）
335
- - 生成映射命令（`scripts/sync-design-to-requirements-bundle.js --init-mapping`，见第4节）
336
- - 入库命令（`scripts/sync-design-to-requirements-bundle.js`，见第6节）
334
+ - 切分命令（`scripts/split-design-boards.js`，见第3节）
335
+ - 生成映射命令（`scripts/sync-design-to-requirements.js --init-mapping`，见第4节）
336
+ - 入库命令（`scripts/sync-design-to-requirements.js`，见第6节）
337
337
  - 相关 issue/PR 链接（如有）
338
338
  7. **包含核对表**：将第7.2节生成的文案/设计对齐核对表包含在文档的"文档级变动详情"或"附录"章节中。
339
339
  8. **生成文案/设计对齐核对表**：将第7.2节生成的文案/设计对齐核对表保存为 Markdown 文件到**需求文档版本文件夹下的 `check/`** 目录（如 `../../sample/docs/requirement/v1.3.0/check/YYYYMMDD_文案设计对齐核对表.md`）。**重要**：check 目录应保存的是文案/设计对齐核对表（记录设计图与需求文档的一致性比对），而非图片 diff 比对表（图片文件的哈希值比对）。核对表使用 Markdown 格式，包含表格和必要的说明文字。
@@ -358,7 +358,7 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
358
358
 
359
359
  ## 10. 附加资源
360
360
 
361
- - [切分设计板脚本](./scripts/split-design-boards-bundle.js) — 面板检测与裁切逻辑（独立打包版，内含所有依赖）
362
- - [同步设计到需求脚本](./scripts/sync-design-to-requirements-bundle.js) — 资产映射管理与批量入库（独立打包版，内含所有依赖）
361
+ - [切分设计板脚本](./scripts/split-design-boards.js) — 面板检测与裁切逻辑（依赖 `./scripts/sharp-runtime/` 中的 `sharp`）
362
+ - [同步设计到需求脚本](./scripts/sync-design-to-requirements.js) — 资产映射管理与批量入库（依赖 `./scripts/sharp-runtime/` 中的 `sharp`）
363
363
  - [需求文档 Skill](../requirements/documentation/SKILL.md) — 需求文档结构与质检
364
364
  - [需求变动 Skill](../requirements/changes/SKILL.md) — 需求变动说明模板与执行清单
package/skills/aipk_design/update-requirements-from-design/scripts/{auto_panel_splitter.js → split-design-boards.js} RENAMED
@@ -4,6 +4,16 @@
4
4
  const fs = require("node:fs/promises");
5
5
  const path = require("node:path");
6
6
  const { parseArgs } = require("node:util");
7
+ const Module = require("node:module");
8
+
9
+ const sharpRuntimeModules = path.join(__dirname, "sharp-runtime", "node_modules");
10
+ if (!Module.globalPaths.includes(sharpRuntimeModules)) {
11
+ Module.globalPaths.unshift(sharpRuntimeModules);
12
+ }
13
+ if (!module.paths.includes(sharpRuntimeModules)) {
14
+ module.paths.unshift(sharpRuntimeModules);
15
+ }
16
+
7
17
  const sharp = require("sharp");
8
18
 
9
19
  class Box {
package/skills/aipk_design/update-requirements-from-design/scripts/{panel_asset_mapper.js → sync-design-to-requirements.js} RENAMED
@@ -6,6 +6,16 @@ const fsp = require("node:fs/promises");
6
6
  const path = require("node:path");
7
7
  const crypto = require("node:crypto");
8
8
  const { parseArgs } = require("node:util");
9
+ const Module = require("node:module");
10
+
11
+ const sharpRuntimeModules = path.join(__dirname, "sharp-runtime", "node_modules");
12
+ if (!Module.globalPaths.includes(sharpRuntimeModules)) {
13
+ Module.globalPaths.unshift(sharpRuntimeModules);
14
+ }
15
+ if (!module.paths.includes(sharpRuntimeModules)) {
16
+ module.paths.unshift(sharpRuntimeModules);
17
+ }
18
+
9
19
  const sharp = require("sharp");
10
20
 
11
21
  const IMAGE_EXTS = new Set([".png", ".jpg", ".jpeg", ".webp"]);
package/skills/aipk_development/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_init_project/GURU_AI.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
7
  | `scripts/check_agents.sh` | 2025-11-13T09:03:47.702Z |
8
8
  | `skill.ini` | 2025-11-13T09:47:02.793Z |
9
9
  | `SKILL.md` | 2025-11-13T10:06:33.764Z |
10
- | `template/AGENTS_TEMPLATE.md` | 2025-11-13T12:56:59.105Z |
10
+ | `template/AGENTS_TEMPLATE.md` | 2025-11-13T13:20:00.630Z |
package/skills/aipk_operations/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_requirements/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_skill_generate/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_tool_prompts/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-11-13T12:56:59.149Z
3
+ Last refreshed: 2025-11-13T13:20:00.683Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |