✨ feat: 文档同步

aide-marketplace/aide-plugin/docs/commands/setup.md

@@ -0,0 +1,140 @@
+# /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` 拆分而来