@guru-ai-product/ai-product-kit 0.2.251218163225 → 0.2.251226142524

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 (23) hide show
  1. package/README.md +28 -2
  2. package/mcp/src/server.js +2 -4
  3. package/package.json +1 -1
  4. package/skills/aipk_aso-new-release/GURU_AI.md +1 -1
  5. package/skills/aipk_development/GURU_AI.md +1 -1
  6. package/skills/aipk_format-requirement-pages-with-design/GURU_AI.md +2 -2
  7. package/skills/aipk_format-requirement-pages-with-design/SKILL.md +0 -1
  8. package/skills/aipk_init_project/GURU_AI.md +2 -2
  9. package/skills/aipk_initiative-planning/GURU_AI.md +2 -2
  10. package/skills/aipk_initiative-planning/SKILL.md +0 -4
  11. package/skills/aipk_requirements-changes/GURU_AI.md +1 -1
  12. package/skills/aipk_requirements-documentation/GURU_AI.md +2 -2
  13. package/skills/aipk_requirements-documentation/SKILL.md +0 -6
  14. package/skills/aipk_requirements-intake/GURU_AI.md +2 -2
  15. package/skills/aipk_requirements-intake/SKILL.md +0 -1
  16. package/skills/aipk_requirements-review/GURU_AI.md +2 -2
  17. package/skills/aipk_requirements-review/SKILL.md +0 -1
  18. package/skills/aipk_skill_generate/GURU_AI.md +1 -1
  19. package/skills/aipk_tool_prompts/GURU_AI.md +2 -2
  20. package/skills/aipk_tool_prompts/SKILL.md +0 -1
  21. package/skills/aipk_update-requirements-from-design/GURU_AI.md +2 -2
  22. package/skills/aipk_update-requirements-from-design/SKILL.md +6 -6
  23. /package/mcp/skills/aipk_init_project/{SKILL.md → README.md} +0 -0
package/README.md CHANGED
@@ -16,7 +16,7 @@ PACKAGE_ROOT/
16
16
  └── tools/build_package/ # Bundled build scripts for MCP + template refresh
17
17
  ```
18
18
 
19
- **Documentation Standards**: All documentation follows the standards defined in [`docs/guide_writing_standard/SKILL.md`](docs/guide_writing_standard/SKILL.md), covering document structure, content organization, formatting, and template writing guidelines.
19
+ **Documentation Standards**: All documentation follows the standards defined in [`docs/guide_writing_standard/README.md`](docs/guide_writing_standard/README.md), covering document structure, content organization, formatting, and template writing guidelines.
20
20
 
21
21
  ## 🎯 Who This Helps
22
22
 
@@ -59,7 +59,11 @@ Skills provide templates, checklists, and guidance for each phase of the product
59
59
 
60
60
  #### 1. 📦 Installation & Update
61
61
 
62
- First-time setup or update to the latest version:
62
+ Choose one of the following methods depending on whether you want a direct install or an OpenSkill install:
63
+
64
+ ##### Option A – Direct install
65
+
66
+ Simple, one-command setup with no extra dependencies beyond npm.
63
67
 
64
68
  ```bash
65
69
  # Install or update Skills from your project root directory
@@ -68,6 +72,28 @@ npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit
68
72
 
69
73
  This downloads the Skill bundle (templates, scripts, and `GURU_AI.md` files) to `.claude/skills/` in your working tree. The bundle is ready to use immediately—agents learn where every Skill lives from `AGENTS.md`, so no explicit initialization command is required. See Quick Start below for lifecycle-specific prompts.
70
74
 
75
+ ##### Option B – OpenSkill install
76
+
77
+ Flexible approach that lets you add other community Skill bundles in addition to the official set.
78
+
79
+ 1. Ensure the CLI is installed globally:
80
+
81
+ ```bash
82
+ npm i -g openskills
83
+ ```
84
+ 2. Run the install command from your project root, pointing to the desired Skill:
85
+
86
+ ```bash
87
+ openskills install https://github.com/castbox/ai-product-workflow
88
+ ```
89
+ 3. Sync the Skill metadata so your agents see the newly added Skill:
90
+
91
+ ```bash
92
+ openskills sync
93
+ ```
94
+
95
+ These steps can be repeated for any other Skill repositories you want to bake into this workspace.
96
+
71
97
  ### ⚡ Using MCP Server
