# Qoder 技能规范摘要

> 本文件摘要整理 Qoder CLI 技能的核心规范，供快速参考。完整规范请参阅官方文档。

## 技能目录结构

```
<skill-name>/
├── skill.json      # 技能元信息（必填）
├── prompt.md       # 技能 Prompt 定义（必填）
├── tools/          # 工具定义或 MCP 配置（可选）
├── tests/          # 验证用例（可选）
└── CHANGELOG.md    # 版本变更记录（推荐）
```

## skill.json 字段

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `name` | string | 是 | 技能名称，全局唯一 |
| `version` | string | 是 | 语义化版本号 |
| `description` | string | 是 | 技能功能描述 |
| `triggers` | array | 否 | 触发条件（关键词、模式等） |
| `tools` | array | 否 | 依赖的工具列表 |
| `tags` | array | 否 | 标签，用于分类和检索 |

## prompt.md 格式

`prompt.md` 是技能的核心，定义了技能的执行逻辑：

- 使用 Markdown 格式编写
- 明确描述技能的触发场景和执行步骤
- 可引用工具（通过工具名称）
- 建议包含输入输出示例

## 工具集成

Qoder 支持通过 MCP（Model Context Protocol）服务器扩展工具：

- 在 `tools/` 目录下放置 MCP 配置文件
- 或在 `skill.json` 中声明依赖的 MCP 服务器

## 参考链接

- [Qoder 官方文档](https://docs.qoder.ai)（待确认）
- `examples/` 目录中的参考实现