# Aide 项目概览

本仓库包含三部分产物：
- **aide-marketplace/**：Claude Code 插件目录（commands + skills）
- **aide-program/**：aide 程序实现（本阶段提供初始化、配置与环境管理）
- **ai-agent-memory/** & **docs/**：原始流程文档与参考资料

当前完成情况：插件与文档已就绪，aide 程序已实现基础 CLI，后续将补充 `aide flow` 与 `aide decide` 细节。

## 快速开始（aide 程序）

### 环境准备
1. 确认已安装 `uv`（0.9+）。
2. 在仓库根目录创建虚拟环境并安装依赖：
   ```bash
   uv venv .venv
   uv pip install -r requirements.txt --python .venv
   ```

### 可用命令
- 初始化配置与 .aide 目录（会写入 `.gitignore`）  
  ```bash
  ./aide-program/aide.sh init
  ```
- 检测运行时环境（不读取配置）  
  ```bash
  ./aide-program/aide.sh env ensure --runtime
  ```
- 检测项目环境，确保 `.venv`、`requirements`、任务文档路径等  
  ```bash
  ./aide-program/aide.sh env ensure
  ```
- 读取/设置配置（示例）  
  ```bash
  ./aide-program/aide.sh config get task.source
  ./aide-program/aide.sh config set task.spec task-spec.md
  ```

> Windows 可使用 `aide-program\\aide.bat`，命令参数一致。

### 配置文件
`aide init` 会生成 `.aide/config.toml`，默认字段：
- `runtime.python_min`：最小 Python 版本（默认 3.11）
- `task.source` / `task.spec`：任务原文档与细则文档默认路径
- `env.venv` / `env.requirements`：虚拟环境与依赖文件位置
- `flow.phases`：流程环节名称（flow/decide 功能尚未实现）

## 未完成功能
- `aide flow` 进度追踪、`aide decide` 待定项 Web 界面尚未实现，后续阶段补充。
- 配置写入时暂不保留注释，必要时可重新运行 `aide init` 重置为模板后再调整。

## 参考
- 需求规格：`aide-requirements.md`
- 设计讨论：`discuss/` 目录（Phase 1/2 已完成，当前进入程序实现阶段）