72
98
 
73
99
  The MCP Server makes AI Product Kit skills available as tools through the Model Context Protocol. Configure your preferred MCP client to connect to the server.
package/mcp/src/server.js CHANGED
@@ -29,8 +29,7 @@ const PRODUCT_KIT_SKILLS = {
29
29
  "aipk_requirements-review": join(PROJECT_ROOT, "skills/aipk_requirements-review/SKILL.md"),
30
30
  "aipk_skill_generate": join(PROJECT_ROOT, "skills/aipk_skill_generate/SKILL.md"),
31
31
  "aipk_tool_prompts": join(PROJECT_ROOT, "skills/aipk_tool_prompts/SKILL.md"),
32
- "aipk_update-requirements-from-design": join(PROJECT_ROOT, "skills/aipk_update-requirements-from-design/SKILL.md"),
33
- "aipk_init_project": join(PROJECT_ROOT, "mcp/skills/aipk_init_project/Skills.md"),};
32
+ "aipk_update-requirements-from-design": join(PROJECT_ROOT, "skills/aipk_update-requirements-from-design/SKILL.md"),};
34
33
 
35
34
  // Skill 描述映射
36
35
  const SKILL_DESCRIPTIONS = {
@@ -44,8 +43,7 @@ const SKILL_DESCRIPTIONS = {
44
43
  "aipk_requirements-review": "Skill for reviewing product requirement docs for template conformance, English-only UI copy, internal consistency, and producing a scored review report without editing the source document.",
45
44
  "aipk_skill_generate": "Playbook for creating or refreshing Skills so metadata, templates, and scripts meet Claude’s expectations; use when scaffolding Skills or syncing bundles, not for unrelated product content.",
46
45
  "aipk_tool_prompts": "Catalog of curated tool prompts with strengths, scenarios, and I/O rules for reuse; refer to it when consuming or extending prompts, not when writing unrelated product docs or new Skills.",
47
- "aipk_update-requirements-from-design": "Sync requirement docs with design mockups (composite or standalone UI frames) via split/mapping scripts, capturing visual alignment and change records; use this when design assets drive the update and avoid pure text-only work.",
48
- "aipk_init_project": "Initialize the project Agents playbook, sync the skills inventory into AGENTS.md/templates, and verify the workspace includes a complete AGENTS.md file.",};
46
+ "aipk_update-requirements-from-design": "Sync requirement docs with design mockups (composite or standalone UI frames) via split/mapping scripts, capturing visual alignment and change records; use this when design assets drive the update and avoid pure text-only work.",};
49
47
 
