4.9 KiB
4.9 KiB
/aide:setup 命令设计文档
一、概述
/aide:setup 是环境配置命令，专注于环境依赖分析、配置、检测和修复。
1.1 设计目标
| 目标 | 说明 |
|---|---|
| 独立运行 | 通常在新项目开始时单独执行 |
| 环境专注 | 只处理环境问题，不涉及任务执行 |
| 自动化 | 尽可能自动检测和修复环境问题 |
1.2 与旧命令的关系
本命令从原 /aide:init 中拆分出环境相关功能。
二、执行流程
┌─────────────────────────────────────────┐
│ /aide:setup │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 强制触发 env-config skill │
│ (获取详细环境配置指导) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ aide env ensure --runtime │
│ (检查 aide 运行时环境) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ aide init │
│ (初始化 .aide 目录) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ 分析项目依赖 │
│ (识别项目类型和所需模块) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ aide env set modules ... │
│ (配置环境模块) │
└─────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────┐
│ aide env ensure │
│ (执行环境检测) │
└─────────────────────────────────────────┘
│
┌──────────┴──────────┐
▼ ▼
[成功] [失败]
│ │
▼ ▼
完成汇报 故障排除
│
▼
重试(最多3次)
三、职责边界
3.1 本命令负责
- 检测 aide 运行时环境
- 初始化 .aide 目录
- 分析项目类型和依赖
- 配置环境检测模块
- 执行环境检测和修复
- 处理环境问题
3.2 本命令不负责
- 项目认知和文档载入（由
/aide:load负责） - 任务准备和执行（由
/aide:run负责） - 项目文档管理（由
/aide:docs负责）
四、触发的 Skill
| Skill | 触发方式 | 用途 |
|---|---|---|
| env-config | 强制触发 | 提供详细的环境配置和故障排除指导 |
五、使用场景
5.1 新项目开始
# 用户执行
/aide:setup
# LLM 执行流程
1. 触发 env-config skill
2. aide env ensure --runtime
3. aide init
4. 分析项目（检查 package.json、Cargo.toml 等）
5. aide env set modules <根据项目类型>
6. aide env ensure
7. 汇报结果
5.2 环境问题排查
当任务执行中遇到环境错误时，用户可重新执行此命令进行诊断和修复。
六、相关文档
七、版本信息
- 创建日期：2025-12-15
- 从
/aide:init拆分而来