agent-aide/docs/aide-overview.md

Aide 系统概述

一、系统简介

Aide 是一套面向 Claude Code 的工作流辅助体系，旨在解决 AI 辅助开发中的信息过载、操作不确定性和流程耦合问题。

系统通过 Command + Skill + 专用程序 的架构，将原本堆积在 CLAUDE.md 中的规则和流程转化为按需触发的模块化单元，实现：

• CLAUDE.md 精简化：仅保留项目结构说明，不再堆积规则和流程
• 流程按需触发：通过 Command 主动触发流程指导
• 操作确定性封装：通过 Skill + 程序简化操作，减少不确定性

---

二、核心设计原则

原则	说明
渐进式披露	信息按需加载，用户/LLM 主动调用时才加载相关指引
确定性封装	将可变过程转化为固定接口，只暴露程序和参数
信息隔离	LLM 只传核心语义数据，程序负责格式化和渲染
核心与形式分离	核心信息（分析、决策）由 LLM 发挥，形式问题（状态记录、环境配置）由程序处理

---

三、系统架构

┌─────────────────────────────────────────────────────────────┐
│                        用户                                  │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    aide-plugin                               │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐          │
│  │ /aide:init  │  │ /aide:prep  │  │ /aide:exec  │ Commands │
│  └─────────────┘  └─────────────┘  └─────────────┘          │
│                                                              │
│  ┌─────────────────────────────────────────────┐            │
│  │              aide skill                      │   Skill   │
│  │  (aide 命令使用指南)                         │            │
│  └─────────────────────────────────────────────┘            │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼ 调用
┌─────────────────────────────────────────────────────────────┐
│                    aide-program                              │
│  ┌────────┐  ┌────────┐  ┌────────┐  ┌────────┐            │
│  │  init  │  │  env   │  │  flow  │  │ decide │  子命令    │
│  └────────┘  └────────┘  └────────┘  └────────┘            │
│                                                              │
│  ┌─────────────────────────────────────────────┐            │
│  │           .aide/ 数据目录                    │            │
│  │  config.toml | flow-status.json | decisions/ │            │
│  └─────────────────────────────────────────────┘            │
└─────────────────────────────────────────────────────────────┘

组件关系：

• Commands：定义流程（做什么、按什么顺序做），指导 LLM 的思考方向
• Skill：定义工具使用方法（怎么调用 aide 程序），纯工具说明
• Program：执行具体操作（环境检测、进度追踪、待定项处理），返回精简结果

---

四、子区块索引

4.1 aide-plugin 区块

文档	位置	说明
导览	aide-plugin/docs/README.md	plugin 整体介绍和索引
init 命令	aide-plugin/docs/commands/init.md	项目认知与环境初始化
prep 命令	aide-plugin/docs/commands/prep.md	任务准备流程
exec 命令	aide-plugin/docs/commands/exec.md	任务执行流程
aide skill	aide-plugin/docs/skill/aide.md	aide 命令使用指南

4.2 aide-program 区块

文档	位置	说明
导览	aide-program/docs/README.md	program 整体介绍和索引
env 子命令	aide-program/docs/commands/env.md	环境检测与修复
flow 子命令	aide-program/docs/commands/flow.md	进度追踪与 git 集成
decide 子命令	aide-program/docs/commands/decide.md	待定项 Web 确认
init 子命令	aide-program/docs/commands/init.md	初始化 .aide 目录
配置格式	aide-program/docs/formats/config.md	config.toml 规范
数据格式	aide-program/docs/formats/data.md	待定项、流程状态等格式

---

五、快速导航

想了解/修改 Commands 或 Skill

→ 阅读 aide-plugin 导览

想了解/修改 aide 程序

→ 阅读 aide-program 导览

想了解完整工作流程

/aide:init  →  /aide:prep  →  /aide:exec
   │              │              │
   ▼              ▼              ▼
项目认知      任务准备        任务执行
环境检测      任务分析        流程设计
             任务优化        迭代实现
             待定项处理      验证交付
             生成细则        文档更新

---

六、版本信息

• 当前版本：1.0.0
• 文档拆分自：aide-requirements.md