sayurinana/agent-aide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

📃 docs: 暂存

Browse Source
This commit is contained in:
sayurinana(vm)
2025-12-18 22:52:53 +08:00
parent 575b07e9e5
commit 0079bd5cd4
14 changed files with 93 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
.aide/project-docs/README.md
View File

@@ -10,9 +10,9 @@
| 指标 | 数值 |
|------|------|
| 总文件数 | 132（排除忽略项） |
| 总目录数 | 53（含 5 个空目录） |
| 代码行数 | 约 20082 行 |
| 总文件数 | 139（排除忽略项） |
| 总目录数 | 47（含 5 个空目录） |
| 代码行数 | 约 21000 行 |
| 主要语言 | Python |
| 被忽略项 | 7 个目录 |
@@ -60,7 +60,7 @@ ccoptimize/
│ ├── diagrams/ PlantUML 流程图
│ ├── logs/ 历史任务归档
│ └── project-docs/ 本文档目录
├── aide-program/ 核心程序（~55 文件）
├── aide-program/ 核心程序（~72 文件）
│ ├── aide/ Python 源码
│ │ ├── core/ 核心模块
│ │ ├── env/ 环境检测
@@ -70,10 +70,10 @@ ccoptimize/
│ ├── docs/ 程序文档
│ ├── lib/ 依赖库
│ └── offline-installer/ 离线安装器
├── aide-marketplace/ 插件市场（~20 文件）
├── aide-marketplace/ 插件市场（~21 文件）
│ ├── .claude-plugin/ 市场配置
│ └── aide-plugin/ Aide 插件（版本 2.0.8）
│ ├── commands/ 斜杠命令（含 install-linux/win）
│ └── aide-plugin/ Aide 插件（版本 2.1.0）
│ ├── commands/ 斜杠命令（含 auto-run/install-linux/win）
│ ├── skills/ 技能定义
│ └── docs/ 插件文档
├── docs/ 项目文档
@@ -118,20 +118,21 @@ Aide 是一套面向 LLM 驱动开发的工作流工具，核心设计原则：
| 目录 | 用途 |
|------|------|
| `.aide/decisions/` | 待定项决策记录 |
| `aide-program/.aide/decisions/` | 程序级决策记录 |
| `aide-program/.aide/logs/` | 程序级日志归档 |
| `.aide/diagrams/` | PlantUML 流程图 |
| `discuss/` | 项目讨论记录 |
| `reply/` | 项目回复记录 |
| `statements/` | 声明文档 |
## 被忽略项
| 目录 | 说明 |
|------|------|
| `anthropic-agent-skills/` | 第三方技能库 |
| `.venv/` | 虚拟环境 |
| `.venv/` | 根目录虚拟环境 |
| `aide-program/.venv/` | 程序虚拟环境 |
| `__pycache__/` | Python 字节码 |
| `cache/`, `.cache/`, `test-cache/` | 缓存目录 |
| `cache/`, `.cache/` | 缓存目录 |
| `test-cache/` | 测试缓存目录 |
## 使用指南

28
.aide/project-docs/block-plan.md
View File

