# aide-plugin-commands

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

## 概述

Aide 插件的斜杠命令定义。每个 Markdown 文件定义一个命令，文件内容作为 LLM 的提示词展开。命令通过 `/aide:命令名` 方式调用。

## 目录结构

```
aide-marketplace/aide-plugin/commands/
├── docs.md                  项目文档管理命令
├── load.md                  项目认知载入命令
├── run.md                   任务执行命令（核心）
└── setup.md                 环境配置命令
```

## 文件清单

| 文件 | 类型 | 说明 |
|------|------|------|
| docs.md | 命令 | `/aide:docs` - 项目文档创建和维护 |
| load.md | 命令 | `/aide:load` - 项目认知载入 |
| run.md | 命令 | `/aide:run` - 任务执行（核心命令） |
| setup.md | 命令 | `/aide:setup` - 环境配置 |

## 命令详解

### /aide:docs - 项目文档管理

- **功能**：创建和维护面向 LLM 的完整深度项目文档
- **独立运行**：是
- **核心原则**：完全深度探索，不遗漏任何文件或目录

**流程**：
1. 创建流程：
   - 完整目录扫描（递归遍历所有目录和文件）
   - 初步区块划分（必须覆盖所有非忽略的顶层目录）
   - 区块验证（强制完整性检查）
   - 逐区块深度探索
   - 生成总导览
2. 更新流程：
   - 读取区块计划
   - 重新扫描目录
   - 分区块验证
   - 增量更新

**关键规则**：
- 根目录下每个非忽略的子目录都必须归入某个区块
- 非代码目录（如 docs/、discuss/、assets/）同样必须作为区块覆盖
- 区块划分后必须进行完整性验证
- 完成后必须运行目录完整性最终检查

### /aide:load - 项目认知载入

- **功能**：按需载入项目文档，建立对项目的认知
- **独立运行**：否（由 `/aide:run` 调用）

**流程**：
1. 载入总导览
2. 建立脉络认知
3. 按需深入（根据任务）

**无文档时**：快速认知（阅读关键文件、探索目录结构）

### /aide:run - 任务执行

- **功能**：核心命令，整合任务准备和任务执行
- **独立运行**：是
- **参数**：任务文档路径（可选）

**流程阶段**：
1. **task-optimize**：任务准备
   - 口语化内容检测
   - 任务分析
   - 复杂度评估
   - 任务优化
   - 待定项处理
   - 生成任务细则
2. **flow-design**：流程设计
   - 制定执行计划
   - 创建流程图（任务执行流程图、程序逻辑流图）
3. **impl**：迭代实现
4. **verify**：验证交付
5. **docs**：文档更新
6. **finish**：收尾

**复杂任务**：拆分为子计划，循环执行 flow-design → impl → verify → docs

### /aide:setup - 环境配置

- **功能**：环境依赖分析、配置、检测和修复
- **独立运行**：是

**流程**：
1. 检查 aide 运行时环境
2. 初始化 aide 目录
3. 分析项目依赖
4. 配置环境模块
5. 执行环境检测
6. 处理问题

## 接口说明

### 命令调用方式

```bash
# 项目文档管理
/aide:docs

# 项目认知载入（通常由 run 自动调用）
/aide:load

# 任务执行
/aide:run [任务文档路径]

# 环境配置
/aide:setup
```

## 依赖关系

- 依赖：aide skill（aide 命令使用方法）
- 依赖：env-config skill（环境配置指导）
- 依赖：task-parser skill（口语化内容解析）

## 注意事项

- 命令文件使用 Markdown 格式，内容作为 LLM 提示词
- `/aide:run` 是核心命令，其他命令可独立运行
- `/aide:load` 通常由 `/aide:run` 自动调用
- 流程图是必需的，用于规范化思考和早期发现错误
