@guru-ai-product/ai-product-kit 0.2.251126195256 → 0.2.251127113824
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.
- package/README.md +51 -44
- package/package.json +1 -1
- package/skills/aipk_aso-new-release/GURU_AI.md +1 -1
- package/skills/aipk_development/GURU_AI.md +1 -1
- package/skills/aipk_format-requirement-pages-with-design/GURU_AI.md +1 -1
- package/skills/aipk_init_project/GURU_AI.md +2 -2
- package/skills/aipk_initiative-planning/GURU_AI.md +1 -1
- package/skills/aipk_requirements-changes/GURU_AI.md +1 -1
- package/skills/aipk_requirements-documentation/GURU_AI.md +1 -1
- package/skills/aipk_requirements-intake/GURU_AI.md +1 -1
- package/skills/aipk_requirements-review/GURU_AI.md +3 -3
- package/skills/aipk_requirements-review/SKILL.md +7 -6
- package/skills/aipk_requirements-review/template/Review_Report_Template.md +0 -2
- package/skills/aipk_skill_generate/GURU_AI.md +1 -1
- package/skills/aipk_tool_prompts/GURU_AI.md +1 -1
- package/skills/aipk_update-requirements-from-design/GURU_AI.md +1 -1
package/README.md
CHANGED
|
@@ -8,11 +8,12 @@ Looking for the Chinese version? See `README_CN.md`.
|
|
|
8
8
|
|
|
9
9
|
```text
|
|
10
10
|
PACKAGE_ROOT/
|
|
11
|
-
├── README.md / README_CN.md # English / Chinese entry points
|
|
11
|
+
├── README.md / README_CN.md # English / Chinese entry points
|
|
12
12
|
├── package.json # NPM package manifest
|
|
13
13
|
├── bin/ # Distribution-ready CLI entry points
|
|
14
|
-
├── mcp/ # MCP server implementation
|
|
15
|
-
|
|
14
|
+
├── mcp/ # MCP server implementation and templates
|
|
15
|
+
├── skills/ # Canonical lifecycle Skills and reusable guides
|
|
16
|
+
└── tools/build_package/ # Bundled build scripts for MCP + template refresh
|
|
16
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.
|
|
@@ -65,25 +66,7 @@ First-time setup or update to the latest version:
|
|
|
65
66
|
npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit
|
|
66
67
|
```
|
|
67
68
|
|
|
68
|
-
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.
|
|
69
|
-
|
|
70
|
-
#### 2. 🧩 Skill Usage Examples
|
|
71
|
-
|
|
72
|
-
Use the prompts below as templates for each Skill. Swap in your feature, artifact, or dataset details to get phase-specific deliverables.
|
|
73
|
-
|
|
74
|
-
| Skill | Scenario | Example Prompt | Likely Result |
|
|
75
|
-
|-------|----------|----------------|---------------|
|
|
76
|
-
| `aipk_init_project` | Onboarding a repo where AGENTS.md might be missing or outdated | `Run aipk_init_project to confirm AGENTS.md exists, diff it against skills/aipk_init_project/template/AGENTS_TEMPLATE.md, and tell me exactly which sections or <skills_system> entries must be restored (Project Overview stays custom).` | Detailed diff report plus step-by-step fixes to recreate AGENTS.md from the template, including guidance to regenerate the `<skills_system>` block. |
|
|
77
|
-
| `aipk_requirements-intake` | Early discovery needs multi-source research stitched together | `Run aipk_requirements-intake with our SensorTower、七麦、点点 data for voice journaling and produce the intake brief defined in template/市场机会评估与竞争分析模板.md.` | Structured intake deck that states the research question, synthesizes each dataset, and recommends validation experiments. |
|
|
78
|
-
| `aipk_requirements-documentation` | Need a template-compliant PRD or text-only iteration | `Trigger aipk_requirements-documentation, confirm the需求文档模板 is the right fit, then generate the full PRD for multimodal search without referencing mockups.` | Complete requirement doc that follows the chosen template section-by-section, including KPIs, flows, and acceptance criteria. |
|
|
79
|
-
| `aipk_requirements-changes` | Requirement delta needs to be captured for reviewers | `Use aipk_requirements-changes to describe everything that shifted between v1.2 and v1.3 of the sharing workflow using the 需求变动说明文档模板.` | Versioned change report with overview, commit history, diff tables, strategy notes, and approvals. |
|
|
80
|
-
| `aipk_initiative-planning` | Bridge research insights into a go/no-go plan | `Invoke aipk_initiative-planning to turn the voice intelligence expansion idea into the standard five-part立项规划 doc (market, product, technology, commercialization, SWOT).` | Initiative planning artifact that aligns stakeholders on scope, dependencies, staffing, and risk posture. |
|
|
81
|
-
| `aipk_update-requirements-from-design` | Design boards must sync with requirement assets and copy | `Run aipk_update-requirements-from-design to split the @checkout composite board, fill mapping.csv, sync assets, and update the linked requirement sections plus change notes.` | Updated assets folder, refreshed requirement sections that cite panel IDs, and a documented mapping/change log. |
|
|
82
|
-
| `aipk_format-requirement-pages-with-design` | Requirement pages need the mandated two-column HTML layout | `Apply aipk_format-requirement-pages-with-design to restyle the onboarding walkthrough into the table format with rowspan rules and inline `<br>` breaks.` | Markdown/HTML tables where each row pairs the written explanation with the referenced design asset exactly per the spec. |
|
|
83
|
-
| `aipk_aso-new-release` | New app version requires App Store/Play notes plus asset brief | `Use aipk_aso-new-release with the 4.2 highlights to draft the emoji-structured update notes and the asset table defined in references/aso-update-notes-template.md.` | Polished ASO copy plus a store-asset brief listing theme, feature tie-in, 15-char overlay copy, keyword, and priority. |
|
|
84
|
-
| `aipk_development` | Implementation plan needs to consolidate scope, schedule, QA | `Ask aipk_development to populate the 实施计划文档 for the voice summarization service, covering dependencies, owners, QA hooks, and rollout gates.` | Single implementation-plan document that mirrors the template and enumerates deliverables, checkpoints, and exit criteria. |
|
|
85
|
-
| `aipk_skill_generate` | A new reusable Skill must be scaffolded | `Use aipk_skill_generate to create aipk_data-retention-audit with SKILL.md, template stubs, and the required metadata callouts.` | Ready-to-ship Skill directory containing SKILL.md, template/references folders, and notes on packaging. |
|
|
86
|
-
| `aipk_tool_prompts` | Need to re-use a vetted automation prompt | `Look up aipk_tool_prompts for the 标记文档更新 prompt so I can highlight the Markdown diffs before review.` | Direct link to the prompt doc plus instructions covering inputs, outputs, and any supporting assets. |
|
|
69
|
+
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.
|
|
87
70
|
|
|
88
71
|
### ⚡ Using MCP Server
|
|
89
72
|
|
|
@@ -181,39 +164,63 @@ All AI Product Kit skills are available via MCP:
|
|
|
181
164
|
|
|
182
165
|
### 🚀 Quick Start
|
|
183
166
|
|
|
184
|
-
Agents already know where each Skill lives because the mappings are declared in `AGENTS.md`.
|
|
167
|
+
Agents already know where each Skill lives because the mappings are declared in `AGENTS.md`. Grab a prompt by lifecycle stage:
|
|
168
|
+
|
|
169
|
+
- **Project setup audit**
|
|
170
|
+
|
|
171
|
+
```text
|
|
172
|
+
Audit AGENTS.md against the expected template and tell me which sections or <skills_system> rows to restore.
|
|
173
|
+
```
|
|
174
|
+
Expected skill: `aipk_init_project`
|
|
175
|
+
|
|
176
|
+
- **Discovery & intake**
|
|
177
|
+
|
|
178
|
+
```text
|
|
179
|
+
Stitch pre-collected SensorTower、七麦、点点 data for voice journaling into an intake brief for the market-opportunity template.
|
|
180
|
+
```
|
|
181
|
+
Expected skill: `aipk_requirements-intake`
|
|
182
|
+
|
|
183
|
+
- **PRD drafting**
|
|
185
184
|
|
|
186
|
-
|
|
185
|
+
```text
|
|
186
|
+
Generate a multimodal search PRD that follows the standard template without referencing mockups.
|
|
187
|
+
```
|
|
188
|
+
Expected skill: `aipk_requirements-documentation`
|
|
187
189
|
|
|
188
|
-
|
|
189
|
-
Draft a PRD for the AI-assisted recording feature using the latest AI Product Kit template.
|
|
190
|
-
```
|
|
190
|
+
- **Change control**
|
|
191
191
|
|
|
192
|
-
|
|
192
|
+
```text
|
|
193
|
+
Summarize everything that shifted between v1.2 and v1.3 of the sharing flow using the standard change log format.
|
|
194
|
+
```
|
|
195
|
+
Expected skill: `aipk_requirements-changes`
|
|
193
196
|
|
|
194
|
-
|
|
195
|
-
Review the current launch checklist and tell me what's missing for the beta cut.
|
|
196
|
-
```
|
|
197
|
+
- **Design sync**
|
|
197
198
|
|
|
198
|
-
|
|
199
|
+
```text
|
|
200
|
+
Split the @checkout board into mapped panels, refresh mapping.csv, and restyle the linked requirement pages.
|
|
201
|
+
```
|
|
202
|
+
Expected skills: `aipk_update-requirements-from-design`, `aipk_format-requirement-pages-with-design`
|
|
199
203
|
|
|
200
|
-
|
|
201
|
-
Summarize the deltas between @panel_diff_v2 and the current AI Product Kit design standard, then propose fixes.
|
|
202
|
-
```
|
|
204
|
+
- **Delivery & QA**
|
|
203
205
|
|
|
204
|
-
|
|
206
|
+
```text
|
|
207
|
+
Fill the implementation plan for the voice summarization service, covering dependencies, owners, QA hooks, and rollout gates.
|
|
208
|
+
```
|
|
209
|
+
Expected skill: `aipk_development`
|
|
205
210
|
|
|
206
|
-
|
|
207
|
-
2. **Execute the script** – from `ROOT` run:
|
|
211
|
+
- **Release prep**
|
|
208
212
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
213
|
+
```text
|
|
214
|
+
Draft emoji-structured release notes and the asset brief for version 4.2 following the store update template.
|
|
215
|
+
```
|
|
216
|
+
Expected skill: `aipk_aso-new-release`
|
|
212
217
|
|
|
213
|
-
|
|
214
|
-
3. **Follow the prompts** – the script regenerates the MCP server & `MCP Skill Invocation` tables, syncs filesystem Skills, runs `npm pack --dry-run`, and then publishes with `npm publish --access public`.
|
|
218
|
+
## ❓ FAQ
|
|
215
219
|
|
|
216
|
-
|
|
220
|
+
- **Skill seems not loading?**
|
|
221
|
+
Start a new agent session and enter `Reload Agents.md`.
|
|
222
|
+
- **How do I confirm a skill ran?**
|
|
223
|
+
Check the agent output for a line like `🌟 I'm using skill "XXXX"`; if you see it, the skill invoked correctly.
|
|
217
224
|
|
|
218
225
|
## 📄 License
|
|
219
226
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guru-ai-product/ai-product-kit",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.251127113824",
|
|
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"
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
# GURU AI Snapshot
|
|
2
2
|
|
|
3
|
-
Last refreshed: 2025-11-
|
|
3
|
+
Last refreshed: 2025-11-27T03:38:24.753Z
|
|
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-11-
|
|
10
|
+
| `template/AGENTS_TEMPLATE.md` | 2025-11-27T03:38:24.664Z |
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# GURU AI Snapshot
|
|
2
2
|
|
|
3
|
-
Last refreshed: 2025-11-
|
|
3
|
+
Last refreshed: 2025-11-27T03:38:24.753Z
|
|
4
4
|
|
|
5
5
|
| File | Last Modified (UTC) |
|
|
6
6
|
| --- | --- |
|
|
7
|
-
| `SKILL.md` | 2025-11-
|
|
8
|
-
| `template/Review_Report_Template.md` | 2025-11-
|
|
7
|
+
| `SKILL.md` | 2025-11-26T12:01:09.000Z |
|
|
8
|
+
| `template/Review_Report_Template.md` | 2025-11-26T12:06:03.000Z |
|
|
@@ -24,27 +24,28 @@ description: Skill for reviewing product requirement docs for template conforman
|
|
|
24
24
|
## 评审流程
|
|
25
25
|
|
|
26
26
|
1. 对齐评审范围：明确文档版本、涉及模块和交付期，确认需对照的模板名称。
|
|
27
|
-
2.
|
|
27
|
+
2. 检查忽略列表：如存在 `review/ignore.md`，先阅读其中记录的问题，并在后续评审中跳过这些已确认忽略项。
|
|
28
|
+
3. 模板符合性检查：
|
|
28
29
|
- 核对章节齐全性、顺序、层级、编号、表格/列表格式是否与模板一致。
|
|
29
30
|
- 标记缺失章节、格式偏差或模板约定未落实的内容。
|
|
30
|
-
|
|
31
|
+
4. UI 文案语言检查：
|
|
31
32
|
- 检查界面文案、按钮、提示、消息等是否全部为英文，避免中英混排或非英文内容。
|
|
32
33
|
- 标记疑似翻译遗漏、拼写/大小写不当、术语不一致。
|
|
33
|
-
|
|
34
|
+
5. 内容一致性与冲突检查：
|
|
34
35
|
- 交叉核对需求摘要、业务流程、交互说明、验收标准是否互相矛盾或前后不一致。
|
|
35
36
|
- 标记模糊描述、冲突规则、缺失的前置条件或异常处理。
|
|
36
37
|
- 服务端设计仅检查是否存在明显歧义或冲突，不做完备性验证（此部分仅为建议）。
|
|
37
38
|
- 若文档含设计图（图片形式），需阅读图片并核对与文字说明的一致性（文案、布局、交互流程等），发现偏差需标注。
|
|
38
|
-
|
|
39
|
+
6. 评分与结论：
|
|
39
40
|
- 使用本 Skill 评分规则（下节）给出总分（满分 100，及格线 80）。
|
|
40
41
|
- 记录主要扣分原因，保持可追溯。
|
|
41
|
-
|
|
42
|
+
7. 输出评审报告：
|
|
42
43
|
- 使用模板 `./template/Review_Report_Template.md` 填写，不修改原需求文档。
|
|
43
44
|
- 若评审多份需求，合并为单份批次报告，并在“覆盖文档”中列出所有文件及版本。
|
|
44
45
|
- 报告文件命名：`YYYYMMDD_vX.X.X需求评审_N.md`（N 为当日第 N 次评审，例：`20240915_v1.2.0需求评审_1.md`）。
|
|
45
46
|
- 在表格中标注问题对应的文档段落/位置，使用可点击链接指向文件或具体段落，给出整改建议和严重度。
|
|
46
47
|
- 报告存放路径：置于对应评审版本需求文档文件夹下的 `review/` 子目录；报告中所有文档链接使用相对路径。
|
|
47
|
-
|
|
48
|
+
8. 忽略项记录：若明确某些问题被确认可忽略，在 `review/ignore.md` 创建或追加表格记录：问题内容、对应文档（相对链接）、忽略原因（无明确原因可留空）。
|
|
48
49
|
|
|
49
50
|
## 评分规则（满分 100，≥80 通过）
|
|
50
51
|
|