agent-aide/.aide/project-docs/blocks/aide-plugin-skills.md

# aide-plugin-skills

> 路径：aide-marketplace/aide-plugin/skills/
> 最后更新：2025-12-17

## 概述

Aide 插件的技能定义。每个技能是一个独立目录，包含 SKILL.md 文件作为技能知识库。技能通过 Skill 工具触发，为 LLM 提供专业领域的知识和指导。

## 目录结构

```
aide-marketplace/aide-plugin/skills/
├── aide/
│   └── SKILL.md             Aide 命令使用指南
├── env-config/
│   └── SKILL.md             环境配置详细指南
└── task-parser/
    └── SKILL.md             口语化内容解析指南
```

## 文件清单

| 文件 | 类型 | 说明 |
|------|------|------|
| aide/SKILL.md | 技能 | Aide CLI 工具完整使用指南 |
| env-config/SKILL.md | 技能 | 环境配置和故障排除指南 |
| task-parser/SKILL.md | 技能 | 口语化任务内容解析方法 |

## 技能详解

### aide - Aide 工具使用指南

- **触发描述**：Aide 工作流工具集。提供环境管理、进度追踪、待定项确认等功能。
- **内容覆盖**：
  - `aide env` - 环境管理命令
  - `aide flow` - 进度追踪命令
  - `aide decide` - 待定项确认命令
  - `aide config` - 配置管理命令
  - `aide init` - 初始化命令
  - 数据存储结构
  - 常见用法示例

### env-config - 环境配置指南

- **触发描述**：环境配置详细指南。由 `/aide:setup` 命令强制触发。
- **触发条件**：当 `aide env ensure` 检测失败时
- **内容覆盖**：
  - 问题诊断（常见失败原因）
  - 模块分类（类型A/类型B）
  - 配置命令使用
  - 项目类型配置示例
  - 多项目场景处理（模块实例化命名）
  - node_deps 模块详解
  - 故障排除

### task-parser - 口语化内容解析器

- **触发描述**：口语化任务内容解析器。当发现用户对话或任务文档具有明显口头语气时使用。
- **触发条件**：内容具有口语化特征（模糊表述、松散结构、思维跳跃等）
- **解析流程**：
  1. 语义解析（表层理解、深层提取、结构重组）
  2. 批判性分析（逻辑漏洞、盲点识别、过度设计识别）
  3. 建设性优化（优化建议、方案对比、风险权衡）
  4. 上下文关联分析（项目关联、隐含需求、复杂度预判）

## 接口说明

### 技能文件格式

每个 SKILL.md 文件包含 YAML 前置元数据：

```yaml
---
name: 技能名称
description: 技能描述（用于触发匹配）
---

# 技能内容
...
```

### 技能触发方式

技能通过 Skill 工具自动触发：
- LLM 根据任务场景匹配合适的技能
- 触发后技能内容作为上下文提供给 LLM

## 依赖关系

- 被依赖：aide-plugin commands（命令中引用技能）

## 注意事项

- 技能文件使用 Markdown 格式，内容作为 LLM 知识库
- YAML 前置元数据中的 description 用于技能匹配
- 技能应专注于单一领域，提供完整但聚焦的指导
- 技能之间可以相互引用（如 aide skill 引用 env-config skill）