@@ -6,10 +6,10 @@
- 项目名称：ccoptimize（Aide 工作流工具优化项目）
- 主要语言：Python
- 总文件数：132（排除忽略项）
- 总目录数：53（含 5 个空目录）
- 总文件数：139（排除忽略项）
- 总目录数：47（含 5 个空目录）
- 被忽略项：7 个目录
- 代码行数：约 20082 行
- 代码行数：约 21000 行
## 完整目录树（简化版 - 前两层）
@@ -25,9 +25,8 @@ ccoptimize/
│ └── project-docs/ 项目文档目录（本文档所在）
├── aide-marketplace/ Aide 插件市场
│ ├── .claude-plugin/ 插件市场配置
│ └── aide-plugin/ Aide 插件源码（版本 2.0.8）
│ └── aide-plugin/ Aide 插件源码（版本 2.1.0）
├── aide-program/ Aide 主程序
│ ├── .aide/ 程序级配置
│ ├── aide/ Python 源码目录
│ ├── bin/ 可执行脚本
│ ├── docs/ 程序文档
@@ -67,8 +66,8 @@ ccoptimize/
### 区块 1：aide-program（核心程序）
- **路径**：`aide-program/`
- **文件数**：约 55 个源码文件
- **空目录**：2 个（decisions/, logs/）
- **文件数**：约 72 个文件（排除 .venv 和 __pycache__）
- **空目录**：0 个
- **状态**：已完成
- **说明**：Aide 命令行工具的核心实现，包括：
- `aide/core/` - 核心功能模块（配置、输出）
@@ -82,26 +81,27 @@ ccoptimize/
### 区块 2：aide-marketplace（插件市场）
- **路径**：`aide-marketplace/`
- **文件数**：约 20 个文件
- **文件数**：约 21 个文件
- **空目录**：0 个
- **状态**：已完成
- **说明**：Aide 插件市场和 aide-plugin 源码（版本 2.0.8），包括：
- **说明**：Aide 插件市场和 aide-plugin 源码（版本 2.1.0），包括：
- `.claude-plugin/` - 市场配置
- `aide-plugin/commands/` - 斜杠命令定义（含 install-linux、install-win）
- `aide-plugin/commands/` - 斜杠命令定义（含 auto-run、install-linux、install-win）
- `aide-plugin/skills/` - 技能定义
- `aide-plugin/docs/` - 插件文档
### 区块 3：项目配置与文档（合并原区块 3 和 4）
- **路径**：`.aide/`, `docs/`, `discuss/`, `reply/`, `statements/`, 根目录配置文件
- **文件数**：约 25 个文件
- **空目录**：3 个（discuss/, reply/, statements/）
- **文件数**：约 46 个文件
- **空目录**：5 个（.aide/decisions/, .aide/diagrams/, discuss/, reply/, statements/）
- **状态**：已完成
- **说明**：项目级配置、Aide 数据目录和项目文档资源，包括：
- `.aide/config.toml` - 项目配置
- `.aide/branches.json/.md` - 分支概况数据
- `.aide/pending-items.json` - 待定项数据
- `.aide/diagrams/` - 流程图
- `.aide/decisions/` - [空目录] 待定项决策记录
- `.aide/diagrams/` - [空目录] PlantUML 流程图
- `.aide/logs/` - 历史任务归档
- `docs/` - 指南和概览文档
- `discuss/`, `reply/`, `statements/` - [空目录]
- 根目录 `.md` 文件

33
.aide/project-docs/blocks/aide-marketplace.md
View File

