---
id: {SKILL_ID}
title: {技能名称}
status: draft
related_features: []
related_decisions: []
---

# {SKILL_ID}: {技能名称}

<!-- 本模板是插件 starter 指导，项目本地模板可完全覆盖 -->
<!-- 插件模板是入门指导，项目本地模板是权威 -->

## 概述

{描述这个 Agent 技能的用途、触发条件和主要能力}

## 技能元信息

- **名称**：{skill_name}
- **描述**：{description}
- **触发条件**：{触发条件}
- **适用场景**：{适用场景}

## 输入契约

### 必需输入

| 参数 | 类型 | 描述 |
|------|------|------|
| {param1} | {type} | {描述} |
| {param2} | {type} | {描述} |

### 可选输入

| 参数 | 类型 | 默认值 | 描述 |
|------|------|--------|------|
| {param3} | {type} | {默认值} | {描述} |

## 输出契约

### 成功输出

```json
{
  "success": true,
  "data": {
    "field1": "value",
    "field2": "value"
  }
}
```

### 错误输出

```json
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "错误描述"
  }
}
```

## 处理流程

### 步骤 1：{步骤标题}

**目的**：{步骤目的}

**输入**：{输入}
**处理**：{处理逻辑}
**输出**：{输出}

### 步骤 2：{步骤标题}

{同上结构}

## 工具依赖

| 工具 | 用途 | 权限要求 |
|------|------|---------|
| {tool1} | {用途} | {权限} |
| {tool2} | {用途} | {权限} |

## 权限边界

- **可访问资源**：{资源列表}
- **禁止操作**：{禁止列表}
- **数据访问范围**：{范围}

## 错误处理

| 错误码 | 描述 | 处理方式 |
|--------|------|---------|
| INVALID_INPUT | 输入无效 | 返回错误详情 |
| PERMISSION_DENIED | 权限不足 | 提示权限要求 |
| TOOL_ERROR | 工具调用失败 | 重试或降级 |

## 示例

### 示例 1：{场景描述}

**输入**：
```json
{
  "param1": "value1",
  "param2": "value2"
}
```

**输出**：
```json
{
  "success": true,
  "data": {
    "result": "处理结果"
  }
}
```

## 关联制品

- 功能特性：{related_features}
- 决策：{related_decisions}
- 设计文档：{related_designs}

## 变更日志

| 日期 | 变更 | 作者 |
|------|------|------|
| {YYYY-MM-DD} | 初始草稿 | {作者} |