# AI Coding

> AI辅助编程技能，帮助Claude学习如何创建和使用OpenClaw技能

- Skill: `lord1egypt/ai-coding` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx get-skill add lord1egypt/ai-coding`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lord1egypt/ai-coding/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Lord1Egypt (https://skillmd.com/u/lord1egypt)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/lord1egypt/ai-coding

---


# AI编程技能

AI辅助编程技能，帮助Claude学习如何创建和使用OpenClaw技能。

## 技能描述

这是一个关于如何开发OpenClaw技能的完整指南。它解释了技能的结构、如何编写SKILL.md、如何创建工具脚本，以及如何在对话中"教"Claude使用这些技能。

## 使用场景

- 用户问："如何在OpenClaw中创建新技能？" → 提供完整指南
- 用户说："创建一个数据处理技能" → 按照指南创建技能结构
- 用户问："SKILL.md应该怎么写？" → 提供格式和示例
- 用户说："我写了一个技能，OpenClaw不会用" → 解释如何教学

## 技能结构

### 标准技能目录结构

```
skill-name/
├── SKILL.md              # 主文档（OpenClaw自动读取）
├── references/           # 参考文档（自动读取）
│   ├── topic1.md
│   └── topic2.md
└── tools/               # 工具脚本（需要教OpenClaw调用）
    └── script.py
```

### OpenClaw如何学习

**自动做的**：
- ✅ 读取 `SKILL.md`
- ✅ 读取 `references/*.md`
- ✅ 理解功能说明
- ✅ 响应相关请求

**需要你做的**：
- ⚠️ 安装 Python 依赖
- ⚠️ 在对话中教它如何使用工具
- ⚠️ 提供清晰的工具脚本

## 创建技能的步骤

### 步骤1：创建技能目录

```bash
mkdir -p ~/.openclaw/skills/my-skill/references
```

### 步骤2：编写SKILL.md

```markdown
---
name: my-skill
description: 我的自定义技能
version: 1.0.0
---

# 我的技能

## 功能
- 功能1: 描述
- 功能2: 描述

## 使用方法
当我说"XXX"时，请调用YYY工具
```

### 步骤3：添加参考文档（可选）

```bash
cat > ~/.openclaw/skills/my-skill/references/guide.md << 'EOF'
# 使用指南

详细的使用说明...
EOF
```

### 步骤4：在对话中"教"OpenClaw

```
用户: 我创建了一个新技能 my-skill，位置在 ~/.openclaw/skills/my-skill/

OpenClaw: 我看到这个技能了，它包含...

用户: 这个技能有一个工具在 tools/script.py，
当我说"执行XXX"时，请调用它。

OpenClaw: 明白了，我会记住这个规则。

用户: 执行XXX

OpenClaw: [自动调用工具]
```

## SKILL.md编写规范

### 推荐格式

```markdown
---
name: your-skill
description: 简短描述
version: 1.0.0
author: 你的名字
---

# 技能名称

## 功能概述
简要描述这个技能做什么

## 主要功能

### 功能1
- 说明
- 使用示例

### 功能2
- 说明
- 使用示例

## 使用方法

### 场景1: XXX
当用户说"XXX"时，我会：
1. 步骤1
2. 步骤2

## 工具脚本

### script1.py
位置: tools/script1.py
功能: 描述
调用方式: python tools/script1.py

## 限制
- 限制1
- 限制2
```

## 工具脚本最佳实践

### 基本结构

```python
#!/usr/bin/env python3
"""
工具脚本名称
"""

def main():
    """主函数"""
    # 你的代码
    pass

if __name__ == "__main__":
    main()
```

### 关键点

- ✅ 清晰的函数命名
- ✅ 完整的注释
- ✅ 错误处理
- ✅ 命令行参数支持

## 故障排除

### 问题1：OpenClaw识别不到Skill

**解决**：
```bash
# 确认位置
ls ~/.openclaw/skills/your-skill/SKILL.md

# 验证格式
head -5 ~/.openclaw/skills/your-skill/SKILL.md
# 应该看到 --- 开头的YAML
```

### 问题2：OpenClaw不会调用工具

**解决**：需要在对话中教它
- 告诉它工具位置
- 告诉它调用方式
- 告诉它触发条件

### 问题3：文档没有被索引

**解决**：确认文件在 references/ 目录
```bash
ls ~/.openclaw/skills/your-skill/references/
```

## 最佳实践

### ✅ DO（推荐）

1. **清晰的命名**
   - skill-name: 清楚表达功能
   - file names: 描述性命名

2. **完整的文档**
   - SKILL.md: 完整功能说明
   - references/: 详细参考文档

3. **示例丰富**
   - 代码示例
   - 对话示例
   - 使用场景

4. **错误处理**
   - 工具脚本处理异常
   - 提供错误信息

### ❌ DON'T（避免）

1. 不要过度依赖自动化
   - OpenClaw需要你教它如何使用工具

2. 不要省略文档
   - 没有文档 = OpenClaw学不会

3. 不要硬编码路径
   - 使用相对路径或环境变量

## 注意事项

1. **SKILL.md是关键**：OpenClaw自动读取
2. **需要你教学**：在对话中教它使用工具
3. **提供工具脚本**：清晰的调用接口
4. **持续优化**：根据使用反馈改进