@@ -15,8 +15,9 @@ aide-marketplace/
│ └── marketplace.json 市场元数据
└── aide-plugin/ Aide 插件
├── .claude-plugin/ 插件配置
│ └── plugin.json 插件元数据（版本 2.0.8）
│ └── plugin.json 插件元数据（版本 2.1.0）
├── commands/ 斜杠命令定义
│ ├── auto-run.md /aide:auto-run 全自动任务执行（572 行）
│ ├── docs.md /aide:docs 文档管理（400 行）
│ ├── install-linux.md /aide:install-linux Linux 环境安装（692 行）
│ ├── install-win.md /aide:install-win Windows 环境安装
@@ -49,7 +50,8 @@ aide-marketplace/
| 文件 | 类型 | 说明 |
|------|------|------|
| .claude-plugin/marketplace.json | 配置 | 市场元数据，定义市场名和插件列表 |
| aide-plugin/.claude-plugin/plugin.json | 配置 | 插件元数据，版本 2.0.8 |
| aide-plugin/.claude-plugin/plugin.json | 配置 | 插件元数据，版本 2.1.0 |
| aide-plugin/commands/auto-run.md | Command | /aide:auto-run 全自动任务执行流程 |
| aide-plugin/commands/docs.md | Command | /aide:docs 项目文档管理流程 |
| aide-plugin/commands/install-linux.md | Command | /aide:install-linux Linux 环境安装流程 |
| aide-plugin/commands/install-win.md | Command | /aide:install-win Windows 环境安装流程 |
@@ -73,11 +75,12 @@ aide-marketplace/
| `/aide:load` | 项目认知载入 | aide | 否（由 run 调用） |
| `/aide:docs` | 项目文档创建和维护 | aide | 是 |
| `/aide:run` | 任务执行（核心命令） | aide | 否 |
| `/aide:auto-run` | 全自动任务执行 | aide, task-parser | 是 |
### /aide:run 工作流程
```
task-optimize → flow-design → impl → verify → docs → finish
task-optimize → flow-design → impl → verify → docs → confirm → finish
│ │
├─ 任务分析 ├─ 流程图设计
├─ 复杂度评估 └─ PlantUML 校验
@@ -85,6 +88,23 @@ task-optimize → flow-design → impl → verify → docs → finish
└─ 生成任务细则
```
### /aide:auto-run 工作流程
`/aide:run` 的自动化版本，去除所有需要用户参与的环节：
```
task-optimize → flow-design → impl → verify → docs → finish
│ │
├─ 待定项自动决策 └─ 跳过 confirm 阶段
└─ 任务细则自动确认
```
**与 /aide:run 的区别**：
- 待定项自动决策（无需用户 Web 确认）
- 任务细则自动确认（无需用户确认）
- 跳过 confirm 阶段（无需用户验收）
- 错误自动处理（优先委托子代理，否则自行解决）
### Skills（技能）
| 技能 | 触发方式 | 职责 |
@@ -140,7 +160,7 @@ task-optimize → flow-design → impl → verify → docs → finish
```json
{
"name": "aide-plugin",
"version": "2.0.8",
"version": "2.1.0",
"description": "Aide 工作流体系插件"
}
```
@@ -156,6 +176,9 @@ task-optimize → flow-design → impl → verify → docs → finish
- Commands 定义"做什么"和"按什么顺序做"
- Skills 定义"怎么调用工具"
2. **版本管理**：当前版本 2.0.8，原 `/aide:init`、`/aide:prep`、`/aide:exec` 已重组为 `/aide:setup`、`/aide:load`、`/aide:docs`、`/aide:run`，并新增 `/aide:install-linux`、`/aide:install-win` 环境安装命令
2. **版本管理**：当前版本 2.1.0
- 2.0.8 → 2.1.0：新增 `/aide:auto-run` 全自动任务执行命令
- 原 `/aide:init`、`/aide:prep`、`/aide:exec` 已重组为 `/aide:setup`、`/aide:load`、`/aide:docs`、`/aide:run`
- 新增 `/aide:install-linux`、`/aide:install-win` 环境安装命令
3. **触发机制**：Skills 按需触发，避免信息过载

3
.aide/project-docs/blocks/aide-program.md
View File

@@ -11,9 +11,6 @@ Aide 命令行工具的核心实现，提供环境检测、流程追踪、待定
```
aide-program/
├── .aide/ 程序级 Aide 配置
│ ├── config.toml 配置文件
│ └── decisions/ [空目录] 决策记录
├── aide/ Python 源码包
│ ├── __init__.py 包入口（docstring）
│ ├── __main__.py 模块入口

2
.aide/project-docs/blocks/project-config-docs.md
View File

@@ -154,6 +154,8 @@ Claude Code 功能的完整指南系列：
| 目录 | 用途推断 |
|------|----------|
| .aide/decisions/ | 待定项决策记录存放目录 |
| .aide/diagrams/ | PlantUML 流程图存放目录 |
| discuss/ | 项目讨论记录存放目录 |
| reply/ | 项目回复记录存放目录 |
| statements/ | 声明文档目录（历史文件已清理） |