@guru-ai-product/ai-product-kit 0.2.251117163427 → 0.2.251117191453

package/README.md

@@ -11,12 +11,16 @@ ROOT/
 ├── AGENTS.md                   # Single source of truth for agent guardrails and workflow rules
 ├── skills/                     # Canonical lifecycle Skills and reusable guides
 │   ├── aipk_init_project/      # Project bootstrap workflow plus AGENTS enforcement scripts
-│   ├── aipk_requirements/      # Research, requirements authoring, reviews, change management
-│   ├── aipk_design/            # Script-driven automation (panel mapping, asset diffs, etc.)
-│   ├── aipk_development/       # Engineering playbooks and implementation templates
-│   ├── aipk_operations/        # Growth, launch prep, and post-launch tooling
-│   ├── aipk_skill_generate/    # Standards for creating or extending Skills
-│   └── aipk_tool_prompts/      # Reusable AI prompt blocks referenced by other Skills
+│   ├── aipk_requirements-intake/ # Research and intake automation workflows
+│   ├── aipk_requirements-documentation/ # PRD drafting and iteration templates
+│   ├── aipk_requirements-changes/ # Change management templates and prompts
+│   ├── aipk_initiative-planning/ # Initiative evaluation and scoping playbooks
+│   ├── aipk_update-requirements-from-design/ # Align requirements to design mockups
+│   ├── aipk_format-requirement-pages-with-design/ # Table-based layout for design+text pages
+│   ├── aipk_aso-new-release/     # ASO content and store asset guidance
+│   ├── aipk_development/         # Engineering playbooks and implementation templates
+│   ├── aipk_skill_generate/      # Standards for creating or extending Skills
+│   └── aipk_tool_prompts/        # Reusable AI prompt blocks referenced by other Skills
 ├── docs/                       # Legacy landing pages and shared standards referenced by Skills
 ├── mcp/                        # MCP local service (Node, entry `mcp/src/server.js`), documentation, and tests
 ├── bin/                        # Distribution-ready CLI entry points (e.g., `ai-product-kit.js`)
@@ -31,11 +35,11 @@ ROOT/
 
 ## 🎯 Who This Helps
 
-* **Product managers** – start in `skills/aipk_requirements` for market analysis, user research, and PRD templates.
-* **Designers** – leverage `skills/aipk_design` for automated panel/asset workflows, and pair it with the requirements skills for context.
-* **Engineers** – use `skills/aipk_development` for architecture notes and delivery checklists.
-* **QA teams** – align with the acceptance criteria defined in `skills/aipk_requirements` and leverage `skills/aipk_development` checklists for validation.
-* **Operators & growth** – explore `skills/aipk_operations` for launch, engagement, and optimization plans.
+* **Product managers** – start with the `aipk_requirements-intake`, `aipk_requirements-documentation`, and `aipk_requirements-changes` skills for research, PRDs, and change management.
+* **Designers** – invoke the `aipk_update-requirements-from-design` and `aipk_format-requirement-pages-with-design` skills when you need to align composite mockups, split panels, or embed visuals into requirement pages.
+* **Engineers** – use the `aipk_development` skill for architecture notes and delivery checklists.
+* **QA teams** – use the `aipk_requirements-documentation` skill for acceptance criteria and pair with `aipk_development` for validation tasks.
+* **Operators & growth** – rely on the `aipk_aso-new-release` skill for launch updates, store copy, and asset guidance.
 
 ## 📚 Core Capabilities
 
@@ -159,7 +163,7 @@ Once configured, the MCP Server provides the `product_kit_skill` tool:
 - **Tool Name**: `product_kit_skill`
 - **Purpose**: Retrieve any AI Product Kit skill guide or template
 - **Parameters**:
-  - `skill_name` (string, required) - Name of the skill to retrieve (e.g., `aipk_requirements`)
+- `skill_name` (string, required) - Name of the skill to retrieve (e.g., `aipk_requirements-documentation`)
 
 The tool returns:
 - `skill_name`: The requested skill name
@@ -178,10 +182,14 @@ Initialize my project using the init-project skill with the product_kit_skill to
 
 All AI Product Kit skills are available via MCP:
 - `aipk_init_project` - Project bootstrapping
-- `aipk_requirements` - Requirements discovery and documentation
-- `aipk_design` - Design workflows and automation
+- `aipk_requirements-intake` - Intake and research automation
+- `aipk_requirements-documentation` - PRD drafting + iteration templates
+- `aipk_requirements-changes` - Change documentation and prompts
+- `aipk_initiative-planning` - Initiative evaluation and scoping
+- `aipk_update-requirements-from-design` - Sync requirements with design mockups
+- `aipk_format-requirement-pages-with-design` - Table formatting for design pages
+- `aipk_aso-new-release` - ASO copy and asset guidance
 - `aipk_development` - Engineering playbooks
