Files
agent-aide/.aide/project-docs/blocks/aide-plugin-commands.md

129 lines
3.2 KiB
Markdown
Raw Normal View History

2025-12-15 22:23:16 +08:00
# aide-plugin-commands
> 路径aide-marketplace/aide-plugin/commands/
> 最后更新2025-12-17
2025-12-15 22:23:16 +08:00
## 概述
Aide 插件的斜杠命令定义。每个 Markdown 文件定义一个命令,文件内容作为 LLM 的提示词展开。命令通过 `/aide:命令名` 方式调用。
## 目录结构
```
aide-marketplace/aide-plugin/commands/
├── docs.md 项目文档管理命令
├── load.md 项目认知载入命令
├── run.md 任务执行命令(核心)
└── setup.md 环境配置命令
```
2025-12-15 22:23:16 +08:00
## 文件清单
| 文件 | 类型 | 说明 |
|------|------|------|
| docs.md | 命令 | `/aide:docs` - 项目文档创建和维护 |
| load.md | 命令 | `/aide:load` - 项目认知载入 |
| run.md | 命令 | `/aide:run` - 任务执行(核心命令) |
| setup.md | 命令 | `/aide:setup` - 环境配置 |
## 命令详解
### /aide:docs - 项目文档管理
- **功能**:创建和维护面向 LLM 的完整深度项目文档
- **独立运行**:是
- **核心原则**:完全深度探索,不遗漏任何文件或目录
**流程**
1. 创建流程:
- 完整目录扫描
- 初步区块划分
- 区块验证
- 逐区块深度探索
- 生成总导览
2. 更新流程:
- 读取区块计划
- 重新扫描目录
- 分区块验证
- 增量更新
### /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
```
2025-12-15 22:23:16 +08:00
## 依赖关系
- 依赖aide skillaide 命令使用方法)
- 依赖env-config skill环境配置指导
- 依赖task-parser skill口语化内容解析
2025-12-15 22:23:16 +08:00
## 注意事项
- 命令文件使用 Markdown 格式,内容作为 LLM 提示词
- `/aide:run` 是核心命令,其他命令可独立运行
- `/aide:load` 通常由 `/aide:run` 自动调用
- 流程图是必需的,用于规范化思考和早期发现错误