91 lines
2.3 KiB
Markdown
91 lines
2.3 KiB
Markdown
---
|
||
description: 项目认知与环境初始化。进入新项目或开始工作前使用，触发对项目的主动认知和环境检测修复。
|
||
argument-hint: [无参数]
|
||
---
|
||
|
||
# Aide 初始化
|
||
|
||
你正在使用 Aide 工作流体系。本命令帮助你快速认知项目并确保环境就绪。
|
||
|
||
## 执行步骤
|
||
|
||
### 1. Aide 运行时环境检测
|
||
|
||
首先确保 aide 程序本身可以正常运行：
|
||
|
||
```bash
|
||
aide env ensure --runtime
|
||
```
|
||
|
||
根据输出处理：
|
||
- `✓`：aide 运行时就绪，继续
|
||
- `✗`：按提示修复后重试，无法修复则告知用户
|
||
|
||
> **重要**：`--runtime` 参数表示仅检查 aide 自身运行环境，不依赖项目配置文件
|
||
|
||
### 2. Aide 数据目录初始化
|
||
|
||
```bash
|
||
aide init
|
||
```
|
||
|
||
此命令会：
|
||
- 创建 `.aide/` 目录（如不存在）
|
||
- 生成默认配置文件 `.aide/config.toml`
|
||
- 检查并更新 `.gitignore`
|
||
|
||
### 3. 项目认知
|
||
|
||
快速建立对项目的整体理解：
|
||
|
||
1. 阅读项目根目录的 `README.md`（如存在）
|
||
2. 阅读 `CLAUDE.md`（如存在）
|
||
3. 浏览项目目录结构，理解核心模块划分
|
||
4. 识别项目类型和主要技术栈
|
||
|
||
向用户简要汇报项目概况（3-5句话）。
|
||
|
||
### 4. 项目环境检测
|
||
|
||
```bash
|
||
aide env ensure
|
||
```
|
||
|
||
此命令会：
|
||
- 读取 `.aide/config.toml` 中的环境配置
|
||
- 检测并修复项目开发环境
|
||
- 输出环境状态和配置信息
|
||
|
||
根据输出处理：
|
||
- `✓`：环境就绪，继续
|
||
- `⚠`：有警告但可继续，记录并继续
|
||
- `✗`：按提示修复，3次失败则告知用户
|
||
|
||
**注意**：
|
||
- 此时不带 `--runtime` 参数，会读取项目配置文件检查项目环境
|
||
- aide env 会输出项目配置信息，包括默认的任务文档路径，记住这些信息供后续使用
|
||
|
||
### 5. 汇报就绪状态
|
||
|
||
向用户汇报：
|
||
|
||
```
|
||
项目概况：[来自步骤3的概要]
|
||
|
||
环境状态：✓ 环境就绪 (python:3.12, ...)
|
||
|
||
项目配置：
|
||
- 任务原文档：task-now.md
|
||
- 任务细则：task-spec.md
|
||
|
||
Aide 已就绪，可用命令：
|
||
- /aide:prep [文档路径] - 任务准备
|
||
- /aide:exec [文档路径] - 任务执行
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. 如果在初始化过程中发现严重环境问题无法解决，建议用户修复后重开对话
|
||
2. 本命令只做认知和环境准备，不修改任何业务代码
|
||
3. 所有输出使用简体中文
|