@guru-ai-product/ai-product-kit 0.2.251126200618 → 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 +1 -1
- 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 |
|