129 lines
3.2 KiB
Markdown
129 lines
3.2 KiB
Markdown
# 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. 更新流程：
|
||
- 读取区块计划
|
||
- 重新扫描目录
|
||
- 分区块验证
|
||
- 增量更新
|
||
|
||
### /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` 自动调用
|
||
- 流程图是必需的，用于规范化思考和早期发现错误
|