# AgentSkills

**Repository Path**: CPLASF000000/agent-skills

## Basic Information

- **Project Name**: AgentSkills
- **Description**: 我自己写的，用AI补充完整优化过的AgentSkills
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-04
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Skills 索引

本目录包含所有可用的 Agent Skills，用于扩展 AI Agent 的专业能力。

## 可用技能列表

### 1. 中文翻译助手

**路径**: `中文翻译助手/SKILL.md`

**功能**: 专业的文档翻译助手，将英文文档翻译成中文，保持原有格式和结构。

**主要特性**:
- 分析文档结构并保持格式
- 执行高质量的中文翻译
- 提供灵活的文档保存选项
- 强制用户确认流程

**触发场景**:
- 用户要求翻译文档
- 用户说"翻译"、"翻译成中文"等关键词
- 需要将英文文档转换为中文版本

**工作流程**:
1. 分析文档结构
2. 执行翻译
3. 询问用户保存方式（强制步骤）
4. 根据用户确认保存文档

---

### 2. 联网搜索总结内容助手

**路径**: `联网搜索总结内容助手/SKILL.md`

**功能**: 专业的联网搜索和内容总结助手，搜索相关信息并生成结构化总结。

**主要特性**:
- 执行联网搜索并筛选高质量结果
- 分析和整理搜索结果
- 生成结构化内容总结
- 提供灵活的文档保存选项
- 强制用户确认流程

**触发场景**:
- 用户需要搜索信息或查找资料
- 用户需要了解某个主题的最新信息
- 用户要求总结某个话题的内容
- 需要将搜索结果整理成文档

**工作流程**:
1. 执行联网搜索
2. 分析和整理搜索结果
3. 生成内容总结
4. 询问用户保存方式（强制步骤）
5. 根据用户确认保存文档

---

### 3. Debug助手

**路径**: `Debug助手/SKILL.md`

**功能**: 专业的Bug调试和分析助手，专门处理错误诊断和问题解决任务。

**主要特性**:
- 收集和分析Bug信息（日志、报错、截图等）
- 分析错误类型（编译错误、运行时错误）
- 阅读相关代码和文档
- 分析问题根本原因
- 提供多种解决方案
- 根据错误类型自动选择文档命名格式

**触发场景**:
- 用户报告bug、错误、异常或问题
- 用户提供运行日志、报错信息、堆栈跟踪
- 用户提供界面截图显示错误
- 用户说"调试"、"分析错误"、"查找问题"等

**工作流程**:
1. 收集和分析Bug信息
2. 分析错误类型（编译错误/运行时错误）
3. 阅读相关代码和文档
4. 分析问题根本原因
5. 提供解决方案
6. 创建或更新Bug文档（根据错误类型使用相应的命名格式）

**文档命名规则**:
- 编译错误：`编程语言-BuildError-序号-报错信息摘要.md`
- 运行时错误：`编程语言-Error-序号-报错摘要.md`

---

### 4. 产品经理

**路径**: `产品经理/SKILL.md`

**功能**: 专业的产品需求分析和管理助手，专门处理产品功能需求提炼和文档化任务。

**主要特性**:
- 从产品相关文档中提取关键信息
- 分析和提炼产品功能需求
- 结构化整理需求信息
- 生成标准化的产品需求文档（PRD）
- 支持多种文档格式（需求文档、设计文档、会议记录等）

**触发场景**:
- 用户要求分析产品需求、提炼功能需求
- 用户提供产品相关文档并要求整理
- 用户说"产品规划"、"需求分析"、"整理需求"等
- 需要将产品信息整理成结构化文档

**工作流程**:
1. 阅读产品相关文档（默认目录：`项目根目录/docs`）
2. 分析和提炼产品功能需求
3. 结构化整理需求信息
4. 生成产品需求文档（保存到 `项目根目录/docs/Product`）

**文档结构**:
- 产品概述、用户角色、功能需求、非功能需求、业务流程、技术约束、优先级排序、里程碑和计划、风险评估、附录

---

### 5. 技术专家

**路径**: `技术专家/SKILL.md`

**功能**: 专业的技术方案设计和实现助手，专门处理技术方案制定和代码实现任务。

**主要特性**:
- 根据产品功能需求制定技术实现方案
- 推荐合适的技术栈
- 设计多种技术实现方案
- 提供技术选型建议
- 生成相应的代码实现

**触发场景**:
- 用户要求制定技术实现方案
- 用户要求根据产品需求设计技术架构
- 用户说"技术选型"、"实现方案"、"代码实现"等
- 需要从产品需求到代码实现的完整流程

**工作流程**:
1. 阅读产品需求文档（默认目录：`项目根目录/docs/Product`）
2. 确认技术栈（如果用户未指定，必须推荐并等待确认）
3. 制定技术实现方案（保存到 `项目根目录/docs/Solutions`）
4. 如果有多方案，询问用户选择（强制步骤）
5. 确认用户选择的方案后创建代码文件并实现（保存到 `项目根目录/code`）

