# 02_技能使用通用规则

## 🛠️ **所有Agent使用技能的统一规范**

### **A. 技能选择原则**

#### **1. 适用性原则**
- **功能匹配**: 选择与任务需求最匹配的技能
- **成熟度优先**: 优先选择成熟稳定的技能
- **效率优化**: 选择效率最高的技能方案

#### **2. 质量原则**
- **可靠性**: 选择可靠性高的技能
- **准确性**: 选择准确性高的技能
- **安全性**: 选择安全性高的技能

#### **3. 效率原则**
- **响应速度**: 选择响应速度快的技能
- **资源效率**: 选择资源消耗低的技能
- **成本效益**: 选择成本效益最优的技能

### **B. 技能使用流程**

#### **1. 使用前检查**
```
步骤1: 技能需求分析
步骤2: 技能选项评估
步骤3: 技能兼容性检查
步骤4: 技能权限验证
步骤5: 使用方案制定
```

#### **2. 使用中规范**
```
步骤1: 参数配置验证
步骤2: 输入数据检查
步骤3: 执行过程监控
步骤4: 异常情况处理
步骤5: 结果质量检查
```

#### **3. 使用后管理**
```
步骤1: 结果验证测试
步骤2: 资源清理释放
步骤3: 性能记录分析
步骤4: 问题记录反馈
步骤5: 经验总结分享
```

### **C. 具体技能使用规范**

#### **1. 基础技能使用规范**

##### **1.1 文件读写技能**
- **路径规范**: 使用绝对路径，避免相对路径
- **权限检查**: 检查文件读写权限
- **编码规范**: 统一使用UTF-8编码
- **错误处理**: 完善的错误处理和恢复机制

##### **1.2 命令执行技能**
- **安全检查**: 执行前进行安全检查
- **权限验证**: 验证执行权限级别
- **输出处理**: 正确处理命令输出和错误
- **超时控制**: 设置合理的超时时间

##### **1.3 网络访问技能**
- **网络检查**: 检查网络连接状态
- **安全验证**: 验证访问安全性
- **超时设置**: 设置网络超时时间
- **错误重试**: 实现错误重试机制

#### **2. 高级技能使用规范**

##### **2.1 模型调用技能**
- **模型选择**: 根据任务选择合适模型
- **参数优化**: 优化模型调用参数
- **成本控制**: 控制模型调用成本
- **性能监控**: 监控模型调用性能

##### **2.2 数据处理技能**
- **数据验证**: 验证输入数据质量
- **格式规范**: 遵守数据格式规范
- **清洗处理**: 必要的数据清洗处理
- **结果验证**: 验证数据处理结果

##### **2.3 图像处理技能**
- **格式支持**: 检查支持的文件格式
- **质量控制**: 控制输出图像质量
- **大小优化**: 优化图像文件大小
- **版权合规**: 确保图像使用合规

### **D. 技能使用质量标准**

#### **1. 功能质量标准**
- **正确性**: 技能功能正确实现
- **完整性**: 功能实现完整无缺
- **稳定性**: 功能运行稳定可靠
- **兼容性**: 与其他技能兼容良好

#### **2. 性能质量标准**
- **响应时间**: 技能响应时间达标
- **处理能力**: 处理能力满足需求
- **资源使用**: 资源使用合理高效
- **扩展能力**: 支持未来扩展需求

#### **3. 安全质量标准**
- **权限控制**: 严格的权限控制机制
- **数据安全**: 数据安全保护措施
- **访问控制**: 安全的访问控制机制
- **审计追踪**: 完整的审计追踪记录

### **E. 技能使用检查清单**

#### **使用前检查清单**
- [ ] 技能需求分析完成
- [ ] 技能选项评估完成
- [ ] 兼容性检查通过
- [ ] 权限验证通过
- [ ] 使用方案制定完成

#### **使用中检查清单**
- [ ] 参数配置验证通过
- [ ] 输入数据检查通过
- [ ] 执行过程监控正常
- [ ] 异常处理机制就绪
- [ ] 结果质量检查计划就绪

#### **使用后检查清单**
- [ ] 结果验证测试通过
- [ ] 资源清理释放完成
- [ ] 性能记录分析完成
- [ ] 问题记录反馈完成
- [ ] 经验总结分享完成

### **F. 技能使用记录要求**

#### **1. 使用日志记录**
```
格式: [时间] [Agent] [技能] [操作] [结果] [耗时]
要求: 记录所有技能使用的重要操作
```

#### **2. 性能数据记录**
```
格式: [技能] [调用次数] [成功数] [失败数] [平均耗时] [资源使用]
要求: 定期记录技能使用性能数据
```

#### **3. 问题记录报告**
```
格式: [问题时间] [技能] [问题描述] [影响范围] [解决方案] [解决时间]
要求: 记录所有技能使用中遇到的问题
```

### **G. 技能使用优化机制**

#### **1. 性能监控优化**
- **实时监控**: 实时监控技能使用性能
- **问题预警**: 提前预警技能使用问题
- **性能分析**: 定期分析技能使用性能
- **优化建议**: 提供技能使用优化建议

#### **2. 质量改进机制**
- **质量评估**: 定期评估技能使用质量
- **问题整改**: 及时整改技能使用问题
- **标准更新**: 更新技能使用标准
- **经验分享**: 分享技能使用经验

#### **3. 技能升级管理**
- **版本跟踪**: 跟踪技能版本更新
- **升级测试**: 测试新版本技能
- **升级评估**: 评估升级效果和风险
- **升级实施**: 安全实施技能升级

## 📊 **技能使用评估指标**

### **功能性指标**
- **技能覆盖率**: 覆盖需求的比例
- **功能正确率**: 功能正确实现的比例
- **问题解决率**: 技能解决问题的能力

### **性能性指标**
- **平均响应时间**: 技能平均响应时间
- **处理成功率**: 任务处理成功率
- **资源使用效率**: 资源使用效率指标

### **质量性指标**
- **用户满意度**: 用户对技能的满意度
- **问题发生率**: 技能使用问题发生率
- **改进响应率**: 问题改进响应效率

---

**创建时间**: 2026-05-05  
**适用范围**: 所有Agent  
**检查频率**: 每次技能使用前后  
**更新机制**: 每季度审查更新一次