71 lines
2.1 KiB
Markdown
71 lines
2.1 KiB
Markdown
---
|
||
description: 项目认知与环境初始化。进入新项目或开始工作前使用，触发对项目的主动认知和环境检测修复。
|
||
---
|
||
|
||
# Aide 初始化
|
||
|
||
你正在使用 Aide 工作流体系。本命令帮助你快速认知项目并确保环境就绪。
|
||
|
||
## 执行步骤
|
||
|
||
### 1. 项目认知
|
||
|
||
**目标**：快速建立对项目的整体理解
|
||
|
||
执行以下操作：
|
||
1. 阅读项目根目录的 `README.md`（如存在）
|
||
2. 阅读 `CLAUDE.md`（如存在）
|
||
3. 浏览项目目录结构，理解核心模块划分
|
||
4. 识别项目类型（前端/后端/全栈/工具库/文档等）
|
||
5. 识别主要技术栈和依赖
|
||
|
||
**产出**：向用户简要汇报项目概况（3-5句话）
|
||
|
||
### 2. 环境检测与修复
|
||
|
||
**目标**：确保开发环境就绪，避免后续业务逻辑被环境问题打扰
|
||
|
||
执行命令：
|
||
```bash
|
||
aide env ensure
|
||
```
|
||
|
||
根据输出处理：
|
||
- `✓` 开头：环境就绪，继续下一步
|
||
- `⚠` 开头：有警告但可继续，记录并继续
|
||
- `✗` 开头：环境有问题，尝试按提示修复，3次失败则停止并告知用户
|
||
|
||
### 3. Aide 数据目录初始化
|
||
|
||
检查 `.aide/` 目录是否存在：
|
||
- 不存在：执行 `aide init`（会自动创建目录和默认配置）
|
||
- 已存在：跳过
|
||
|
||
检查 `.gitignore` 是否包含 `.aide/`：
|
||
- 不包含：添加 `.aide/` 到 `.gitignore`
|
||
- 已包含：跳过
|
||
|
||
### 4. 汇报就绪状态
|
||
|
||
向用户汇报：
|
||
1. 项目概况（来自步骤1）
|
||
2. 环境状态（来自步骤2）
|
||
3. 可用的 Aide 命令提示
|
||
|
||
示例汇报：
|
||
```
|
||
项目概况：这是一个基于 Rust 的 CLI 工具项目，使用 clap 处理命令行参数。
|
||
|
||
环境状态：✓ 环境就绪 (rust:1.75, cargo:1.75)
|
||
|
||
Aide 已就绪，可用命令：
|
||
- /aide:prep - 开始任务准备（分析优化任务描述）
|
||
- /aide:exec - 开始任务执行（需要先完成 prep）
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **沉没成本小**：如果在初始化过程中发现严重环境问题无法解决，建议用户修复后重开对话
|
||
2. **不执行业务操作**：本命令只做认知和环境准备，不修改任何业务代码
|
||
3. **简体中文**：所有输出使用简体中文
|