# 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-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Skills 索引

---

## 中文目录英文命名方案

> 本节记录所有中文技能目录的英文命名方案、命名动机及所用命名方法。

### 命名动机

1. **跨平台兼容性**：中文目录名在部分操作系统、CI/CD 环境和命令行工具中可能引发编码问题，英文名可保证在所有环境下稳定运行。
2. **工具链友好**：`grep`、`find`、`ls` 等命令行工具以及 Git、IDE 插件对 ASCII 字符的支持更好，减少转义和引号问题。
3. **团队协作**：英文名便于非中文母语者阅读和搜索，降低协作摩擦。
4. **风格统一**：与目录中已有的英文命名（`Debug助手`、`QtDocAgent`）保持一致，避免混用。

### 命名方法

统一采用 **kebab-case（短横线小写连字符）** 规范，结合以下三种策略：

| 策略 | 说明 | 适用对象 |
|------|------|---------|
| **角色直译法**（Role Mapping） | 将中文职能角色直接映射为业界通用英文岗位术语 | 产品经理、技术专家 |
| **功能提炼法**（Functional Naming） | 从技能的核心动作和输出提取关键词，组合为「动词-名词」短语，去除冗余的"助手/专家"后缀 | 联网搜索总结内容助手、代码分析助手、代码修改专家、中文翻译助手 |
| **音译保留法**（Transliteration） | 对专有人名/角色名使用拼音音译，保留原始标识 | 数字生命卡兹克 |

对于已含英文词的混合名称（如 `Debug助手`），只补全缺失的英文部分，不改变已有英文词。

### 英文命名对照表

| 中文目录名 | 建议英文目录名 | 命名策略 | 命名说明 |
|-----------|-------------|---------|---------|
| 联网搜索总结内容助手 | `web-search-summarizer` | 功能提炼 | 核心动作为"联网搜索（web search）"，输出为"总结（summarizer）"；去掉"内容助手"等冗余词，用 `-er` 后缀体现工具角色 |
| 技术专家 | `tech-solution-architect` | 角色直译 | SKILL.md 的核心职责是"制定技术方案（solution）并落地实现（architect）"，比直译 `tech-expert` 更准确，也呼应了技术架构师（solution architect）这一业界职位 |
| 产品经理 | `product-manager` | 角色直译 | 业界标准英文岗位名称，与技能描述（PRD、需求分析）完全对应，无需额外修饰 |
| 代码分析助手 | `code-analyzer` | 功能提炼 | 技能的单一职责是"分析代码结构"，`analyzer` 简洁表达工具角色；省略"助手"后缀，与 `product-manager` 等命名层级对齐 |
| 中文翻译助手 | `zh-translator` | 功能提炼 | "中文"使用 ISO 639-1 标准语言代码 `zh`，比 `chinese-` 前缀更简洁且国际化；`translator` 精确表达"翻译"功能 |
| 代码修改专家 | `code-refactor-expert` | 功能提炼 | "修改"含义广泛，但技能实际涵盖重构（refactor）、优化、Bug 修复等操作，`refactor` 是编程领域最能概括这些行为的通用术语；`expert` 对应原名中的"专家"，强调专业性 |
| 数字生命卡兹克 | `digital-life-kazk` | 音译保留 | "数字生命"直译为 `digital-life`；"卡兹克"为角色专名，采用拼音近似音译 `kazk` 保留其发音特征；该技能目前内容为空，命名以可识别性和占位为主 |
| Debug助手 | `debug-assistant` | 功能提炼（补全） | `Debug` 已是英文，仅将"助手"补全为 `assistant`；转为全小写以符合 kebab-case 规范 |

---



本目录包含所有可用的 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`

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

---

### 7. 代码修改专家

**路径**: `代码修改专家/SKILL.md`

**功能**: 专业的代码修改和重构助手，专门根据需求对现有代码进行修改、优化和重构。

**主要特性**:
- 理解用户的修改需求
- 分析现有代码结构
- 制定详细的修改方案
- 支持多种修改类型（功能添加、功能修改、Bug修复、性能优化、代码重构等）
- 执行精确的代码修改
- 验证修改结果

**触发场景**:
- 用户要求修改代码文件
- 用户要求添加新功能到现有代码
- 用户要求修复代码中的Bug
- 用户要求优化代码性能
- 用户要求重构代码
- 用户说"修改代码"、"代码修改"、"重构代码"、"优化代码"等

**工作流程**:
1. 理解修改需求（明确用户要修改什么）
2. 分析现有代码（读取并理解需要修改的代码文件）
3. 制定修改方案（设计具体的修改计划）
4. 如果修改方案有多个选项，询问用户选择（强制步骤）
5. 用户确认方案后执行代码修改
6. 验证修改结果（检查修改是否正确）

**修改类型**:
- 功能添加：添加新的功能或特性
- 功能修改：修改现有功能的行为
- Bug修复：修复代码中的错误或问题
- 性能优化：优化代码性能
- 代码重构：重构代码结构，提高可维护性
- 代码风格：调整代码风格和格式

---

## 技能使用说明

### 如何启用技能

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)