98 lines
2.8 KiB
Markdown
98 lines
2.8 KiB
Markdown
# aide-plugin-commands
|
||
|
||
> 路径：aide-marketplace/aide-plugin/commands/
|
||
> 最后更新：2025-12-16
|
||
|
||
## 概述
|
||
|
||
Aide 插件的斜杠命令定义，是面向 LLM 的执行指令文件。
|
||
|
||
## 文件清单
|
||
|
||
| 文件 | 说明 |
|
||
|------|------|
|
||
| `setup.md` | `/aide:setup` - 环境配置命令 |
|
||
| `load.md` | `/aide:load` - 项目认知载入 |
|
||
| `docs.md` | `/aide:docs` - 项目文档管理 |
|
||
| `run.md` | `/aide:run` - 任务执行（核心命令） |
|
||
|
||
## 命令说明
|
||
|
||
### /aide:setup
|
||
|
||
- **用途**：环境配置（独立运行）
|
||
- **触发 skill**：env-config
|
||
- **流程**：
|
||
1. 检查 aide 运行时环境
|
||
2. 初始化 .aide 目录
|
||
3. 分析项目依赖
|
||
4. 配置环境模块
|
||
5. 执行环境检测
|
||
|
||
### /aide:load
|
||
|
||
- **用途**：项目认知载入（由 run 调用）
|
||
- **触发 skill**：aide
|
||
- **流程**：
|
||
1. 检查项目文档配置
|
||
2. 载入总导览
|
||
3. 建立脉络认知
|
||
4. 按需深入
|
||
|
||
### /aide:docs
|
||
|
||
- **用途**：项目文档创建和维护（独立运行）
|
||
- **触发 skill**：aide
|
||
- **核心原则**：完全深度探索，不考虑效率，对每个文件/目录完全覆盖
|
||
- **流程**：
|
||
- 创建流程：完整目录扫描 → 生成 tree 结构 → 区块划分 → 逐区块完全深度探索 → 生成总导览
|
||
- 更新流程：读取区块计划 → 重新扫描目录 → 分区块验证 → 增量更新
|
||
- **文档格式**：
|
||
- 总导览：简化版目录结构（前两层）+ 区块索引 + 统计信息
|
||
- 子区块：完整 tree 结构 + 每文件概括 + 核心组件说明
|
||
|
||
### /aide:run
|
||
|
||
- **用途**：任务执行（核心命令）
|
||
- **触发 skill**：aide, task-parser（按需）
|
||
- **新增功能**：
|
||
- 口语化内容检测：在任务分析前检测内容特征
|
||
- 自动触发 task-parser skill 解析口语化内容
|
||
- 流程图规范：区分任务执行流程图和程序逻辑流图
|
||
- **标准流程**：
|
||
1. task-optimize - 任务准备（含口语化检测）
|
||
2. flow-design - 流程设计（含流程图规范）
|
||
3. impl - 迭代实现
|
||
4. verify - 验证交付
|
||
5. docs - 文档更新
|
||
6. finish - 收尾
|
||
|
||
## 流程图要求
|
||
|
||
### 任务执行流程图（所有任务必需）
|
||
- 展示任务执行的步骤顺序
|
||
- 体现决策点和依赖关系
|
||
|
||
### 程序逻辑流图（程序类任务必需）
|
||
- 从入口函数开始
|
||
- 体现顺序/分支/循环结构
|
||
- 语义化抽象，模块化表示
|
||
- 支持层次化组织
|
||
|
||
## 设计原则
|
||
|
||
- 执行文件给 LLM 看，聚焦执行指令
|
||
- 设计文档给人看，包含完整上下文
|
||
- 每个命令开始时触发对应的 skill 学习必要知识
|
||
|
||
## 依赖关系
|
||
|
||
- 依赖：aide skill, env-config skill, task-parser skill
|
||
- 调用：aide 命令行工具
|
||
|
||
## 注意事项
|
||
|
||
- `/aide:setup` 和 `/aide:docs` 是独立运行的命令
|
||
- `/aide:load` 通常由 `/aide:run` 内部调用
|
||
- `/aide:run` 是最常用的核心命令
|