50
48
  const server = new Server(
51
49
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guru-ai-product/ai-product-kit",
3
- "version": "0.2.251218163225",
3
+ "version": "0.2.251226142524",
4
4
  "description": "Sync the AI Product Kit Skill bundle through npx without cloning the repository.",
5
5
  "scripts": {
6
6
  "publish": "node tools/build_package publish"
package/skills/aipk_aso-new-release/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_development/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_format-requirement-pages-with-design/GURU_AI.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
7
  | `requirement-page-table-format.md` | 2025-11-19T03:59:35.000Z |
8
- | `SKILL.md` | 2025-12-17T06:32:24.000Z |
8
+ | `SKILL.md` | 2025-12-26T06:21:32.000Z |
package/skills/aipk_format-requirement-pages-with-design/SKILL.md CHANGED
@@ -168,4 +168,3 @@ description: Format requirement document pages that include design images into s
168
168
  ## 6. 附加资源
169
169
 
170
170
  - [表格格式规范参考](./requirement-page-table-format.md) - 详细的格式规范、示例和检查清单
171
- - [需求文档撰写标准](../../../docs/guide_writing_standard/SKILL.md) - 项目文档撰写标准
package/skills/aipk_init_project/GURU_AI.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
7
  | `scripts/check_agents.sh` | 2025-11-13T09:03:47.000Z |
8
8
  | `skill.ini` | 2025-11-13T09:47:02.000Z |
9
9
  | `SKILL.md` | 2025-11-19T03:59:35.000Z |
10
- | `template/AGENTS_TEMPLATE.md` | 2025-12-18T08:32:25.690Z |
10
+ | `template/AGENTS_TEMPLATE.md` | 2025-12-26T06:25:24.835Z |
package/skills/aipk_initiative-planning/GURU_AI.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
- | `SKILL.md` | 2025-12-17T06:32:24.000Z |
7
+ | `SKILL.md` | 2025-12-26T06:21:16.000Z |
8
8
  | `template/SWOT分析模板.md` | 2025-11-19T03:59:35.000Z |
9
9
  | `template/产品规划模板.md` | 2025-11-19T03:59:35.000Z |
10
10
  | `template/商业化规划模板.md` | 2025-11-19T03:59:35.000Z |
package/skills/aipk_initiative-planning/SKILL.md CHANGED
@@ -429,10 +429,6 @@ A：保证措施：
429
429
  - [需求文档](../documentation/SKILL.md)
430
430
  - [需求评审](../review/SKILL.md)
431
431
 
432
- ### 外部资源
433
-
434
- - [指南文档规范](../../../docs/guide_writing_standard/SKILL.md)
435
-
436
432
  ## 📞 获取帮助
437
433
 
438
434
  如遇到问题，请参考：
package/skills/aipk_requirements-changes/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
package/skills/aipk_requirements-documentation/GURU_AI.md CHANGED
@@ -1,10 +1,10 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
- | `SKILL.md` | 2025-12-17T06:32:24.000Z |
7
+ | `SKILL.md` | 2025-12-26T06:21:10.000Z |
8
8
  | `template/1_产品定位与分析.md` | 2025-11-19T03:59:35.000Z |
9
9
  | `template/2_功能需求.md` | 2025-11-19T03:59:35.000Z |
10
10
  | `template/3_商业化策略.md` | 2025-11-19T03:59:35.000Z |
package/skills/aipk_requirements-documentation/SKILL.md CHANGED
@@ -711,12 +711,6 @@ graph TD
711
711
  - [需求迭代模板](./template/需求迭代模板.md) - 完整的需求迭代模板
712
712
  - [需求迭代索引模板](./template/需求迭代索引.md) - 需求迭代索引模板
713
713
 
714
- **通用指南模板**:
715
-
716
- - [指南文档标准模板](../../../docs/guide_writing_standard/template/指南文档标准模板.md) - 用于撰写各类标准指南。
717
- - [工具使用指南模板](../../../docs/guide_writing_standard/template/工具使用指南模板.md) - 用于撰写工具类的使用说明。
718
- > **提示**：如需撰写其他类型的指南文档，请参考这些标准模板
719
-
720
714
  ### 6.3 文档输出规范
721
715
 
722
716
  #### 6.3.1 文档存储位置和版本管理
package/skills/aipk_requirements-intake/GURU_AI.md CHANGED
@@ -1,13 +1,13 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
7
  | `examples/K12数学学习应用案例.md` | 2025-11-19T03:59:35.000Z |
8
8
  | `examples/电商平台优化案例.md` | 2025-11-19T03:59:35.000Z |
9
9
  | `references/Gemini_DeepResearch_工具链整合架构设计.md` | 2025-11-19T03:59:35.000Z |
10
- | `SKILL.md` | 2025-12-17T07:03:46.000Z |
10
+ | `SKILL.md` | 2025-12-26T06:21:21.000Z |
11
11
  | `template/产品需求发现与验证模板.md` | 2025-11-19T03:59:35.000Z |
12
12
  | `template/市场机会评估与竞争分析模板.md` | 2025-11-19T03:59:35.000Z |
13
13
  | `template/技术方案评估与可行性分析模板.md` | 2025-11-19T03:59:35.000Z |
package/skills/aipk_requirements-intake/SKILL.md CHANGED
@@ -278,7 +278,6 @@ A：优化方案：
278
278
 
279
279
  - [需求文档](../documentation/SKILL.md)
280
280
  - [需求文档模板](../documentation/template/)
281
- - [指南文档规范](../../../docs/guide_writing_standard/SKILL.md)
282
281
 
283
282
  ### 案例学习
284
283
 
package/skills/aipk_requirements-review/GURU_AI.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
7
- | `SKILL.md` | 2025-12-17T07:03:46.000Z |
7
+ | `SKILL.md` | 2025-12-26T06:21:26.000Z |
8
8
  | `template/Review_Report_Template.md` | 2025-11-27T12:40:17.000Z |
package/skills/aipk_requirements-review/SKILL.md CHANGED
@@ -104,7 +104,6 @@ description: Skill for reviewing product requirement docs for template conforman
104
104
 
105
105
  - 评审报告模板：`./template/Review_Report_Template.md`
106
106
  - 需求模板参考（用于比对结构）：`../aipk_requirements-documentation/template/index.md` 及子模板
107
- - 文档撰写规范：`docs/guide_writing_standard/SKILL.md`
108
107
 
109
108
  ## 交付要求
110
109
 
package/skills/aipk_skill_generate/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
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-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
@@ -8,6 +8,6 @@ Last refreshed: 2025-12-18T08:32:25.832Z
8
8
  | `images/20250710200701.png` | 2025-11-12T10:41:15.000Z |
9
9
  | `images/20250710200802.png` | 2025-11-12T10:41:15.000Z |
10
10
  | `Prompt生成.md` | 2025-11-12T10:41:15.000Z |
11
- | `SKILL.md` | 2025-11-19T03:59:35.000Z |
11
+ | `SKILL.md` | 2025-12-26T06:21:38.000Z |
12
12
  | `标记文档更新.md` | 2025-11-12T10:41:15.000Z |
13
13
  | `生成DrawIO文档.md` | 2025-11-12T10:41:15.000Z |
package/skills/aipk_tool_prompts/SKILL.md CHANGED
@@ -65,5 +65,4 @@ description: Catalog of curated tool prompts with strengths, scenarios, and I/O
65
65
 
66
66
  ## 5. 维护与扩展
67
67
  - **新增 Prompt**：按照 [`../skill_generate/SKILL.md`](../skill_generate/SKILL.md) 的 Skill 结构创建 Markdown，并在本目录表格中登记
68
- - **写作规范**：遵循 [`../../docs/guide_writing_standard/SKILL.md`](../../docs/guide_writing_standard/SKILL.md)，必要指令使用 HTML 注释 `<!-- MUST: ... -->`
69
68
  - **变更提示**：更新现有 Prompt 时同步修改本文件的概览表，确保用途与位置描述一致；若新增资源（如示例图片），请在对应段落追加说明
package/skills/aipk_update-requirements-from-design/GURU_AI.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # GURU AI Snapshot
2
2
 
3
- Last refreshed: 2025-12-18T08:32:25.832Z
3
+ Last refreshed: 2025-12-26T06:25:24.948Z
4
4
 
5
5
  | File | Last Modified (UTC) |
6
6
  | --- | --- |
@@ -118,4 +118,4 @@ Last refreshed: 2025-12-18T08:32:25.832Z
118
118
  | `scripts/sharp-runtime/package.json` | 2025-11-19T03:59:35.000Z |
119
119
  | `scripts/split-design-boards.js` | 2025-11-19T03:59:35.000Z |
120
120
  | `scripts/sync-design-to-requirements.js` | 2025-11-19T03:59:35.000Z |
121
- | `SKILL.md` | 2025-12-17T07:03:46.000Z |
121
+ | `SKILL.md` | 2025-12-26T06:22:14.000Z |
package/skills/aipk_update-requirements-from-design/SKILL.md CHANGED
@@ -264,7 +264,7 @@ ai-calorie_10.png,11-第一阶段完成,,11-第一阶段完成,
264
264
  node scripts/sync-design-to-requirements.js \
265
265
  --source .tmp/checkout-panels \
266
266
  --mapping .tmp/checkout-panels/mapping.csv \
267
- --destination ../../sample/docs/requirement/v1.3.0/assets \
267
+ --destination path/to/requirements/<version>/assets \
268
268
  --trim-top 140
269
269
  ```
270
270
 
@@ -299,9 +299,9 @@ node scripts/sync-design-to-requirements.js \
299
299
  **输出示例**：
300
300
 
301
301
  ```
302
- Copied .tmp/ai-calorie-panels/ai-calorie_01.png -> ../../sample/docs/requirement/v1.3.0/assets/1-上传全身照.png [missing]
303
- Skipped .tmp/ai-calorie-panels/ai-calorie_02.png -> ../../sample/docs/requirement/v1.3.0/assets/1-上传全身照备份.png [identical]
304
- Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirement/v1.3.0/assets/10-体重.png [different]
302
+ Copied .tmp/ai-calorie-panels/ai-calorie_01.png -> path/to/requirements/<version>/assets/1-上传全身照.png [missing]
303
+ Skipped .tmp/ai-calorie-panels/ai-calorie_02.png -> path/to/requirements/<version>/assets/1-上传全身照备份.png [identical]
304
+ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> path/to/requirements/<version>/assets/10-体重.png [different]
305
305
  ```
306
306
 
307
307
  ### 6.4 资产管理约定
@@ -383,7 +383,7 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
383
383
 
384
384
  **执行步骤**：
385
385
 
386
- 1. **创建目录**：在**需求文档版本文件夹下**创建 `changes/` 目录（如 `../../sample/docs/requirement/v1.3.0/changes/`），若不存在则创建。**重要**：变动说明文档必须保存在需求文档版本文件夹下的 `changes/` 目录中，而不是根目录的 `changes/` 文件夹。
386
+ 1. **创建目录**：在**需求文档版本文件夹下**创建 `changes/` 目录（如 `path/to/requirements/<version>/changes/`），若不存在则创建。**重要**：变动说明文档必须保存在需求文档版本文件夹下的 `changes/` 目录中，而不是根目录的 `changes/` 文件夹。
387
387
  2. **文件命名**：新文件命名格式为 `YYYYMMDD_需求文档变动说明_<旧版本>至<新版本>.md`（示例：`20241116_需求文档变动说明_v2.3.0至v2.4.0.md`）。
388
388
  3. **套用模板**：严格套用 [`../requirements/changes/template/需求变动说明文档模板.md`](../requirements/changes/template/需求变动说明文档模板.md)，不得增删章节；不适用项填 `*略*`。
389
389
  4. **填写变动详情**：在"文档级变动详情"章节明确列出：
@@ -398,7 +398,7 @@ Overwrote .tmp/ai-calorie-panels/ai-calorie_09.png -> ../../sample/docs/requirem
398
398
  - 入库命令（`scripts/sync-design-to-requirements.js`，见第6节）
399
399
  - 相关 issue/PR 链接（如有）
400
400
  7. **包含核对表**：将第7.2节生成的文案/设计对齐核对表包含在文档的"文档级变动详情"或"附录"章节中。
401
- 8. **生成文案/设计对齐核对表**：将第7.2节生成的文案/设计对齐核对表保存为 Markdown 文件到**需求文档版本文件夹下的 `check/`** 目录（如 `../../sample/docs/requirement/v1.3.0/check/YYYYMMDD_文案设计对齐核对表.md`）。**重要**：check 目录应保存的是文案/设计对齐核对表（记录设计图与需求文档的一致性比对），而非图片 diff 比对表（图片文件的哈希值比对）。核对表使用 Markdown 格式，包含表格和必要的说明文字。
401
+ 8. **生成文案/设计对齐核对表**：将第7.2节生成的文案/设计对齐核对表保存为 Markdown 文件到**需求文档版本文件夹下的 `check/`** 目录（如 `path/to/requirements/<version>/check/YYYYMMDD_文案设计对齐核对表.md`）。**重要**：check 目录应保存的是文案/设计对齐核对表（记录设计图与需求文档的一致性比对），而非图片 diff 比对表（图片文件的哈希值比对）。核对表使用 Markdown 格式，包含表格和必要的说明文字。
402
402
 
403
403
  **重要提醒**：必须在执行第9节（清理临时文件）之前完成此步骤，确保 `mapping.csv` 的内容已保存到需求变动说明文档中。
404
404