141 lines
4.9 KiB
Markdown
141 lines
4.9 KiB
Markdown
|
# /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 新项目开始
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 用户执行
|
|||
|
|
/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 环境问题排查
|
|||
|
|
|
|||
|
|
当任务执行中遇到环境错误时，用户可重新执行此命令进行诊断和修复。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 六、相关文档
|
|||
|
|
|
|||
|
|
- [执行文件](../../commands/setup.md)
|
|||
|
|
- [env-config skill](../../skills/env-config/SKILL.md)
|
|||
|
|
- [aide env 子命令](../../../../aide-program/docs/commands/env.md)
|
|||
|
|
- [plugin 导览](../README.md)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 七、版本信息
|
|||
|
|
|
|||
|
|
- 创建日期：2025-12-15
|
|||
|
|
- 从 `/aide:init` 拆分而来
|