✨ feat: 更新了command,上下文爆了
This commit is contained in:
@@ -1,5 +1,6 @@
|
||||
---
|
||||
description: 项目认知与环境初始化。进入新项目或开始工作前使用,触发对项目的主动认知和环境检测修复。
|
||||
argument-hint: [无参数]
|
||||
---
|
||||
|
||||
# Aide 初始化
|
||||
@@ -8,63 +9,78 @@ description: 项目认知与环境初始化。进入新项目或开始工作前
|
||||
|
||||
## 执行步骤
|
||||
|
||||
### 1. 项目认知
|
||||
### 1. Aide 运行时环境检测
|
||||
|
||||
**目标**:快速建立对项目的整体理解
|
||||
首先确保 aide 程序本身可以正常运行:
|
||||
|
||||
```bash
|
||||
aide env ensure --runtime
|
||||
```
|
||||
|
||||
根据输出处理:
|
||||
- `✓`:aide 运行时就绪,继续
|
||||
- `✗`:按提示修复后重试,无法修复则告知用户
|
||||
|
||||
### 2. Aide 数据目录初始化
|
||||
|
||||
```bash
|
||||
aide init
|
||||
```
|
||||
|
||||
此命令会:
|
||||
- 创建 `.aide/` 目录(如不存在)
|
||||
- 生成默认配置文件 `.aide/config.toml`
|
||||
- 检查并更新 `.gitignore`
|
||||
|
||||
### 3. 项目认知
|
||||
|
||||
快速建立对项目的整体理解:
|
||||
|
||||
执行以下操作:
|
||||
1. 阅读项目根目录的 `README.md`(如存在)
|
||||
2. 阅读 `CLAUDE.md`(如存在)
|
||||
3. 浏览项目目录结构,理解核心模块划分
|
||||
4. 识别项目类型(前端/后端/全栈/工具库/文档等)
|
||||
5. 识别主要技术栈和依赖
|
||||
4. 识别项目类型和主要技术栈
|
||||
|
||||
**产出**:向用户简要汇报项目概况(3-5句话)
|
||||
向用户简要汇报项目概况(3-5句话)。
|
||||
|
||||
### 2. 环境检测与修复
|
||||
### 4. 项目环境检测
|
||||
|
||||
**目标**:确保开发环境就绪,避免后续业务逻辑被环境问题打扰
|
||||
|
||||
执行命令:
|
||||
```bash
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
此命令会:
|
||||
- 读取 `.aide/config.toml` 中的环境配置
|
||||
- 检测并修复项目开发环境
|
||||
- 输出环境状态和配置信息
|
||||
|
||||
根据输出处理:
|
||||
- `✓` 开头:环境就绪,继续下一步
|
||||
- `⚠` 开头:有警告但可继续,记录并继续
|
||||
- `✗` 开头:环境有问题,尝试按提示修复,3次失败则停止并告知用户
|
||||
- `✓`:环境就绪,继续
|
||||
- `⚠`:有警告但可继续,记录并继续
|
||||
- `✗`:按提示修复,3次失败则告知用户
|
||||
|
||||
### 3. Aide 数据目录初始化
|
||||
**注意**:aide env 会输出项目配置信息,包括默认的任务文档路径,记住这些信息供后续使用。
|
||||
|
||||
检查 `.aide/` 目录是否存在:
|
||||
- 不存在:执行 `aide init`(会自动创建目录和默认配置)
|
||||
- 已存在:跳过
|
||||
|
||||
检查 `.gitignore` 是否包含 `.aide/`:
|
||||
- 不包含:添加 `.aide/` 到 `.gitignore`
|
||||
- 已包含:跳过
|
||||
|
||||
### 4. 汇报就绪状态
|
||||
### 5. 汇报就绪状态
|
||||
|
||||
向用户汇报:
|
||||
1. 项目概况(来自步骤1)
|
||||
2. 环境状态(来自步骤2)
|
||||
3. 可用的 Aide 命令提示
|
||||
|
||||
示例汇报:
|
||||
```
|
||||
项目概况:这是一个基于 Rust 的 CLI 工具项目,使用 clap 处理命令行参数。
|
||||
项目概况:[来自步骤3的概要]
|
||||
|
||||
环境状态:✓ 环境就绪 (rust:1.75, cargo:1.75)
|
||||
环境状态:✓ 环境就绪 (python:3.12, ...)
|
||||
|
||||
项目配置:
|
||||
- 任务原文档:task-now.md
|
||||
- 任务细则:task-spec.md
|
||||
|
||||
Aide 已就绪,可用命令:
|
||||
- /aide:prep - 开始任务准备(分析优化任务描述)
|
||||
- /aide:exec - 开始任务执行(需要先完成 prep)
|
||||
- /aide:prep [文档路径] - 任务准备
|
||||
- /aide:exec [文档路径] - 任务执行
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **沉没成本小**:如果在初始化过程中发现严重环境问题无法解决,建议用户修复后重开对话
|
||||
2. **不执行业务操作**:本命令只做认知和环境准备,不修改任何业务代码
|
||||
3. **简体中文**:所有输出使用简体中文
|
||||
1. 如果在初始化过程中发现严重环境问题无法解决,建议用户修复后重开对话
|
||||
2. 本命令只做认知和环境准备,不修改任何业务代码
|
||||
3. 所有输出使用简体中文
|
||||
|
||||
Reference in New Issue
Block a user