**文档结构**:
- 方案概述、系统架构、功能实现方案、数据模型设计、接口设计、技术选型说明、实现步骤、风险评估、性能考虑、安全考虑

---

### 6. 代码分析助手

**路径**: `代码分析助手/SKILL.md`

**功能**: 专业的代码分析和理解助手，专门处理代码结构分析和文档化任务。

**主要特性**:
- 识别编程语言
- 分析代码结构和函数/方法
- 分析函数/方法调用流程
- 分析面向对象编程的类关系
- 分析前端代码的控件层次
- 记录跨编程语言调用
- 生成详细的代码分析文档

**触发场景**:
- 用户要求分析代码文件、理解代码结构
- 用户提供代码文件并要求分析
- 用户说"代码分析"、"分析代码"、"代码结构"等
- 需要理解代码的调用关系、类关系、控件层次等

**工作流程**:
1. 识别编程语言和代码文件（用户必须指定，否则任务失败）
2. 分析代码结构和函数/方法
3. 分析函数/方法调用流程
4. 如果存在面向对象编程，分析类关系
5. 如果是前端代码，分析控件层次
6. 如果存在跨语言调用，记录调用关系
7. 生成代码分析文档（保存到 `项目根目录/docs/code`）

**文档命名格式**: `代码文件名/类名-分析.md`

**文档结构**:
- 基本信息、代码结构、调用流程分析、类关系分析、控件层次分析、跨语言调用、代码质量分析、总结

---

## 技能使用说明

### 如何启用技能

1. **Cursor 设置**:
   - 切换到 Nightly 版本
   - 打开 "Import Agent Skills" 开关
   - 确保技能目录被正确扫描

2. **技能目录位置**:
   - 项目根目录的 `skills/` 目录
   - 或 Cursor 的全局 skills 目录

### 技能触发机制

Skills 使用渐进式披露（Progressive Disclosure）机制：
- **Level 1（元数据）**: 启动时加载，用于匹配（~100 tokens/Skill）
- **Level 2（指令）**: Skill 被触发时才加载完整内容
- **Level 3+（资源）**: 按需访问

只有当用户请求与 skill 的 `description` 高度匹配时，才会加载完整的 skill 内容。

### 最佳实践

1. **明确触发**: 使用明确的触发关键词，如"翻译文档"、"搜索并总结"
2. **完整流程**: 每个技能都有强制的工作流程，不能跳过关键步骤
3. **用户确认**: 所有涉及文件操作的技能都会询问用户确认
4. **错误处理**: 如果遇到问题，技能会及时向用户说明并询问处理方式

## 技能开发指南

### 创建新技能

参考以下资源：
- [Cursor Skills 官方文档](https://cursor.com/cn/docs/context/skills)
- [Skill Creator 最佳实践](C:\Users\legion\.codex\skills\.system\skill-creator\SKILL.md)

### 技能结构要求

每个技能必须包含：
- `SKILL.md` 文件（必需）
  - YAML frontmatter（包含 `name` 和 `description`）
  - Markdown 指令内容
- 可选资源目录：
  - `scripts/` - 可执行代码
  - `references/` - 参考文档
  - `assets/` - 输出资源

### 技能命名规范

- 使用小写字母、数字和连字符
- 使用动词开头的短语描述动作
- 名称长度不超过 64 个字符
- 技能文件夹名称必须与技能名称完全一致

## 故障排除

### 技能未触发

如果技能没有被正确触发，检查：
1. **描述是否明确**: `description` 字段应该清晰描述技能功能和触发场景
2. **触发关键词**: 使用明确的触发关键词
3. **配置状态**: 确认 Cursor 设置中已启用 "Import Agent Skills"
4. **版本要求**: 确保使用 Nightly 版本

### 技能未按流程执行

如果技能被触发但没有按流程执行：
1. **检查指令**: 确保指令中使用强制性语言（MUST、REQUIRED）
2. **检查点**: 确认技能包含明确的执行检查点
3. **错误处理**: 检查是否有适当的错误处理机制

## 更新日志

### 2024-12
- ✅ 完善"Debug助手"技能，添加错误类型分析、文档命名规则、完整工作流程
- ✅ 完善"产品经理"技能，添加完整的产品需求分析流程和PRD文档模板
- ✅ 完善"技术专家"技能，添加技术方案设计流程、技术栈确认机制、代码实现流程
- ✅ 完善"代码分析助手"技能，添加代码结构分析、调用流程分析、类关系分析、控件层次分析
- ✅ 更新"联网搜索总结内容助手"技能，添加完整的 YAML frontmatter 和改进的工作流程
- ✅ 优化"中文翻译助手"技能描述，使其更符合最佳实践
- ✅ 创建技能索引文档

## 参考资源

- [Cursor Skills 官方文档](https://cursor.com/cn/docs/context/skills)
- [Agent Skills 架构说明](https://claudecn.com/docs/agent-skills/architecture/)
- [Skill Creator 指南](C:\Users\legion\.codex\skills\.system\skill-creator\SKILL.md)