-- `aipk_operations` - Post-launch operations
 - `aipk_skill_generate` - Skill creation standards
 - `aipk_tool_prompts` - Reusable AI prompt catalog
 

package/bin/setup.js

@@ -110,8 +110,8 @@ function ensureAgentsMd() {
   }
 
   const skills = collectSkillMetadata();
-  const newSection = renderAgentsTemplateForSkills(skills);
-  const updated = replaceSkillsSection(content, newSection);
+  const newTemplate = renderAgentsTemplateForSkills(skills);
+  const updated = mergeAgentsContent(content, newTemplate);
 
   if (updated !== content) {
     fs.writeFileSync(agentsPath, updated, 'utf8');
@@ -242,20 +242,104 @@ function generateSkillEntries(skills) {
     .join('\n\n');
 }
 
-function replaceSkillsSection(content, newSection) {
-  const xmlRegex = /<skills_system[\s\S]*?<\/skills_system>/;
-  if (xmlRegex.test(content)) {
-    return content.replace(xmlRegex, newSection);
+function mergeAgentsContent(existingContent, newTemplate) {
+  const templateParts = parseTemplate(newTemplate);
+  const existingParts = parseExistingContent(existingContent);
+
+  const parts = [];
+
+  if (existingParts.beforeProjectOverview) {
+    parts.push(existingParts.beforeProjectOverview);
+  }
+
+  if (existingParts.projectOverview) {
+    parts.push(existingParts.projectOverview);
+  } else if (templateParts.projectOverview) {
+    parts.push(templateParts.projectOverview);
+  }
+
+  if (templateParts.conventions) {
+    parts.push(templateParts.conventions);
+  }
+
+  if (templateParts.skillsBundleAccess) {
+    parts.push(templateParts.skillsBundleAccess);
+  }
+
+  if (templateParts.skillsSystem) {
+    parts.push(templateParts.skillsSystem);
+  }
+
+  if (templateParts.ruleComment) {
+    parts.push(templateParts.ruleComment);
+  }
+
+  if (existingParts.afterRuleComment) {
+    parts.push(existingParts.afterRuleComment);
+  }
+
+  return parts.join('\n\n').trim() + '\n';
+}
+
+function parseTemplate(template) {
+  const parts = {};
+
+  const projectOverviewMatch = template.match(/# Project Overview\s*\n([\s\S]*?)(?=\n## Conventions|<skills_system|$)/);
+  if (projectOverviewMatch) {
+    parts.projectOverview = `# Project Overview\n${projectOverviewMatch[1].trim()}`;
   }
 
-  const htmlRegex = /<!-- SKILLS_TABLE_START -->[\s\S]*?<!-- SKILLS_TABLE_END -->/;
-  if (htmlRegex.test(content)) {
-    const inner = newSection
-      .replace(/<skills_system[^>]*>/, '')
-      .replace('</skills_system>', '')
-      .trim();
-    return content.replace(htmlRegex, `<!-- SKILLS_TABLE_START -->\n${inner}\n<!-- SKILLS_TABLE_END -->`);
+  const conventionsMatch = template.match(/## Conventions\s*\n([\s\S]*?)(?=\n## Skills Bundle Access|<skills_system|$)/);
+  if (conventionsMatch) {
+    parts.conventions = `## Conventions\n${conventionsMatch[1].trim()}`;
+  }
+
+  const skillsBundleAccessMatch = template.match(/## Skills Bundle Access\s*\n([\s\S]*?)(?=<skills_system|$)/);
+  if (skillsBundleAccessMatch) {
+    parts.skillsBundleAccess = `## Skills Bundle Access\n${skillsBundleAccessMatch[1].trim()}`;
+  }
+
+  const skillsSystemMatch = template.match(/<skills_system[\s\S]*?<\/skills_system>/);
+  if (skillsSystemMatch) {
+    parts.skillsSystem = skillsSystemMatch[0];
+  }
+
+  const ruleCommentMatch = template.match(/<!-- rule:[\s\S]*?-->/);
+  if (ruleCommentMatch) {
+    parts.ruleComment = ruleCommentMatch[0];
+  }
+
+  return parts;
+}
+
+function parseExistingContent(content) {
+  const parts = {};
+
+  const projectOverviewStart = content.search(/# Project Overview/);
+  if (projectOverviewStart === -1) {
+    const beforeConventions = content.split(/## Conventions|<skills_system/)[0].trim();
+    if (beforeConventions) {
+      parts.beforeProjectOverview = beforeConventions;
+    }
+    return parts;
+  }
+
+  if (projectOverviewStart > 0) {
+    parts.beforeProjectOverview = content.substring(0, projectOverviewStart).trim();
+  }
+
+  const projectOverviewMatch = content.substring(projectOverviewStart).match(/# Project Overview\s*\n([\s\S]*?)(?=\n## Conventions|<skills_system|$)/);
+  if (projectOverviewMatch) {
+    parts.projectOverview = `# Project Overview\n${projectOverviewMatch[1].trim()}`;
+  }
+
+  const ruleCommentMatch = content.match(/<!-- rule:[\s\S]*?-->/);
+  if (ruleCommentMatch) {
+    const afterRuleComment = content.substring(content.indexOf(ruleCommentMatch[0]) + ruleCommentMatch[0].length).trim();
+    if (afterRuleComment) {
+      parts.afterRuleComment = afterRuleComment;
+    }
   }
 
-  return content.trimEnd() + '\n\n' + newSection + '\n';
+  return parts;
 }

package/mcp/docs/AI_Product_Kit_MCP_/351/234/200/346/261/202/350/257/264/346/230/216.md

@@ -81,7 +81,7 @@
 
 ## 目录结构参考
 
-- [`skills/aipk_requirements/documentation/SKILL.md`](../../skills/aipk_requirements/documentation/SKILL.md)
+- [`skills/aipk_requirements-documentation/SKILL.md`](../../skills/aipk_requirements-documentation/SKILL.md)
 - [`skills/aipk_tool_prompts/Prompt生成.md`](../../skills/aipk_tool_prompts/Prompt生成.md)
 - [`skills/aipk_tool_prompts/标记文档更新.md`](../../skills/aipk_tool_prompts/标记文档更新.md)
 - [`skills/aipk_tool_prompts/生成DrawIO文档.md`](../../skills/aipk_tool_prompts/生成DrawIO文档.md)

package/mcp/skills/aipk_init_project/template/AGENTS_TEMPLATE.md

@@ -7,7 +7,7 @@ Write a concise overview of your project here. Keep it brief and scannable.
 ## Conventions
 
 - Keep the `<skills_system>` block intact in Skills mode.
-- Fetch the latest AI Product Kit skills bundle and templates with `npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit`, which downloads everything into `.claude/skills/`.
+- Fetch the latest AI Product Kit skills bundle and templates with `npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit`, which downloads everything into `.claude/skills/`, **only when you explicitly need the newest skills or when a required skill isn’t available locally**.
 
 > **Mode**: MCP Server. Agents connect via MCP and invoke the Skill tool with arguments.
 
@@ -19,38 +19,66 @@ Use these MCP tools to load a Skill by name. The server maps known Skill names t
 <mcp_skills>
 
 <skill>
-<name>design</name>
-<description>Central hub for automation-ready design-to-requirement workflows. When agents receive composite design boards and need to update requirement documents with new visuals, verify differences between mockups and existing docs, and sync changes systematically, they consult this index to discover the appropriate sub-skill (update-requirements-from-design) for handling design-driven requirement updates.</description>
+<name>aipk_aso-new-release</name>
+<description>This skill should be used when generating ASO content for a new app version, covering update notes and refreshed store asset guidance.</description>
 <tool>product_kit_skill</tool>
-<arguments>{"skill_name": "aipk_design"}</arguments>
+<arguments>{"skill_name": "aipk_aso-new-release"}</arguments>
 </skill>
 
 <skill>
-<name>development</name>
-<description>Development phase index pointing to the single authoritative implementation plan template.</description>
+<name>aipk_format-requirement-pages-with-design</name>
+<description>Format requirement document pages with design images into standardized tables. Use when requirement documents contain design images and need to be organized into a two-column table format (page description | design image) following the project's table formatting standards.</description>
 <tool>product_kit_skill</tool>
-<arguments>{"skill_name": "aipk_development"}</arguments>
+<arguments>{"skill_name": "aipk_format-requirement-pages-with-design"}</arguments>
 </skill>
 
 <skill>
-<name>init-project</name>
-<description>Initialize the project Agents playbook, sync the skills inventory into AGENTS.md/templates, and verify the workspace includes a complete AGENTS.md file.</description>
+<name>aipk_initiative-planning</name>
+<description>Comprehensive workflow for evaluating, scoping, and approving new product initiatives.</description>
 <tool>product_kit_skill</tool>
-<arguments>{"skill_name": "aipk_init_project"}</arguments>
+<arguments>{"skill_name": "aipk_initiative-planning"}</arguments>
+</skill>
+
+<skill>
+<name>aipk_requirements-changes</name>
+<description>Templates, prompts, and procedures for documenting and reviewing requirement changes.</description>
+<tool>product_kit_skill</tool>
+<arguments>{"skill_name": "aipk_requirements-changes"}</arguments>
+</skill>
+
+<skill>
+<name>aipk_requirements-documentation</name>
+<description>Create new requirement documents or iterate on existing ones from scratch. Use this ONLY when the task involves drafting brand-new requirement documents or conducting requirement reviews WITHOUT starting from design assets. If the task involves updating requirements from design mockups or modifying docs based on visual designs, use the `skills/update-requirements-from-design` skill instead.</description>
+<tool>product_kit_skill</tool>
+<arguments>{"skill_name": "aipk_requirements-documentation"}</arguments>
 </skill>
 
 <skill>
-<name>operations</name>
-<description>Canonical entry point for every post-release operating guide; maps scenarios to the available Skills and explains how to invoke them.</description>
+<name>aipk_requirements-intake</name>
+<description>Intelligent intake pipeline for gathering and consolidating product requirements from multiple sources.</description>
 <tool>product_kit_skill</tool>
-<arguments>{"skill_name": "aipk_operations"}</arguments>
+<arguments>{"skill_name": "aipk_requirements-intake"}</arguments>
 </skill>
 
 <skill>
-<name>requirements</name>
-<description>Central repository for requirement discovery, documentation, review, and change management assets.</description>
+<name>aipk_update-requirements-from-design</name>
+<description>Update requirement documents based on design mockups (composite boards or individual UI frames). Use this when you need to split composite boards or directly align single/multiple standalone UI images with requirement docs, including syncing visuals, verifying differences, and generating change records.</description>
 <tool>product_kit_skill</tool>
-<arguments>{"skill_name": "aipk_requirements"}</arguments>
+<arguments>{"skill_name": "aipk_update-requirements-from-design"}</arguments>
+</skill>
+
+<skill>
+<name>development</name>
+<description>Development phase index pointing to the single authoritative implementation plan template.</description>
+<tool>product_kit_skill</tool>
+<arguments>{"skill_name": "aipk_development"}</arguments>
+</skill>
+
+<skill>
+<name>init-project</name>
+<description>Initialize the project Agents playbook, sync the skills inventory into AGENTS.md/templates, and verify the workspace includes a complete AGENTS.md file.</description>
+<tool>product_kit_skill</tool>
+<arguments>{"skill_name": "aipk_init_project"}</arguments>
 </skill>
 
 <skill>
@@ -62,7 +90,7 @@ Use these MCP tools to load a Skill by name. The server maps known Skill names t
 
 <skill>
 <name>tool_prompts</name>
-<description>Catalog of reusable prompts for AI tooling workflows, including their usage guidance and file locations.</description>
+<description>Directory of curated tool prompts, their core strengths, calling scenarios, input/output expectations, and the Markdown files that describe how to run them.</description>
 <tool>product_kit_skill</tool>
 <arguments>{"skill_name": "aipk_tool_prompts"}</arguments>
 </skill>

package/mcp/src/server.js

@@ -19,22 +19,30 @@ import { join } from 'path';
 // Product Kit Skills 映射 - 只包含 skills 下一级目录的主 skill
 // 每个键对应一个主 skill 目录，值是该 skill 的 SKILL.md 文件路径
 const PRODUCT_KIT_SKILLS = {
-  "aipk_design": join(PROJECT_ROOT, "skills/aipk_design/SKILL.md"),
+  "aipk_aso-new-release": join(PROJECT_ROOT, "skills/aipk_aso-new-release/SKILL.md"),
   "aipk_development": join(PROJECT_ROOT, "skills/aipk_development/SKILL.md"),
-  "aipk_operations": join(PROJECT_ROOT, "skills/aipk_operations/SKILL.md"),
-  "aipk_requirements": join(PROJECT_ROOT, "skills/aipk_requirements/SKILL.md"),
+  "aipk_format-requirement-pages-with-design": join(PROJECT_ROOT, "skills/aipk_format-requirement-pages-with-design/SKILL.md"),
+  "aipk_initiative-planning": join(PROJECT_ROOT, "skills/aipk_initiative-planning/SKILL.md"),
+  "aipk_requirements-changes": join(PROJECT_ROOT, "skills/aipk_requirements-changes/SKILL.md"),
+  "aipk_requirements-documentation": join(PROJECT_ROOT, "skills/aipk_requirements-documentation/SKILL.md"),
+  "aipk_requirements-intake": join(PROJECT_ROOT, "skills/aipk_requirements-intake/SKILL.md"),
   "aipk_skill_generate": join(PROJECT_ROOT, "skills/aipk_skill_generate/SKILL.md"),
   "aipk_tool_prompts": join(PROJECT_ROOT, "skills/aipk_tool_prompts/SKILL.md"),
+  "aipk_update-requirements-from-design": join(PROJECT_ROOT, "skills/aipk_update-requirements-from-design/SKILL.md"),
   "aipk_init_project": join(PROJECT_ROOT, "mcp/skills/aipk_init_project/Skills.md"),};
 
 // Skill 描述映射
 const SKILL_DESCRIPTIONS = {
-  "aipk_design": "Central hub for automation-ready design-to-requirement workflows. When agents receive composite design boards and need to update requirement documents with new visuals, verify differences between mockups and existing docs, and sync changes systematically, they consult this index to discover the appropriate sub-skill (update-requirements-from-design) for handling design-driven requirement updates.",
+  "aipk_aso-new-release": "This skill should be used when generating ASO content for a new app version, covering update notes and refreshed store asset guidance.",
   "aipk_development": "Development phase index pointing to the single authoritative implementation plan template.",
-  "aipk_operations": "Canonical entry point for every post-release operating guide; maps scenarios to the available Skills and explains how to invoke them.",
-  "aipk_requirements": "Central repository for requirement discovery, documentation, review, and change management assets.",
+  "aipk_format-requirement-pages-with-design": "Format requirement document pages with design images into standardized tables. Use when requirement documents contain design images and need to be organized into a two-column table format (page description | design image) following the project's table formatting standards.",
+  "aipk_initiative-planning": "Comprehensive workflow for evaluating, scoping, and approving new product initiatives.",
+  "aipk_requirements-changes": "Templates, prompts, and procedures for documenting and reviewing requirement changes.",
+  "aipk_requirements-documentation": "Create new requirement documents or iterate on existing ones from scratch. Use this ONLY when the task involves drafting brand-new requirement documents or conducting requirement reviews WITHOUT starting from design assets. If the task involves updating requirements from design mockups or modifying docs based on visual designs, use the `skills/update-requirements-from-design` skill instead.",
+  "aipk_requirements-intake": "Intelligent intake pipeline for gathering and consolidating product requirements from multiple sources.",
   "aipk_skill_generate": "Standards and practices for creating new Agent Skills that extend Claude with reusable workflows, documentation, and tooling assets.",
-  "aipk_tool_prompts": "Catalog of reusable prompts for AI tooling workflows, including their usage guidance and file locations.",
+  "aipk_tool_prompts": "Directory of curated tool prompts, their core strengths, calling scenarios, input/output expectations, and the Markdown files that describe how to run them.",
+  "aipk_update-requirements-from-design": "Update requirement documents based on design mockups (composite boards or individual UI frames). Use this when you need to split composite boards or directly align single/multiple standalone UI images with requirement docs, including syncing visuals, verifying differences, and generating change records.",
   "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.",};
 
 const server = new Server(

package/mcp/src/test_server.js

@@ -18,7 +18,7 @@ setTimeout(async () => {
     console.log('\nTo fully test the server:');
     console.log('1. Configure your MCP client to use this server');
     console.log('2. Call the product_kit_skill tool with a valid skill name');
-    console.log('3. Example: { skill_name: "aipk_requirements" }');
+    console.log('3. Example: { skill_name: "aipk_requirements-documentation" }');
     process.exit(0);
   } catch (error) {
     console.error('Test failed:', error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guru-ai-product/ai-product-kit",
-  "version": "0.2.251117163427",
+  "version": "0.2.251117191453",
   "description": "Sync the AI Product Kit Skill bundle through npx without cloning the repository.",
   "bin": {
     "ai-product-kit": "bin/setup.js",

package/skills/aipk_aso-new-release/GURU_AI.md

@@ -0,0 +1,9 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `references/aso-update-notes-prompt.md` | 2025-11-12T10:41:15.857Z |
+| `references/aso-update-notes-template.md` | 2025-11-12T10:41:15.857Z |
+| `SKILL.md` | 2025-11-17T09:13:53.653Z |

package/skills/{aipk_operations/aso_new_release → aipk_aso-new-release}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: aso-new-release
+name: aipk_aso-new-release
 description: This skill should be used when generating ASO content for a new app version, covering update notes and refreshed store asset guidance.
 ---
 

package/skills/aipk_development/GURU_AI.md

@@ -1,8 +1,8 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-17T08:34:27.508Z
+Last refreshed: 2025-11-17T11:14:53.954Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `SKILL.md` | 2025-11-12T10:41:15.855Z |
-| `templates/实施计划文档.md` | 2025-11-12T10:41:15.855Z |
+| `templates/实施计划文档.md` | 2025-11-17T09:33:20.784Z |

package/skills/aipk_development/templates//345/256/236/346/226/275/350/256/241/345/210/222/346/226/207/346/241/243.md

@@ -298,5 +298,5 @@
 
 **相关文档**：
 
-- [产品需求文档](../requirements/documentation/template/)
-- 需要设计自动化辅助时，可参考 [`skills/aipk_design/SKILL.md`](../design/SKILL.md)
+- [产品需求文档](../aipk_requirements-documentation/template/)
+- 需要设计自动化辅助时，可参考 `aipk_format-requirement-pages-with-design` skill 或 `aipk_update-requirements-from-design` skill。

package/skills/aipk_format-requirement-pages-with-design/GURU_AI.md

@@ -0,0 +1,8 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `requirement-page-table-format.md` | 2025-11-17T06:21:56.025Z |
+| `SKILL.md` | 2025-11-17T09:13:58.040Z |

package/skills/{aipk_design/format-requirement-pages-with-design → aipk_format-requirement-pages-with-design}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: format-requirement-pages-with-design
+name: aipk_format-requirement-pages-with-design
 description: Format requirement document pages with design images into standardized tables. Use when requirement documents contain design images and need to be organized into a two-column table format (page description | design image) following the project's table formatting standards.
 ---
 

package/skills/aipk_init_project/GURU_AI.md

@@ -1,10 +1,10 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-11-17T08:34:27.508Z
+Last refreshed: 2025-11-17T11:14:53.954Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `scripts/check_agents.sh` | 2025-11-13T09:03:47.702Z |
 | `skill.ini` | 2025-11-13T09:47:02.793Z |
 | `SKILL.md` | 2025-11-13T10:06:33.764Z |
-| `template/AGENTS_TEMPLATE.md` | 2025-11-17T08:34:27.435Z |
+| `template/AGENTS_TEMPLATE.md` | 2025-11-17T11:14:53.842Z |

package/skills/aipk_init_project/template/AGENTS_TEMPLATE.md

@@ -7,7 +7,7 @@ Write a concise overview of your project here. Keep it brief and scannable.
 ## Conventions
 
 - Keep the `<skills_system>` block intact in Skills mode.
-- Fetch the latest AI Product Kit skills bundle and templates with `npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit`, which downloads everything into `.claude/skills/`.
+- Fetch the latest AI Product Kit skills bundle and templates with `npx -y @guru-ai-product/ai-product-kit@latest ai-product-kit`, which downloads everything into `.claude/skills/`, **only when you explicitly need the newest skills or when a required skill isn’t available locally**.
 
 > **Mode**: Skills bundle (.claude/skills/). Agents operate inside the project workspace and read templates directly from the downloaded Skill bundle.
 

package/skills/aipk_initiative-planning/GURU_AI.md

@@ -0,0 +1,12 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `SKILL.md` | 2025-11-17T09:14:19.526Z |
+| `template/SWOT分析模板.md` | 2025-11-12T10:41:15.864Z |
+| `template/产品规划模板.md` | 2025-11-12T10:41:15.864Z |
+| `template/商业化规划模板.md` | 2025-11-12T10:41:15.864Z |
+| `template/市场与商业分析模板.md` | 2025-11-12T10:41:15.865Z |
+| `template/技术规划模板.md` | 2025-11-12T10:41:15.865Z |

package/skills/{aipk_requirements/initiative_planning → aipk_initiative-planning}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: initiative-planning
+name: aipk_initiative-planning
 description: Comprehensive workflow for evaluating, scoping, and approving new product initiatives.
 ---
 

package/skills/aipk_requirements-changes/GURU_AI.md

@@ -0,0 +1,11 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `SKILL.md` | 2025-11-17T09:14:02.152Z |
+| `template/index.md` | 2025-11-12T10:41:15.858Z |
+| `template/需求变动说明文档模板.md` | 2025-11-12T10:41:15.859Z |
+| `template/需求变动说明生成Prompt.md` | 2025-11-12T10:41:15.859Z |
+| `template/需求变动说明生成指南.md` | 2025-11-12T10:41:15.859Z |

package/skills/{aipk_requirements/changes → aipk_requirements-changes}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: requirements-changes
+name: aipk_requirements-changes
 description: Templates, prompts, and procedures for documenting and reviewing requirement changes.
 ---
 

package/skills/aipk_requirements-documentation/GURU_AI.md

@@ -0,0 +1,20 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `SKILL.md` | 2025-11-17T09:39:31.163Z |
+| `template/1_产品定位与分析.md` | 2025-11-17T06:49:33.762Z |
+| `template/2_功能需求.md` | 2025-11-17T06:49:38.006Z |
+| `template/3_商业化策略.md` | 2025-11-17T06:43:53.421Z |
+| `template/4.1_用户体验流程与信息架构.md` | 2025-11-17T06:49:16.631Z |
+| `template/4.2_关键界面.md` | 2025-11-17T08:47:29.822Z |
+| `template/4.3_交互与响应式设计.md` | 2025-11-17T06:43:51.131Z |
+| `template/AI 应用类APP通用埋点文档.xlsx` | 2025-11-12T10:41:15.861Z |
+| `template/Draft_产品需求草稿.md` | 2025-11-12T10:41:15.862Z |
+| `template/Draft_用户旅程草稿.md` | 2025-11-12T10:41:15.862Z |
+| `template/index.md` | 2025-11-17T06:43:52.439Z |
+| `template/埋点规范文档.md` | 2025-11-12T10:41:15.862Z |
+| `template/需求迭代模板.md` | 2025-11-17T08:47:38.383Z |
+| `template/需求迭代索引.md` | 2025-11-12T10:41:15.863Z |

package/skills/{aipk_requirements/documentation → aipk_requirements-documentation}/SKILL.md

@@ -1,11 +1,11 @@
 ---
-name: requirements-documentation
-description: Create new requirement documents or iterate on existing ones from scratch. Use this ONLY when the task involves drafting brand-new requirement documents or conducting requirement reviews WITHOUT starting from design assets. If the task involves updating requirements from design mockups or modifying docs based on visual designs, use the design/update-requirements-from-design skill instead.
+name: aipk_requirements-documentation
+description: Create new requirement documents or iterate on existing ones from scratch. Use this ONLY when the task involves drafting brand-new requirement documents or conducting requirement reviews WITHOUT starting from design assets. If the task involves updating requirements from design mockups or modifying docs based on visual designs, use the `skills/update-requirements-from-design` skill instead.
 ---
 
 # 需求文档与迭代模板指南
 
-**重要区分**：本 Skill 用于**从零开始创建**需求文档或对现有文档进行**纯文本层面的迭代**。如果任务涉及"基于设计图更新需求"、"根据视觉稿修改需求文档"或任何从设计资产开始的流程，请使用 **design/update-requirements-from-design** skill 而不是本 skill。
+**重要区分**：本 Skill 用于**从零开始创建**需求文档或对现有文档进行**纯文本层面的迭代**。如果任务涉及"基于设计图更新需求"、"根据视觉稿修改需求文档"或任何从设计资产开始的流程，请使用 **`skills/update-requirements-from-design`** skill 而不是本 skill。
 
 ## 执行指南
 
@@ -20,13 +20,13 @@ description: Create new requirement documents or iterate on existing ones from s
   - 基于已有的需求文档进行纯文本迭代（不涉及设计图变更）
   - 进行需求评审或变更管理（文档层面）
 
-- **使用 design/update-requirements-from-design Skill 的场景**：
+- **使用 `skills/update-requirements-from-design` Skill 的场景**：
   - 任务中提到"基于设计图更新需求"、"根据视觉稿修改需求"
   - 收到合成设计图（多屏拼板）需要切分
   - 需要批量更新需求文档中的插图
   - 需要同步设计变更到需求文档
 
-**如果你的任务涉及设计图处理 → 立即停止，转到 design/update-requirements-from-design skill**
+**如果你的任务涉及设计图处理 → 立即停止，转到 `skills/update-requirements-from-design` skill**
 
 ### 执行原则
 
@@ -40,7 +40,7 @@ description: Create new requirement documents or iterate on existing ones from s
 
 **⚠️ 重要：在执行任何文档生成工作前，必须先完成模板选择确认**
 
-**关键前置检查**：请再次确认你的任务不是从设计图更新需求！如果你的任务中提到"设计图"、"视觉稿"、"mockup"、"切分设计图"等关键词，请立即停止，转向使用 **design/update-requirements-from-design** skill。
+**关键前置检查**：请再次确认你的任务不是从设计图更新需求！如果你的任务中提到"设计图"、"视觉稿"、"mockup"、"切分设计图"等关键词，请立即停止，转向使用 **`skills/update-requirements-from-design`** skill。
 
 Agent必须遵循以下流程：
 
@@ -141,7 +141,7 @@ Agent必须遵循以下流程：
 1. **文件夹结构初始化**（**必需** - 在执行任何文档生成前）
    - **目标**：确保文档存储结构完整，便于后续文档管理和组织
    - **执行步骤**：
-     - 检查并创建 `skills/aipk_requirements`（项目主仓库的规范位置），如需在单独项目中落地可在项目根目录下创建 `requirements/`
+    - 检查并创建 `skills/aipk_requirements-documentation`（项目主仓库的规范位置），如需在单独项目中落地可在项目根目录下创建 `requirements/`
      - 检查并创建版本文件夹（默认 `v1.0.0`）
      - **必须创建需求池**：创建 `v0.0.0` 文件夹作为需求池
      - 检查并创建版本文件夹下的子文件夹（`draft/`、`archived/`、`assets/`、`reference/`、`changes/`）
@@ -711,14 +711,14 @@ graph TD
 
 **目录结构示例**：
 
-**新结构（推荐）**：版本文件夹直接位于 `skills/aipk_requirements` 下
+**新结构（推荐）**：版本文件夹直接位于 `skills/aipk_requirements-documentation` 下
 
 **情况一：在 AI Product Kit 主仓库**
 
 ```
 项目根目录/
 ├── skills/
-│   └── aipk_requirements/
+│   └── aipk_requirements-documentation/
 │       ├── v0.0.0/                 # 需求池（暂未安排版本的需求）
 │       │   ├── draft/
 │       │   ├── archived/

package/skills/{aipk_requirements/documentation → aipk_requirements-documentation}/template/4.2_/345/205/263/351/224/256/347/225/214/351/235/242.md

@@ -125,7 +125,7 @@
 ##### 界面1：[界面名称]
 
 <!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
-**重要说明**：页面标题必须放在表格外部，作为表格的标题。表格包含两列：左侧是页面说明，右侧是设计图。如果设计图是线框图，使用`<pre><code>`包裹；如果是设计图文件，使用`<img>`标签。参考格式规范：`skills/aipk_design/format-requirement-pages-with-design/requirement-page-table-format.md`
+**重要说明**：页面标题必须放在表格外部，作为表格的标题。表格包含两列：左侧是页面说明，右侧是设计图。如果设计图是线框图，使用`<pre><code>`包裹；如果是设计图文件，使用`<img>`标签。参考格式规范：`skills/format-requirement-pages-with-design/requirement-page-table-format.md`
 <!-- ⚠️ 规范说明结束 ⚠️ -->
 
 **界面功能概述**：

package/skills/{aipk_requirements/documentation → aipk_requirements-documentation}/template//351/234/200/346/261/202/350/277/255/344/273/243/346/250/241/346/235/277.md

@@ -128,7 +128,7 @@ graph TD
 #### 3.1.1 [页面1名称]
 
 <!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
-**重要说明**：页面标题必须放在表格外部，作为表格的标题。表格包含两列：左侧是页面说明，右侧是设计图。如果设计图是线框图，使用`<pre><code>`包裹；如果是设计图文件，使用`<img>`标签。参考格式规范：`skills/aipk_design/format-requirement-pages-with-design/requirement-page-table-format.md`
+**重要说明**：页面标题必须放在表格外部，作为表格的标题。表格包含两列：左侧是页面说明，右侧是设计图。如果设计图是线框图，使用`<pre><code>`包裹；如果是设计图文件，使用`<img>`标签。参考格式规范：`skills/format-requirement-pages-with-design/requirement-page-table-format.md`
 <!-- ⚠️ 规范说明结束 ⚠️ -->
 
 <table>

package/skills/aipk_requirements-intake/GURU_AI.md

@@ -0,0 +1,14 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-17T11:14:53.954Z
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `examples/K12数学学习应用案例.md` | 2025-11-12T10:41:15.866Z |
+| `examples/电商平台优化案例.md` | 2025-11-12T10:41:15.866Z |
+| `references/Gemini_DeepResearch_工具链整合架构设计.md` | 2025-11-12T10:41:15.867Z |
+| `SKILL.md` | 2025-11-17T09:14:10.148Z |
+| `template/产品需求发现与验证模板.md` | 2025-11-12T10:41:15.867Z |
+| `template/市场机会评估与竞争分析模板.md` | 2025-11-12T10:41:15.867Z |
+| `template/技术方案评估与可行性分析模板.md` | 2025-11-12T10:41:15.867Z |
+| `template/深度用户行为与需求洞察模板.md` | 2025-11-12T10:41:15.868Z |