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

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 是最常用的核心命令