@guru-ai-product/ai-product-kit 0.1.251112172507

package/skills/aipk_skill_generate/SKILL.md

@@ -0,0 +1,259 @@
+---
+name: skill-creation
+description: Standards and methods for creating Agent Skills that extend Claude's capabilities. Use when creating or updating Skills, rules, or documentation that should follow Skill structure.
+---
+
+# Skill 创建方法
+
+## 1. 技能定位
+
+- **适用场景**：创建新的 Agent Skills、将现有文档转换为 Skill 格式、更新项目规则文档
+- **目标人群**：文档撰写者、项目管理者、规则维护者
+- **价值主张**：提供标准化的 Skill 创建规范，确保所有规则和文档遵循统一的 Skill 结构，实现模块化和可重用性
+
+## 2. 快速上手
+
+1. 创建 Skill 目录，目录名与 Skill 名称一致（小写字母、数字和连字符）
+2. 在目录中创建 `SKILL.md` 文件
+3. 添加 YAML frontmatter，包含 `name` 和 `description` 字段
+4. 按照标准章节结构编写 Markdown 内容
+5. 可选：添加额外的资源文件（模板、脚本、参考文档等）
+
+## 3. Skill 结构规范
+
+### 3.1 必需的文件结构
+
+每个 Skill 必须包含一个 `SKILL.md` 文件，作为 Skill 的入口点：
+
+```
+my-skill/
+  - SKILL.md
+```
+
+更复杂的 Skill 可以添加额外的目录和文件：
+
+```
+my-skill/
+  ├── SKILL.md (主入口文件)
+  ├── template/
+  │   └── example.md (模板文件)
+  ├── examples/
+  │   └── usage.md (使用示例)
+  └── scripts/
+      └── helper.py (辅助脚本)
+```
+
+### 3.2 SKILL.md 文件格式
+
+#### YAML Frontmatter（必需）
+
+```yaml
+---
+name: your-skill-name
+description: 简洁描述技能覆盖的场景、可交付物以及使用时机。
+license: 可选，若需声明许可或合规信息则填写
+metadata:
+  owner: 团队或负责人
+  version: v1.0.0
+---
+```
+
+**必需字段**：
+
+- `name`：
+  - Skill 名称，使用连字符命名（hyphen-case）
+  - 仅包含小写字母、数字和连字符
+  - 最大 64 个字符
+  - 不能包含 XML 标签
+  - 不能包含保留词："anthropic", "claude"
+  - 必须与包含 SKILL.md 的目录名称匹配
+
+- `description`：
+  - 简要描述 Skill 的功能和使用时机
+  - 必须非空
+  - 最大 1024 个字符
+  - 不能包含 XML 标签
+  - 应说明 Skill 做什么以及何时使用
+
+**可选字段**：
+
+- `license`：许可信息（简短形式或指向许可文件的名称）
+- `allowed-tools`：预批准运行的工具列表（目前仅在 Claude Code 中支持）
+- `metadata`：键值对映射，用于存储客户端自定义属性
+
+#### Markdown 正文
+
+Markdown 正文部分没有格式限制，但建议遵循项目的文档撰写标准（参见 [`../../docs/guide_writing_standard/SKILL.md`](../../docs/guide_writing_standard/SKILL.md)）。
+
+**推荐章节结构**：
+
+```markdown
+# 技能主标题
+
+## 1. 技能定位
+- **适用场景**：列出该技能最核心的使用场景
+- **目标人群**：说明主要使用角色
+- **价值主张**：突出该技能解决的痛点或提供的能力
+
+## 2. 快速上手
+1. 步骤一…
+2. 步骤二…
+3. 步骤三…
+
+## 3. 标准流程
+| 阶段 | 说明 | 交付物 |
+| ---- | ---- | ------ |
+| 规划 | …    | …      |
+| 执行 | …    | …      |
+| 检查 | …    | …      |
+
+## 4. AI 协作要点
+- 使用的模型或工具
+- 推荐的 Prompt
+- 自动化检查或输出格式要求
+
+## 5. 附加资源
+- [模板链接](./template/示例模板.md)
+- [最佳实践](./examples/XXX.md)
+- [常见问题](./references/FAQ.md)
+```
+
+## 4. Skill 工作原理
+
+### 4.1 三级加载机制
+
+Skills 采用渐进式加载（progressive disclosure），内容在三个层级加载：
+
+**Level 1: 元数据（始终加载）**
+
+- 内容类型：指令
+- 加载时机：启动时
+- Token 成本：约 100 tokens 每个 Skill
+- 内容：YAML frontmatter 中的 `name` 和 `description`
+
+**Level 2: 指令（触发时加载）**
+
+- 内容类型：指令
+- 加载时机：Skill 被触发时
+- Token 成本：通常低于 5k tokens
+- 内容：SKILL.md 的主体内容，包含工作流程、最佳实践和指导
+
+**Level 3: 资源和代码（按需加载）**
+
+- 内容类型：指令、代码和资源
+- 加载时机：需要时
+- Token 成本：有效无限制（通过 bash 执行，不加载到上下文）
+- 内容：其他 Markdown 文件、可执行脚本、参考材料
+
+### 4.2 文件系统架构
+
+Skills 运行在代码执行环境中，Claude 具有文件系统访问、bash 命令和代码执行能力。Skills 作为目录存在于虚拟机上，Claude 使用 bash 命令与之交互。
+
+**优势**：
+
+- **按需文件访问**：Claude 只读取任务需要的文件
+- **高效的脚本执行**：脚本代码不加载到上下文窗口，只输出消耗 tokens
+- **无实际限制的捆绑内容**：未使用的文件不消耗上下文
+
+## 5. 创建 Skill 的最佳实践
+
+### 5.1 命名规范
+
+- 使用小写字母、数字和连字符
+- 名称应简洁且描述性强
+- 避免使用保留词
+
+### 5.2 描述编写
+
+描述应清晰说明：
+
+- Skill 的功能
+- 使用场景
+- 何时应该触发该 Skill
+
+示例：
+
+```yaml
+description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
+```
+
+### 5.3 内容组织
+
+- **主文件（SKILL.md）**：包含核心指导和快速上手
+- **附加文件**：将详细参考、模板、示例放在单独文件中
+- **脚本**：将可执行代码放在 scripts/ 目录下
+
+### 5.4 安全性考虑
+
+- 仅使用可信来源的 Skills
+- 审计所有捆绑的文件（SKILL.md、脚本、图像、其他资源）
+- 注意外部数据源的风险
+- 谨慎使用来自未知或不可信来源的 Skills
+
+## 6. 示例参考
+
+### 6.1 最小示例
+
+```
+minimal-skill/
+  - SKILL.md
+```
+
+```markdown
+---
+name: minimal-skill
+description: A minimal example Skill demonstrating basic structure.
+---
+
+# Minimal Skill
+
+## Quick start
+
+This is a minimal Skill example.
+```
+
+### 6.2 完整示例
+
+参考项目中的现有 Skills：
+
+- [`../../docs/guide_writing_standard/SKILL.md`](../../docs/guide_writing_standard/SKILL.md) - 文档撰写标准
+- [`../requirements/SKILL.md`](../requirements/SKILL.md) - 需求阶段资料库
+- [`../tool_prompts/SKILL.md`](../tool_prompts/SKILL.md) - 工具 Prompt 文档规范
+
+## 7. 工具和环境支持
+
+### 7.1 Claude Code
+
+- 支持自定义 Skills
+- Skills 作为目录结构存在于文件系统中
+- Claude 自动发现和使用它们
+
+### 7.2 Claude API
+
+- 支持预构建的 Agent Skills 和自定义 Skills
+- 需要特定 beta headers
+- 通过 `/v1/skills` 端点上传自定义 Skills
+
+### 7.3 Claude Agent SDK
+
+- 支持文件系统配置的自定义 Skills
+- Skills 位于 `.claude/skills/` 目录
+- 在 `allowed_tools` 配置中包含 `"Skill"` 以启用
+
+### 7.4 Claude.ai
+
+- 支持预构建和自定义 Skills
+- 自定义 Skills 通过设置上传
+- 需要特定计划和支持代码执行
+
+## 8. 版本历史
+
+- 1.0 (2025-10-16) - Agent Skills Spec 公开发布
+- 1.1 (YYYY-MM-DD) - 整合到 AI Product Kit 项目规范
+
+## 9. 参考资料
+
+- [Agent Skills 官方文档](https://docs.anthropic.com/en/docs/agents-and-tools/agent-skills)
+- [Agent Skills Cookbook](https://github.com/anthropics/claude-cookbooks/tree/main/skills)
+- [Agent Skills Spec](./agent_skills_spec.md) - 技术规范详情
+- [项目文档撰写标准](../../docs/guide_writing_standard/SKILL.md)

package/skills/aipk_skill_generate/agent_skills_spec.md

@@ -0,0 +1,79 @@
+# Agent Skills Spec
+
+## 技术规范
+
+A skill is a folder of instructions, scripts, and resources that agents can discover and load dynamically to perform better at specific tasks. In order for the folder to be recognized as a skill, it must contain a `SKILL.md` file.
+
+## Skill 文件夹布局
+
+### 最小结构
+
+A minimal skill folder looks like this:
+
+```
+my-skill/
+  - SKILL.md
+```
+
+### 完整结构
+
+More complex skills can add additional directories and files as needed:
+
+```
+my-skill/
+  ├── SKILL.md (required)
+  ├── template/
+  │   └── example.md
+  ├── examples/
+  │   └── usage.md
+  ├── scripts/
+  │   └── helper.py
+  └── references/
+      └── api.md
+```
+
+## SKILL.md 文件规范
+
+The skill's "entrypoint" is the `SKILL.md` file. It is the only file required to exist. The file must start with a YAML frontmatter followed by regular Markdown.
+
+### YAML Frontmatter
+
+The YAML frontmatter has 2 required properties:
+
+- **`name`**
+  - The name of the skill in hyphen-case
+  - Restricted to lowercase Unicode alphanumeric + hyphen
+  - Must match the name of the directory containing the SKILL.md
+  - Maximum 64 characters
+  - Cannot contain XML tags
+  - Cannot contain reserved words: "anthropic", "claude"
+
+- **`description`**
+  - Description of what the skill does and when Claude should use it
+  - Must be non-empty
+  - Maximum 1024 characters
+  - Cannot contain XML tags
+
+There are 3 optional properties:
+
+- **`license`**
+  - The license applied to the skill
+  - We recommend keeping it short (either the name of a license or the name of a bundled license file)
+
+- **`allowed-tools`**
+  - A list of tools that are pre-approved to run
+  - Currently only supported in Claude Code
+
+- **`metadata`**
+  - A map from string keys to string values
+  - Clients can use this to store additional properties not defined by the Agent Skills Spec
+  - We recommend making your key names reasonably unique to avoid accidental conflicts
+
+### Markdown Body
+
+The Markdown body has no restrictions on it, but should follow project documentation standards.
+
+## 版本历史
+
+- 1.0 (2025-10-16) Public Launch
+

package/skills/aipk_tool_prompts/AI/344/275/223/351/252/214/350/256/276/350/256/241/346/214/207/345/215/227.md

@@ -0,0 +1,93 @@
+# AI体验设计指南
+
+## 用处
+
+用于指导AI功能的交互设计，确保符合AI体验感标准。用户只需输入简单的功能需求，就能获得包含完整AI体验设计要求的详细指导。
+
+## 问题说明
+
+- 设计AI功能时，缺乏标准化的体验设计指导
+- 不同设计师对AI体验的理解不一致，导致设计质量参差不齐
+- 需要一套系统化的方法来确保AI功能的用户体验符合标准
+
+## 使用场景
+
+- **产品经理**：快速获得符合AI体验标准的交互设计指导
+- **UI/UX设计师**：获得包含AI体验要求的详细设计框架
+- **开发团队**：理解AI功能的交互设计标准
+- **产品规划**：确保AI功能设计符合用户体验标准
+
+## 输入格式
+
+用户输入应包含以下信息：
+
+```
+功能名称：[功能的具体名称]
+功能描述：[简要描述功能的作用和目的]
+目标用户：[主要使用该功能的用户类型]
+使用场景：[用户什么情况下会使用这个功能]
+```
+
+## Prompt
+
+```markdown
+# 角色
+你是一个AI体验设计指南，专门用于生成符合AI体验感标准的交互设计指导。
+
+## 核心能力
+
+1. 根据用户输入的功能需求，生成包含完整AI体验设计要求的详细需求
+2. 确保生成的交互体验设计符合最小化输入、透明化输出、迭代式改进三大原则
+3. 提供具体的用户旅程设计、界面设计要求和技术实现建议
+4. 包含明确的验收标准和检查清单
+
+## 处理流程
+
+① 接收功能需求 → ② 分析用户场景 → ③ 设计AI交互原则 → ④ 规划用户旅程 → ⑤ 制定界面要求 → ⑥ 提供技术建议 → ⑦ 设定验收标准
+
+## 输出规范
+
+请根据用户提供的功能需求，生成包含以下内容的完整设计指导：
+
+### 1. AI交互设计原则
+- 最小化输入原则的具体应用
+- 透明化输出过程的设计要求
+- 迭代式改进的实现方式
+
+### 2. 用户旅程设计
+- 输入阶段的简化设计
+- 处理过程的可视化方案
+- 输出结果的展示方式
+- 优化迭代的用户操作
+
+### 3. 界面设计要求
+- 输入界面的设计要点
+- 处理过程的可视化界面
+- 结果展示和编辑界面
+- 交互流程的优化建议
+
+### 4. 技术实现建议
+- 输入简化的技术方案
+- 过程可视化的实现方式
+- 迭代优化的技术架构
+
+### 5. 验收标准
+- 输入简化的验收标准
+- 输出透明的验收标准
+- 迭代优化的验收标准
+
+## 交互规则
+
+- 收到功能需求时："正在分析功能需求，生成AI体验设计指导..."
+- 生成完成后："已生成完整的AI体验设计指导，包含交互原则、用户旅程、界面要求、技术建议和验收标准"
+- 异常处理："功能描述不够详细，请补充目标用户和使用场景信息"
+
+## 优势特性
+
+- 标准化指导：确保生成的设计指导符合AI体验感标准
+- 场景化设计：根据不同功能类型提供针对性的设计建议
+- 可操作性：提供具体的界面设计和交互流程
+- 验收明确：包含清晰的验收标准和检查清单
+
+请提供功能需求，我将生成符合AI体验标准的完整设计指导。
+```

package/skills/aipk_tool_prompts/GURU_AI.md

@@ -0,0 +1,13 @@
+# GURU AI Snapshot
+
+Last refreshed: 2025-11-12T09:25:07.320186+00:00
+
+| File | Last Modified (UTC) |
+| --- | --- |
+| `AI体验设计指南.md` | 2025-11-11T10:16:36+00:00 |
+| `Prompt生成.md` | 2025-11-11T10:16:36+00:00 |
+| `SKILL.md` | 2025-11-12T02:51:13.660857+00:00 |
+| `images/20250710200701.png` | 2025-11-11T10:16:36+00:00 |
+| `images/20250710200802.png` | 2025-11-11T10:16:36+00:00 |
+| `标记文档更新.md` | 2025-11-11T10:16:36+00:00 |
+| `生成DrawIO文档.md` | 2025-11-11T10:16:36+00:00 |

package/skills/aipk_tool_prompts/Prompt/347/224/237/346/210/220.md

@@ -0,0 +1,20 @@
+# Prompt 生成
+
+## 用处
+
+用于生成 Prompt，用于 AI 模型。
+
+## Prompt
+
+```markdown
+请根据要求，生成一段高质量的 Prompt，用于指导 AI 模型生成新的 Prompt：
+
+1. 明确目标：说明需要生成的 Prompt 的具体用途和目标场景。
+2. 结构清晰：要求生成的 Prompt 结构分明，包含必要的上下文、输入要求、输出格式等。
+3. 语言简洁：用词准确、表达清晰，避免歧义。
+4. 可操作性强：确保 AI 能够直接理解并执行生成的 Prompt。
+5. 示例参考：如有需要，可在 Prompt 中加入示例，帮助理解。
+
+请输出完整的 Prompt 文本，便于直接复制使用。
+
+```

package/skills/aipk_tool_prompts/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: tool_prompts
+description: Catalog of reusable prompts for AI tooling workflows, including their usage guidance and file locations.
+---
+
+# 工具 Prompt 目录
+
+## 1. 技能定位
+- **适用场景**：需要复用或扩展现有 Prompt、为团队成员指路、或在文档/自动化流程中引用标准 Prompt 时
+- **目标人群**：文档维护者、产品/设计同学、自动化脚本作者
+- **价值主张**：提供单一入口，快速了解有哪些 Prompt、它们解决的问题，以及对应的 Markdown 文件位置
+
+## 2. 快速上手
+1. 查看下方《Prompt 目录总览》表格，确定要使用的 Prompt
+2. 打开表格中的文件路径，复制或定制完整 Prompt
+3. 根据《Prompt 使用要点》中的输入与输出规范执行，必要时在原文件中补充案例
+
+## 3. Prompt 目录总览
+| Prompt 名称 | 用途摘要 | 文件位置 |
+| --- | --- | --- |
+| Prompt 生成 | 生成结构化、高可复用的 Prompt 模板 | `Prompt生成.md` |
+| 标记文档更新 | 自动标出 Markdown 文档的新增/修改部分 | `标记文档更新.md` |
+| 生成 DrawIO 文档 | 将需求或视觉描述转换成可直接导入的 DrawIO XML | `生成DrawIO文档.md` |
+| AI 体验设计指南 | 输出符合 AI 体验标准的交互设计说明 | `AI体验设计指南.md` |
+
+## 4. Prompt 使用要点
+
+### 4.1 Prompt 生成
+- **核心能力**：产出带上下文、输入要求与输出格式的高质量 Prompt
+- **何时调用**：需要为新任务快速搭建 Prompt 框架，或统一团队 Prompt 书写风格时
+- **文件**：`Prompt生成.md`
+- **补充说明**：保持语言精简，可在原文件追加典型案例，方便直接复制
+
+### 4.2 标记文档更新
+- **核心能力**：比对最新更改并用 `<span>` 高亮新增/修改段落
+- **何时调用**：需要向评审者说明本次文档改动，或在 PR 中直观展示差异时
+- **文件**：`标记文档更新.md`
+- **补充说明**：图片示例位于 `./images/20250710200802.png`，可在需要视觉演示时引用
+
+### 4.3 生成 DrawIO 文档
+- **核心能力**：把文字或图片描述转成可用的 DrawIO XML，内含校验与交互提示
+- **何时调用**：梳理流程、界面结构或系统架构，需快速得到可导入 DrawIO 的代码时
+- **文件**：`生成DrawIO文档.md`
+- **补充说明**：输出块须包含完整 `<mxfile>` 结构，必要时提醒用户选择布局类型
+
+### 4.4 AI 体验设计指南
+- **核心能力**：根据输入的功能需求生成交互原则、旅程、界面与技术建议
+- **何时调用**：规划新的 AI 功能、需要标准化体验方案或定义验收标准时
+- **文件**：`AI体验设计指南.md`
+- **补充说明**：输入字段（功能名称/描述/目标用户/使用场景）缺失时，Prompt 会引导补全；保持“最小化输入、透明输出、迭代改进”三原则
+
+## 5. 维护与扩展
+- **新增 Prompt**：按照 [`../skill_generate/SKILL.md`](../skill_generate/SKILL.md) 的 Skill 结构创建 Markdown，并在本目录表格中登记
+- **写作规范**：遵循 [`../../docs/guide_writing_standard/SKILL.md`](../../docs/guide_writing_standard/SKILL.md)，必要指令使用 HTML 注释 `<!-- MUST: ... -->`
+- **变更提示**：更新现有 Prompt 时同步修改本文件的概览表，确保用途与位置描述一致；若新增资源（如示例图片），请在对应段落追加说明

package/skills/aipk_tool_prompts//346/240/207/350/256/260/346/226/207/346/241/243/346/233/264/346/226/260.md

@@ -0,0 +1,33 @@
+# 标记文档更新
+
+## 问题说明
+
+- 文档更新后，如果不做标记，阅读者很难知道哪些内容是更新过的。
+- 但markdown 的语法限制，很难手动在文档中标记更新过的内容。
+- 所以使用下述 Prompt 来让 AI 自动标记文档更新。
+
+## Prompt
+
+```markdown
+请标记文档中更新过的内容，便于阅读。
+
+## 检查更新内容
+
+- 如果有明确更新过的内容，请直接标记。
+- 否则，使用 git 检查所有尚未提交的更新内容。
+
+## 标记规则
+
+- 使用<span style="background-color: orange;">标记修改过的内容</span>。
+- 使用<span style="background-color: green;">标记新增的内容</span>。
+- 使用行内代码块标记修改过或新增的内容，不要跨行。
+- 对于标题行，将标题符号 '#' 放在<span>代码块外面。
+
+```
+
+## 使用说明
+
+- 检查更新内容部分提供了两个示例，一个是更新过的内容，一个是尚未提交的更新内容。请根据实际情况，选择更新内容检查范围。
+- 由于 Github 默认的界面不支持行内代码块，所以可以将文档更新下到本地后，用带有行内代码渲染的工具打开，比如 VS Code 的 Enhanced Markdown Preview 插件。
+- 或者在 github.dev 中打开文档，并使用 github.dev 的预览查看文档。
+  ![](images/20250710200802.png)

package/skills/aipk_tool_prompts//347/224/237/346/210/220DrawIO/346/226/207/346/241/243.md

@@ -0,0 +1,45 @@
+# 生成 DrawIO 文档
+
+## 问题说明
+
+- 使用 DrawIO 能生成比较灵活的各种图表，便于阅读和使用。
+- 所以使用下述 Prompt 来让 AI 自动生成 DrawIO 文档。
+
+## Prompt
+
+```markdown
+# 角色
+你是一个 DrawIO 代码生成器。可以将我的需求或者图片转化为对应的xml代码。
+
+## 核心能力
+
+1. 根据视觉描述/需求直接生成可运行的http://draw.io代码
+2. 生成的代码为单独的文档，以 drawio 为后缀。
+3. 校验机制保证代码准确性
+4. 输出标准化代码块
+5. 生成过程中要遵守规则 「DrawIO 图形规范指南（完整版）」
+
+## 处理流程
+
+① 接收输入 → ② 要素解析 → ③ 结构建模 → ④ 语法生成 → ⑤ 完整性校验 → ⑥ 输出结果
+
+## 输出规范
+
+```xml
+<!-- 经过校验的DrawIO代码 -->
+<mxfile> [生成的核心代码]</mxfile>
+```
+
+## 交互规则
+
+- 收到图片描述时："正在解析结构关系(进行描述图片细节)...(校验通过)"
+- 收到创建需求时："建议采用[布局类型]，包含[元素数量]个节点，是否确认？"
+- 异常处理："第X层节点存在连接缺失，已自动补全"
+
+## 优势特性
+
+- 元素定位精度：±5px等效坐标
+- 支持自动布局优化（可禁用）
+- 内置语法修正器（容错率<0.3%）请提供图表描述或创建需求，我将直接输出即用型代码。
+
+```