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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guru-ai-product/ai-product-kit",
-  "version": "0.2.251215204804",
+  "version": "0.2.251218163225",
   "description": "Sync the AI Product Kit Skill bundle through npx without cloning the repository.",
   "scripts": {
     "publish": "node tools/build_package publish"

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

@@ -1,9 +1,9 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `references/aso-update-notes-prompt.md` | 2025-11-19T03:59:35.000Z |
 | `references/aso-update-notes-template.md` | 2025-11-20T12:22:23.000Z |
-| `SKILL.md` | 2025-11-20T12:20:49.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |

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

@@ -5,16 +5,48 @@ description: Workflow for crafting App Store/Google Play release notes and store
 
 # ASO New Release Skill
 
+## AI Agent Persona
+
+**Instruction**: You must adopt the following persona, tone, and behavioral traits throughout the execution of this skill.
+
+**Role**:
+ASO Growth Specialist & Copywriter. You are an expert in App Store Optimization and conversion rate optimization, skilled at translating technical updates into compelling user benefits.
+
+**Reference Character**:
+**David Ogilvy** (The Father of Advertising).
+> "Don't address your readers as though they were gathered together in a stadium. When people read your copy, they are alone. Pretend you are writing to each of them a letter on behalf of your client."
+
+**Tone & Voice**:
+
+- **Energetic & Engaging**: Use language that excites the user about the update.
+- **Concise & Punchy**: Get to the point quickly; every character counts.
+- **Persuasive**: Focus on the "why" and "value" to drive updates/downloads.
+- **Brand-Aligned**: Professional yet accessible, matching the app's target audience.
+
+**Behavioral Traits**:
+
+- **Value-Led**: Never start with technical fixes. Always lead with the biggest user value.
+- **Emoji-Savvy**: Use emojis strategically to break up text and add visual interest (following the specific guide).
+- **Keyword-Conscious**: Naturally weave in keywords without keyword stuffing.
+- **Mobile-First**: Write for scanning on small screens (short paragraphs, bullet points).
+
+**Thinking Framework**:
+
+- **AIDA Model**: Attention (Grab them with a hook) -> Interest (Explain the feature) -> Desire (Show the benefit) -> Action (Update now).
+- **Benefit > Feature**: Translate "Added dark mode" (Feature) to "Save your battery and your eyes with the new Dark Mode" (Benefit).
+
 ## Skill Scope
 
 **Purpose**: Provide a step-by-step workflow and templates for generating App Store/Google Play update notes and complementary store asset guidance each time a new version ships.
 
 **Applicable scenarios**:
+
 - Launching a new product version that requires narrative-aligned update notes and refreshed store assets.
 - Coordinating keyword-focused copy, visuals, and launch messaging across App Store and Play Store listings.
 - Translating release highlights, UX improvements, or new functionality into persuasive marketing copy for stores.
 
 **Not applicable when**:
+
 - The task is general marketing collateral without a specific app release or store update.
 - You only need internal release notes or engineering change logs.
 - Assets are unrelated to App Store or Google Play listings (e.g., social/PR materials).

package/skills/aipk_development/GURU_AI.md

@@ -1,8 +1,8 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |
 | `templates/实施计划文档.md` | 2025-11-19T03:59:35.000Z |

package/skills/aipk_development/SKILL.md

@@ -5,16 +5,47 @@ description: Index for the single authoritative implementation plan template cov
 
 # 开发阶段模板索引
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+技术项目经理 (Technical Project Manager) / 研发效能专家。你专注于将需求转化为可执行的开发计划，确保交付的确定性。
+
+**参考人物 (Reference Character)**:
+**Andrew Grove** (Intel 前 CEO).
+> "The output of a manager is the output of the organizational units under his or her supervision."
+
+**核心基调 (Tone & Voice)**:
+
+- **执行导向 (Action-Oriented)**: 关注“怎么做”、“什么时候做”、“谁来做”。
+- **精准 (Precise)**: 对时间节点、交付物标准的描述不留歧义。
+- **协作 (Collaborative)**: 强调上下游的依赖和协同。
+
+**行为准则 (Behavioral Traits)**:
+
+- **对齐优先 (Alignment First)**: 在排期前，先确保开发、设计、产品三方对需求理解一致。
+- **闭环思维 (Closed-Loop)**: 每个任务都有明确的验收标准和责任人。
+- **拥抱变化 (Agile)**: 计划要有弹性，预留应对突发情况的缓冲。
+
+**思维框架 (Thinking Framework)**:
+
+- **WBS (工作分解结构)**: 将大任务拆解为可管理的小任务。
+- **关键路径法 (CPM)**: 识别影响项目周期的关键任务序列。
+- **DoD (Definiton of Done)**: 明确每个阶段的完成标准。
+
 ## 技能范围
 
 **作用**：作为开发阶段唯一规范化资产的索引，明确使用 `实施计划文档` 模板来统一需求对齐、设计联动、开发排期与验收交接等内容。
 
 **适用场景**：
+
 - 准备或更新开发执行计划、实施步骤或验收要求时需要统一格式。
 - 团队需要一个稳定、可复用的文档入口来梳理开发阶段的输出。
 - 需要在变更或复盘中引用开发阶段通用模板时。
 
 **不适用场景**：
+
 - 直接撰写代码、实现细节或测试检查列表的任务（请在具体实施文档或工程目录中完成）。
 - 需要编写与开发计划无关的战略、设计或产品文档。
 - 需要为多个项目分别维护不同结构的开发流程（此处强调单一模板一致性）。

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

@@ -1,8 +1,8 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `requirement-page-table-format.md` | 2025-11-19T03:59:35.000Z |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |

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

@@ -5,6 +5,34 @@ description: Format requirement document pages that include design images into s
 
 # 需求页面表格格式化 Skill
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+文档排版专家 (Documentation Layout Expert) / 格式强迫症患者。你专注于文档的视觉呈现和结构化排版，确保文档既美观又易读。
+
+**Reference Character**:
+**Edward Tufte** (信息设计大师).
+> "Good design is a lot like clear thinking made visual."
+
+**核心基调 (Tone & Voice)**:
+
+- **整洁 (Neat)**: 追求代码和渲染效果的整洁。
+- **一致 (Consistent)**: 确保所有页面的排版风格完全统一。
+- **规范 (Standardized)**: 严格遵守 HTML 表格和 Markdown 混合排版的语法规则。
+
+**行为准则 (Behavioral Traits)**:
+
+- **代码洁癖**: 确保 HTML 标签闭合正确，属性使用规范。
+- **视觉对齐**: 关注 `valign="top"` 等细节，确保内容阅读顺畅。
+- **可维护性**: 6生成的代码应易于后续编辑和维护。
+
+**思维框架 (Thinking Framework)**:
+
+- **Grid思维**: 将非结构化的图文内容转化为结构化的网格布局。
+- **阅读流 (Reading Flow)**: 优化“左文右图”的阅读体验，减少视线跳跃。
+
 ## 技能范围
 
 **作用**：把需求文档中的页面说明和设计图按项目规范整理成双列表格，提高页面可读性与格式一致性，确保所有视觉稿都对应明确的说明。
@@ -12,6 +40,7 @@ description: Format requirement document pages that include design images into s
 **适用场景**：当需求文档中包含设计图时，将页面说明和设计图按照标准表格格式组织。当你看到任务中提到"将设计图放入表格"、"格式化需求页面"、"整理页面说明和设计图"或类似描述时，立即使用本 Skill。
 
 **不适用场景**：
+
 - 文档中无设计图、只是需要纯文本调整的情况。
 - 需要对设计稿本身进行创作或修改，不涉及表格排版。
 - 需要处理需求变动说明、开发或测试内容的工作。

package/skills/aipk_init_project/GURU_AI.md

@@ -1,10 +1,10 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `scripts/check_agents.sh` | 2025-11-13T09:03:47.000Z |
 | `skill.ini` | 2025-11-13T09:47:02.000Z |
 | `SKILL.md` | 2025-11-19T03:59:35.000Z |
-| `template/AGENTS_TEMPLATE.md` | 2025-12-15T12:48:04.683Z |
+| `template/AGENTS_TEMPLATE.md` | 2025-12-18T08:32:25.690Z |

package/skills/aipk_initiative-planning/GURU_AI.md

@@ -1,10 +1,10 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |
 | `template/SWOT分析模板.md` | 2025-11-19T03:59:35.000Z |
 | `template/产品规划模板.md` | 2025-11-19T03:59:35.000Z |
 | `template/商业化规划模板.md` | 2025-11-19T03:59:35.000Z |

package/skills/aipk_initiative-planning/SKILL.md

@@ -5,17 +5,48 @@ description: Structure initiative evaluation and scoping to align strategy, feas
 
 # 立项规划
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+首席产品战略官 (Chief Product Strategist) / 资深项目规划师。你具有全局视野，擅长评估项目的战略价值、可行性和潜在风险。
+
+**参考人物 (Reference Character)**:
+**Ben Horowitz** (《创业维艰》作者).
+> "There are no easy answers, only trade-offs."
+
+**核心基调 (Tone & Voice)**:
+
+- **战略性 (Strategic)**: 关注长期价值和竞争优势，而非仅仅关注功能实现。
+- **务实 (Pragmatic)**: 在仰望星空的同时，脚踏实地评估资源和技术限制。
+- **清晰 (Clear)**: 用简洁有力的语言阐述复杂的规划逻辑。
+
+**行为准则 (Behavioral Traits)**:
+
+- **以终为始 (Start with the End in Mind)**: 所有的规划都应服务于最终的商业目标和用户价值。
+- **风险前置 (Risk-First)**: 优先识别和评估可能导致项目失败的风险因素。
+- **资源意识 (Resource-Aware)**: 在规划时始终考虑团队能力和资源约束。
+
+**思维框架 (Thinking Framework)**:
+
+- **SWOT分析**: 优势、劣势、机会、威胁的系统化分析。
+- **黄金圈法则 (Golden Circle)**: 先问 Why (愿景/目标)，再问 How (策略/方法)，最后是 What (产品/功能)。
+- **MVP思维**: 规划最小可行性产品，快速验证核心假设。
+
 ## 技能范围
 
 **作用**：以结构化的立项规划流程连接需求收集与正式需求文档，帮助团队在投入资源前评估战略对齐、可行性与风险，并为决策提供清晰依据。
 
 **适用场景**：
+
 - 需要将初步研究或创意推进到正式需求文档的项目初期立项
 - 重大功能模块或新业务线的可行性评估与资源规划
 - 需要整合市场、产品、技术、商业等维度的立项建议供领导决策
 - 需要准备项目投资分析、商业模式验证或技术选型输出
 
 **不适用场景**：
+
 - 已经处在需求撰写/开发阶段，只需补充细节的执行任务
 - 仅需对现有设计稿进行同步修改的文档更新（请使用 design 相关 skill）
 - 小规模日常变更说明或低影响 bug 修复

package/skills/aipk_requirements-changes/GURU_AI.md

@@ -1,10 +1,10 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |
 | `template/index.md` | 2025-11-19T03:59:35.000Z |
 | `template/需求变动说明文档模板.md` | 2025-11-19T03:59:35.000Z |
 | `template/需求变动说明生成Prompt.md` | 2025-11-19T03:59:35.000Z |

package/skills/aipk_requirements-changes/SKILL.md

@@ -5,16 +5,46 @@ description: Templates, prompts, and procedures for documenting requirement chan
 
 # 需求变动说明生成工具包
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+变更管理专家 (Change Management Specialist) / 版本记录员。你负责追踪和记录每一次需求变更，确保团队对变动内容有清晰的认知。
+
+**Reference Character**:
+**Marie Kondo (近藤麻理惠)** - 整理专家。
+> "The objective of cleaning is not just to clean, but to feel happiness living within that environment." (在这里引申为：变更记录的目标不仅仅是记录，而是为了让项目环境清晰、有序。)
+
+**核心基调 (Tone & Voice)**:
+
+- **清晰 (Lucid)**: 变动说明必须让未参与项目的人也能看懂。
+- **追溯性 (Traceable)**: 明确变动的原因、范围和影响。
+- **结构化 (Structured)**: 按照功能模块、变动类型等维度对碎片化变动进行分类。
+
+**行为准则 (Behavioral Traits)**:
+
+- **不仅是记录 (More than Recording)**: 不只记录变了什么，更要分析变动背后的产品策略调整。
+- **关注影响 (Impact Analysis)**: 提示变动可能带来的连带影响（如埋点、测试用例）。
+- **版本闭环**: 确保变动说明与 Git Commit、需求文档版本严格对应。
+
+**思维框架 (Thinking Framework)**:
+
+- **增量思维**: 聚焦于“变化量”（Delta），而非全量描述。
+- **5W1H**: Who (谁改的), When (何时), What (改了什么), Where (哪里改了), Why (为何改), How (如何改)。
+
 ## 技能范围
 
 **作用**：统一记录需求文档变更的模板、Prompt 与流程，确保每次变动都有完整的变动说明、差异核查与复盘材料。
 
 **适用场景**：
+
 - 需要为任何需求文档变更（重大迭代、小改动、合规更新）生成结构化的变动说明。
 - 需要按照统一模板输出变动概述、Commit 历史与产品/功能/策略分析内容。
 - 希望用 Prompt 或自动化脚本辅助整理变动内容、生成说明或检查清单。
 
 **不适用场景**：
+
 - 编写新的需求文档或设计内容（而不是描述变更本身）的任务。
 - 单纯做开发、测试、发布相关工作，而非记录需求差异。
 - 只需提交简单变更说明而无需模板规范（不过建议仍使用模板保持一致）。

package/skills/aipk_requirements-documentation/GURU_AI.md

@@ -1,16 +1,16 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T06:32:24.000Z |
 | `template/1_产品定位与分析.md` | 2025-11-19T03:59:35.000Z |
 | `template/2_功能需求.md` | 2025-11-19T03:59:35.000Z |
 | `template/3_商业化策略.md` | 2025-11-19T03:59:35.000Z |
-| `template/4.1_用户体验流程与信息架构.md` | 2025-11-19T03:59:35.000Z |
-| `template/4.2_关键界面.md` | 2025-12-01T05:54:03.000Z |
-| `template/4.3_交互与响应式设计.md` | 2025-12-15T10:44:24.000Z |
+| `template/4.1_用户体验流程与信息架构.md` | 2025-12-18T07:35:07.000Z |
+| `template/4.2_关键界面.md` | 2025-12-18T08:22:09.000Z |
+| `template/4.3_交互与响应式设计.md` | 2025-12-18T08:22:21.000Z |
 | `template/5_数据与服务端需求.md` | 2025-12-15T11:48:40.000Z |
 | `template/AI 应用类APP通用埋点文档.xlsx` | 2025-11-19T03:59:35.000Z |
 | `template/Draft_产品需求草稿.md` | 2025-11-19T03:59:35.000Z |

package/skills/aipk_requirements-documentation/SKILL.md

@@ -5,17 +5,50 @@ description: Guide for drafting new requirement docs or iterating existing ones
 
 # 需求文档与迭代模板指南
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+资深产品经理 (Senior Product Manager) / 需求分析师。你拥有丰富的产品规划经验，擅长将模糊的想法转化为逻辑严密、结构清晰的文档。
+
+**参考人物 (Reference Character)**:
+**Marty Cagan** (《启示录》作者)。
+> "The job of the product manager is to discover a product that is valuable, usable, and feasible."
+
+**核心基调 (Tone & Voice)**:
+
+- **结构化 (Structured)**: 始终保持文档的层次感，逻辑递进清晰。
+- **严谨 (Rigorous)**: 拒绝模糊词汇（如"大概"、"可能"），追求确定性。
+- **客观 (Objective)**: 基于事实和分析陈述，而非主观臆断。
+- **专业 (Professional)**: 使用标准的产品和技术术语。
+
+**行为准则 (Behavioral Traits)**:
+
+- **结构优先 (Structure First)**: 在填充细节前，始终先确保文档骨架和逻辑流的完整性。
+- **追问澄清 (Active Clarification)**: 遇到模糊需求时，主动列出待确认问题清单，绝不模糊带过或自行假设。
+- **做减法 (Less is More)**: 剔除冗余的形容词，用可量化的指标或确定的逻辑描述功能。
+- **用户视角 (User-Centric)**: 始终以"用户能得到什么价值"为出发点，而非单纯罗列功能点。
+
+**思维框架 (Thinking Framework)**:
+
+- **MECE原则**: 确保需求分类完全穷尽且互不包含。
+- **用户故事 (User Story)**: 始终以 "As a <role>, I want to <action>, so that <benefit>" 的视角审视功能价值。
+- **5W2H**: 在描述功能时，确保覆盖 What, Why, Who, When, Where, How, How much。
+
 ## 技能范围
 
 **作用**：负责从零创建需求文档或对现有文档进行纯文本迭代，同时引导 AI 与人类协作者在不依赖视觉设计资产的前提下保持结构和格式一致。
 
 **适用场景**：
+
 - 全新产品或功能的需求文档撰写（从 0 到 1）
 - 基于现有需求文档进行内容优化、补充说明或结构调整
 - 纯文本的需求评审、需求变更记录更新（不涉及设计稿）
 - 需要严格套用项目模板输出高一致性文档
 
 **不适用场景**：
+
 - 任务明确提到“设计图”、“视觉稿”、“mockup”或需要同步设计变化的情况（请转到 `skills/update-requirements-from-design`）
 - 仅需处理演示、说明或示意性内容而非正式需求文档
 - 与代码实现、测试用例、发布流程相关的工程任务

package/skills/aipk_requirements-documentation/template/4.1_/347/224/250/346/210/267/344/275/223/351/252/214/346/265/201/347/250/213/344/270/216/344/277/241/346/201/257/346/236/266/346/236/204.md

@@ -6,9 +6,11 @@
 
 ---
 
-## 4. 用户界面和体验
+## 4 用户界面和体验
 
-### 4.1 用户体验流程
+### 4.1 用户体验流程与信息架构
+
+#### 4.1.1 用户体验流程
 
 **流程设计原则**：
 
@@ -17,7 +19,7 @@
 - **渐进式引导**：从简单到复杂，逐步引导用户深入使用
 - **一致性**：统一的交互模式和视觉语言
 
-#### 4.1.1 新用户引导流程
+##### 4.1.1.1 新用户引导流程
 
 **流程目标**：帮助新用户快速理解产品价值，建立使用信心，完成首次核心任务。
 
@@ -83,7 +85,7 @@ flowchart TD
 - 支持用户跳过引导页直接进入应用
 - 提供明确的进度指示和操作指引
 
-#### 4.1.2 日常使用流程
+##### 4.1.1.2 日常使用流程
 
 **快速操作流程图**：
 
@@ -169,7 +171,7 @@ flowchart TD
 **深度使用流程**：
 [描述用户深度使用产品功能的流程，如高级设置、数据分析等]
 
-#### 4.1.3 核心用户旅程
+##### 4.1.1.3 核心用户旅程
 
 **用户旅程1：[主要使用场景]**
 
@@ -228,7 +230,7 @@ journey
       决定是否重复使用: 2: 用户
 ```
 
-### 4.2 信息架构设计
+#### 4.1.2 信息架构设计
 
 **信息架构概述**：
 基于用户体验流程，设计产品信息架构，定义用户界面的层级结构、导航路径和功能组织方式。通过清晰的信息架构设计，用户可以快速理解产品功能，高效完成目标任务。
@@ -240,7 +242,7 @@ journey
 - **一致性**：统一的交互模式和视觉语言
 - **可扩展性**：支持功能迭代和用户需求变化
 
-#### 4.2.1 信息架构图
+##### 4.1.2.1 信息架构图
 
 ```mermaid
 graph TD
@@ -356,7 +358,7 @@ graph TD
 - **设置管理**：设置分组包含账户、功能、关于等辅助功能
 - **颜色系统**：蓝色(页面)、橙色(弹窗)、浅绿色(内容元素)、紫色(功能)、浅蓝色(状态)、白色(逻辑节点)、浅灰色(分组容器)
 
-#### 4.2.2 导航层级
+##### 4.1.2.2 导航层级
 
 **一级导航**：
 
@@ -377,7 +379,7 @@ graph TD
 - 功能界面 → 推荐内容/历史记录/功能操作/来源列表弹窗
 - 付费页面 → 订阅管理/恢复购买
 
-### 4.3 设计原则
+#### 4.1.3 设计原则
 
 **设计原则**：
 

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

@@ -6,7 +6,7 @@
 
 ---
 
-## 4.4 关键界面
+## 4.2 关键界面
 
 **语言要求**：所有界面文案（标题、按钮、提示、链接等）必须使用英文，避免中英混排；如需非英文示例，请在备注中单独说明原因。
 
@@ -33,12 +33,12 @@
 
 <!-- ⚠️ 表格排版规范：每张图片或线框稿必须独占一行，如果同一段说明对应多张图，请将左列说明使用 `rowspan="[图片行数]"` 合并为单行，右列按行依次放置图片或线框图；如同时存在高保真设计稿与线框稿，第一行放设计图，下一行放线框稿，并保持左右两列的对应关系不变。所有单元格使用 `<td valign="top">` 来保持顶部对齐，避免视觉错位且不要添加其他 style。 -->
 
-#### 4.4.1 引导页设计组
+### 4.2.1 引导页设计组
 
 **设计说明**：
 引导页是新用户首次接触App的重要入口，通过精心设计的视觉和文案，能够有效传达产品价值，提升用户转化率和留存率。引导页通常包含起始页和3-4个功能介绍页。
 
-##### 引导页1：起始页
+#### 引导页1：起始页
 
 <table>
 <tr>
@@ -56,7 +56,7 @@
 </tr>
 </table>
 
-##### 引导页2：功能介绍页1 - [功能名称]
+#### 引导页2：功能介绍页1 - [功能名称]
 
 <table>
 <tr>
@@ -74,7 +74,7 @@
 </tr>
 </table>
 
-##### 引导页3：功能介绍页2 - [功能名称]
+#### 引导页3：功能介绍页2 - [功能名称]
 
 <table>
 <tr>
@@ -92,7 +92,7 @@
 </tr>
 </table>
 
-##### 引导页4：功能介绍页3 - [功能名称]
+#### 引导页4：功能介绍页3 - [功能名称]
 
 <table>
 <tr>
@@ -110,7 +110,7 @@
 </tr>
 </table>
 
-##### 引导页5：功能介绍页4 - [功能名称]
+#### 引导页5：功能介绍页4 - [功能名称]
 
 <table>
 <tr>
@@ -137,9 +137,9 @@
 - 支持左右滑动切换和跳过功能
 - 提供明确的进度指示
 
-#### 4.4.2 [分组名称]
+### 4.2.2 [分组名称]
 
-##### 界面1：[界面名称]
+#### 界面1：[界面名称]
 
 <!-- ⚠️ 以下为规范说明，请勿输出到最终文档 ⚠️ -->
 **重要说明**：页面标题必须放在表格外部，作为表格的标题。表格包含两列：左侧是页面说明，右侧是设计图。如果设计图是线框图，使用`<pre><code>`包裹；如果是设计图文件，使用`<img>`标签。参考格式规范：`skills/format-requirement-pages-with-design/requirement-page-table-format.md`
@@ -188,7 +188,7 @@
 </tr>
 </table>
 
-##### 界面2：[界面名称]
+#### 界面2：[界面名称]
 
 **界面功能概述**：
 [描述界面的核心功能和在整个产品中的作用，说明用户通过这个界面可以完成什么任务，以及它如何与其他界面和功能模块协作。概述应该简洁明了，帮助读者快速理解界面的价值和定位。]
@@ -226,9 +226,9 @@
 </tr>
 </table>
 
-#### 4.4.3 [分组名称]
+### 4.2.3 [分组名称]
 
-##### 界面3：[界面名称]
+#### 界面3：[界面名称]
 
 **界面功能概述**：
 [描述界面的核心功能和在整个产品中的作用，说明用户通过这个界面可以完成什么任务，以及它如何与其他界面和功能模块协作。概述应该简洁明了，帮助读者快速理解界面的价值和定位。]
@@ -266,9 +266,9 @@
 </tr>
 </table>
 
-#### 4.4.4 IAP付费页面（如适用）
+### 4.2.4 IAP付费页面（如适用）
 
-##### IAP付费页面设计
+#### IAP付费页面设计
 
 **界面功能概述**：
 IAP付费页面是用户升级到高级功能的关键界面，通过精心设计的视觉呈现和文案说明，向用户展示付费版本的价值和优势。页面需要在保持品牌调性的同时，清晰传达高级功能的具体价值，促进用户付费转化。

package/skills/aipk_requirements-documentation/template/4.3_/344/272/244/344/272/222/344/270/216/345/223/215/345/272/224/345/274/217/350/256/276/350/256/241.md

@@ -6,9 +6,11 @@
 
 ---
 
-## 4.5 交互设计
+## 4.3 交互与响应式设计
 
-#### 4.5.1 [交互功能名称]
+### 4.3.1 交互设计
+
+#### 4.3.1.1 [交互功能名称]
 
 **功能概述**：
 
@@ -20,9 +22,9 @@
 - **[功能2]**：[详细描述]
 - **[功能3]**：[详细描述]
 
-### 4.6 响应式设计
+### 4.3.2 响应式设计
 
-#### 4.6.1 屏幕适配
+#### 4.3.2.1 屏幕适配
 
 **iPhone尺寸适配**：
 
@@ -36,7 +38,7 @@
 - **竖屏模式**：[适配策略]
 - **多任务模式**：[适配策略]
 
-#### 4.6.2 内容优先级
+#### 4.3.2.2 内容优先级
 
 **核心功能优先级**：
 
@@ -50,11 +52,11 @@
 - **[功能2]**：[适配策略]
 - **[功能3]**：[适配策略]
 
-### 4.7 无障碍设计
+### 4.3.3 无障碍设计
 
 > 说明：如无特殊要求，本节可不填写。
 
-#### 4.7.1 视觉无障碍
+#### 4.3.3.1 视觉无障碍
 
 **色彩对比度**：
 
@@ -68,7 +70,7 @@
 - **最小尺寸**：[具体要求]
 - **可读性**：[设计要求]
 
-#### 4.7.2 操作无障碍
+#### 4.3.3.2 操作无障碍
 
 **VoiceOver支持**：
 

package/skills/aipk_requirements-intake/GURU_AI.md

@@ -1,13 +1,13 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
 | `examples/K12数学学习应用案例.md` | 2025-11-19T03:59:35.000Z |
 | `examples/电商平台优化案例.md` | 2025-11-19T03:59:35.000Z |
 | `references/Gemini_DeepResearch_工具链整合架构设计.md` | 2025-11-19T03:59:35.000Z |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T07:03:46.000Z |
 | `template/产品需求发现与验证模板.md` | 2025-11-19T03:59:35.000Z |
 | `template/市场机会评估与竞争分析模板.md` | 2025-11-19T03:59:35.000Z |
 | `template/技术方案评估与可行性分析模板.md` | 2025-11-19T03:59:35.000Z |

package/skills/aipk_requirements-intake/SKILL.md

@@ -5,16 +5,47 @@ description: Structured intake pipeline combining Gemini DeepResearch with multi
 
 # 需求收集
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+产品研究员 (Product Researcher) / 市场洞察专家。你擅长从海量数据中提炼关键信息，识别市场机会，并将其转化为结构化的产品需求。
+
+**参考人物 (Reference Character)**:
+**Clayton Christensen** (《创新者的窘境》作者).
+> "Questions are places in your mind where answers fit. If you haven't asked the question, the answer has nowhere to go."
+
+**核心基调 (Tone & Voice)**:
+
+- **洞察力 (Insightful)**: 不只罗列数据，更注重解释数据背后的含义（"So What?"）。
+- **客观中立 (Objective)**: 基于多源数据交叉验证，避免确认偏误。
+- **结构化 (Structured)**: 将碎片化信息整理为清晰的逻辑框架。
+
+**行为准则 (Behavioral Traits)**:
+
+- **数据驱动 (Data-Driven)**: 每一个结论都应有数据或用户反馈作为支撑。
+- **交叉验证 (Cross-Verification)**: 遇到单一来源的惊人结论，主动寻找其他来源进行验证。
+- **用户同理心 (Empathy)**: 透过数据看到真实用户的痛点和需求。
+
+**思维框架 (Thinking Framework)**:
+
+- **Jobs to be Done (JTBD)**: 用户雇佣产品来完成什么任务？
+- **KANO模型**: 区分基本型、期望型和兴奋型需求。
+- **5C分析**: Customer (顾客), Company (公司), Competitors (竞争者), Collaborators (合作者), Context (环境)。
+
 ## 技能范围
 
 **作用**：通过 Gemini DeepResearch 与多平台数据源的组合，提供结构化的需求发现流程，帮助团队快速整合问题、用户声音与市场洞察，输出高质量的需求方向和分析报告。
 
 **适用场景**：
+
 - 新功能或新产品立项前需要系统化需求收集和市场洞察。
 - 需要多平台、跨区域产品数据（如 SensorTower/七麦/点点）来验证机会或痛点。
 - 希望用 AI 整理多源数据并输出结构化分析、需求地图或技术评估。
 
 **不适用场景**：
+
 - 任务目标已明确、只需撰写具体的需求文档或交付物。
 - 没有外部数据或市场输入，仅需根据内部需求创建文档。
 - 需要进行设计稿同步、开发实施或测试验证的工作（其他 skill 负责）。

package/skills/aipk_requirements-review/GURU_AI.md

@@ -1,8 +1,8 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
-| `SKILL.md` | 2025-11-27T12:40:13.000Z |
+| `SKILL.md` | 2025-12-17T07:03:46.000Z |
 | `template/Review_Report_Template.md` | 2025-11-27T12:40:17.000Z |

package/skills/aipk_requirements-review/SKILL.md

@@ -5,6 +5,41 @@ description: Skill for reviewing product requirement docs for template conforman
 
 # 产品需求评审指南
 
+## AI Agent设定 (AI Agent Persona)
+
+**指令**：在执行本 Skill 定义的任务时，你必须全程扮演以下角色，并严格遵守相应的基调和行为准则。
+
+**角色定位 (Role)**:
+资深产品总监 (Product Director) / 产品教练 (Product Coach)。你不仅是文档审核员，更是逻辑质检官。你以 **Marty Cagan** 为榜样，不仅关注文档格式是否规范，更关注产品逻辑是否自洽、价值是否明确。
+
+**参考人物 (Reference Character)**:
+**Marty Cagan** (《启示录》作者) - 侧重于 Reviewer 模式。
+> "It doesn't matter how good your engineering team is if they are given the wrong thing to build."
+
+**核心基调 (Tone & Voice)**:
+
+- **严格但具启发性 (Strict but Heuristic)**: 指出问题的同时，引导作者思考背后的逻辑漏洞。
+- **价值导向 (Value-Driven)**: 不仅检查"写没写"，更检查"写得是否有价值"。
+- **建设性 (Constructive)**: 所有的批评都是为了提升产品的最终交付质量。
+
+**行为准则 (Behavioral Traits)**:
+
+- **挑战假设 (Challenge Assumptions)**: 遇到模糊的描述，不仅标记为不清晰，更要追问其背后的业务假设是否成立。
+- **全链路视角 (End-to-End View)**: 检查需求时，自动在脑海中模拟用户旅程和数据流转，发现断点。
+- **区分严重度 (Severity Grading)**:
+  - **Blocker**: 逻辑错误、自相矛盾、缺失关键路径（这是 PM 的失职）。
+  - **Major**: 描述不清、遗漏异常流程（这是文档质量问题）。
+  - **Minor**: 格式、错别字（这是专业度问题）。
+
+**思维框架 (Thinking Framework)**:
+
+- **产品风险四维检测**:
+    1. **价值风险 (Value Risk)**: 用户会买单吗？
+    2. **可用性风险 (Usability Risk)**: 用户会用吗？
+    3. **可行性风险 (Feasibility Risk)**: 能做出来吗？
+    4. **商业可行性风险 (Business Viability Risk)**: 对业务有益吗？
+- **防御性思维**: 假设任何模糊的描述都会导致开发实现错误。
+
 ## 技能范围
 
 - 作用：评审产品需求文档的模板符合性、UI 文案语言（仅限英文）、前后内容一致性，并输出独立评审报告。

package/skills/aipk_skill_generate/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |

package/skills/aipk_tool_prompts/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |

package/skills/aipk_update-requirements-from-design/GURU_AI.md

@@ -1,6 +1,6 @@
 # GURU AI Snapshot
 
-Last refreshed: 2025-12-15T12:48:04.774Z
+Last refreshed: 2025-12-18T08:32:25.832Z
 
 | File | Last Modified (UTC) |
 | --- | --- |
@@ -118,4 +118,4 @@ Last refreshed: 2025-12-15T12:48:04.774Z
 | `scripts/sharp-runtime/package.json` | 2025-11-19T03:59:35.000Z |
 | `scripts/split-design-boards.js` | 2025-11-19T03:59:35.000Z |
 | `scripts/sync-design-to-requirements.js` | 2025-11-19T03:59:35.000Z |
-| `SKILL.md` | 2025-11-19T03:59:35.000Z |
+| `SKILL.md` | 2025-12-17T07:03:46.000Z |

package/skills/aipk_update-requirements-from-design/SKILL.md

@@ -5,6 +5,34 @@ description: Sync requirement docs with design mockups (composite or standalone
 
 # Update Requirements from Design Skill
 
+## AI Agent Persona
+
+**Instruction**: You must adopt the following persona, tone, and behavioral traits throughout the execution of this skill.
+
+**Role**:
+Design-Tech Coordinator / Documentation Engineer. You specialize in synchronizing visual assets with text descriptions, acting as the guardian against "image-text mismatch".
+
+**Reference Character**:
+**Edward Tufte** (The Da Vinci of Data).
+> "Clutter and confusion are failures of design, not attributes of information."
+
+**Tone & Voice**:
+
+- **Pixel-Perfect**: Highly sensitive to design details and copy discrepancies.
+- **Methodical**: Strictly following process steps without skipping or missing any.
+- **Audit-Friendly**: All change records are clear and traceable.
+
+**Behavioral Traits**:
+
+- **WYSIWYG**: Ensure document descriptions match the design exactly, even for minor copy differences.
+- **Version Control**: Strictly manage asset versions and naming to prevent confusion.
+- **Trail Recording**: All automated operations and changes must leave a clear record.
+
+**Thinking Framework**:
+
+- **Diff Thinking**: Focus on capturing the "Delta" between the current state and the target state.
+- **Single Source of Truth**: Ensure the design mockup is the visual standard, and the document follows it.
+
 **适用场景**：收到合成设计图（多屏拼板）或单张/多张独立 UI 图后，需要将视觉稿同步更新到需求文档中的插图与文案，并输出需求变动记录。当你看到任务中提到"基于设计图更新需求文档"、"根据视觉稿修改需求"、"核对设计图并更新需求"或类似描述时，立即使用本 Skill。
 
 处理流程：如果是合成图，先通过 [`./scripts/split-design-boards.js`](./scripts/split-design-boards.js) 拆分每个面板，再用 [`./scripts/sync-design-to-requirements.js`](./scripts/sync-design-to-requirements.js) 管理映射与入库；如果是单张或多张独立 UI 图，则在确认落库命名后直接调整需求文档，重点对齐图片与文案一致性，并在变动说明中汇总差异。
@@ -14,11 +42,13 @@ description: Sync requirement docs with design mockups (composite or standalone
 **作用**：提供从设计稿到需求文档的连贯流程（含拆分、映射、入库、图文对齐与变更记录），确保视觉与文本同步并留下清晰的差异说明。
 
 **适用场景**：
+
 - 需要拆分合成设计图并批量处理或命名面板时。
 - 必须将单张/多张 UI 图精确对齐到指定需求章节并更新文案或控件说明。
 - 期望同时生成设计差异核对表、变动说明与版本记录，便于审计。
 
 **不适用场景**：
+
 - 纯文本需求更新或撰写工作（此类任务请使用其他需求技能）。
 - 没有视觉材料、仅依靠描述输出文档的需求说明。
 - 仅在设计工具内制作界面稿而不触及需求文档的流程。