writing-skills

name: writing-skills description: 创建新技能的技能。遵循最佳实践编写 SKILL.md 文件。用于创建或改进 Agent 技能时。

编写技能的技能

学习如何创建高质量的 Agent 技能。

技能文件结构

.agent/skills/[skill-name]/
├── SKILL.md           # 必需: 主要指令文件
├── scripts/           # 可选: 辅助脚本
├── examples/          # 可选: 示例文件
└── resources/         # 可选: 其他资源

SKILL.md 格式

---
name: skill-name
description: 清晰描述技能的用途和触发条件
---

# 技能名称

[技能的详细说明]

## 触发条件
[什么情况下应该使用这个技能]

## 工作流程
[步骤化的操作指南]

## 最佳实践
[重要的提示和建议]

## 示例
[使用示例]

编写原则

1. 描述要清晰

描述是 Agent 发现技能的关键：

• ✅ "代码审查时检查安全漏洞和性能问题"
• ❌ "帮助审查代码"

2. 指令要具体

提供可执行的步骤：

• ✅ "首先检查所有输入是否经过验证"
• ❌ "确保代码安全"

3. 包含示例

展示期望的输出格式：

## 示例输出
```json
{
  "issues": [
    {"severity": "high", "message": "未验证的用户输入"}
  ]
}

### 4. 定义决策树
帮助 Agent 选择正确的行动：
```markdown
## 决策流程
如果 [条件A]:
  执行 [动作A]
否则如果 [条件B]:
  执行 [动作B]
否则:
  执行 [默认动作]

测试技能

1. 创建技能文件
2. 触发相关任务
3. 验证 Agent 是否正确使用技能
4. 根据结果调整指令