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

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. 处理问题

接口说明

命令调用方式

# 项目文档管理
/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 自动调用
• 流程图是必需的，用于规范化思考和早期发现错误