132 lines
3.2 KiB
Markdown
132 lines
3.2 KiB
Markdown
# Aide 系统设计路线图与优先级
|
||
|
||
## 一、当前状态
|
||
|
||
核心文档 `aide-requirements.md` 已更新，包含：
|
||
- ✅ 项目背景和设计原则
|
||
- ✅ 组件职责定义（Command / Skill）
|
||
- ✅ 命令清单框架（init / prep / exec）
|
||
- ✅ 技能清单框架（flow / decide / env）
|
||
- ✅ 数据格式规范（待定项 JSON）
|
||
- ✅ 数据存储设计（.aide/ 目录）
|
||
- ✅ 实施结构（插件 + 程序目录）
|
||
|
||
待设计内容：
|
||
- [ ] Commands 详细内容
|
||
- [ ] SKILL.md 详细内容
|
||
- [ ] aide flow 子命令详细设计
|
||
- [ ] aide decide Web 界面设计
|
||
- [ ] 配置文件完整字段定义
|
||
|
||
---
|
||
|
||
## 二、设计顺序建议
|
||
|
||
### 方案 A：自顶向下（推荐）
|
||
|
||
```
|
||
Commands 详细内容
|
||
↓
|
||
SKILL.md 详细内容
|
||
↓
|
||
aide flow 详细设计
|
||
↓
|
||
aide decide Web 界面
|
||
↓
|
||
配置文件定义
|
||
```
|
||
|
||
**理由**：
|
||
1. Commands 是用户入口，定义了 LLM 的行为边界
|
||
2. SKILL.md 告诉 LLM 如何调用工具，依赖 Commands 中的流程定义
|
||
3. aide flow / decide 是具体实现，依赖上层设计
|
||
4. 配置文件是辅助，最后定义
|
||
|
||
### 方案 B：核心功能优先
|
||
|
||
```
|
||
aide decide（待定项 Web 界面） ← 最独特的价值点
|
||
↓
|
||
aide flow（进度追踪）
|
||
↓
|
||
Commands + SKILL.md
|
||
↓
|
||
配置文件
|
||
```
|
||
|
||
**理由**：
|
||
1. aide decide 是整个系统最复杂、最有价值的部分
|
||
2. 先做核心功能可以尽早验证
|
||
3. Commands 可以后期完善
|
||
|
||
---
|
||
|
||
## 三、我的建议
|
||
|
||
**推荐方案 A**，原因：
|
||
|
||
1. **Commands 是用户可见的入口**
|
||
- 定义清晰后，后续实现有明确目标
|
||
- 可以从原 `ai-agent-memory/` 提取核心内容
|
||
|
||
2. **先文档后实现符合你的约束**
|
||
- 你提到想先建立核心文档再开发
|
||
- 方案 A 符合这个顺序
|
||
|
||
3. **aide decide 虽然重要但依赖清晰**
|
||
- 它的输入格式（JSON）已经定义好了
|
||
- 可以独立开发，不阻塞其他部分
|
||
|
||
---
|
||
|
||
## 四、下一步行动
|
||
|
||
如果你同意方案 A，我建议按以下顺序进行：
|
||
|
||
### Phase 1：Commands 设计
|
||
1. `/aide:init` - 从原体系提取项目认知+环境检测的要点
|
||
2. `/aide:prep` - 从原 `AI-AGENT_preparation.md` 提取核心流程
|
||
3. `/aide:exec` - 从原 `AI-AGENT_execution.md` 提取核心流程
|
||
|
||
每个 Command 我会产出：
|
||
- 详细的 `.md` 文件内容
|
||
- frontmatter 配置
|
||
- 与 aide 工具的交互点说明
|
||
|
||
### Phase 2：SKILL.md 设计
|
||
- aide 程序完整使用说明
|
||
- 所有子命令的参数和输出格式
|
||
- 典型使用示例
|
||
|
||
### Phase 3：aide flow 详细设计
|
||
- 状态机定义（环节 + 步骤）
|
||
- git 集成逻辑
|
||
- 流程校验规则
|
||
- 环节特定行为
|
||
|
||
### Phase 4：aide decide Web 界面
|
||
- 前端页面结构
|
||
- 交互流程
|
||
- API 设计
|
||
|
||
### Phase 5：配置文件
|
||
- 完整字段定义
|
||
- 默认值
|
||
- 注释模板
|
||
|
||
---
|
||
|
||
## 五、需要你确认
|
||
|
||
1. **设计顺序**：同意方案 A（自顶向下）吗？还是偏好方案 B？
|
||
|
||
2. **Commands 设计方式**：
|
||
- 我是否应该直接从 `ai-agent-memory/` 提取并改写？
|
||
- 还是你希望我先列出提取要点让你确认？
|
||
|
||
3. **设计粒度**：
|
||
- 每个 Phase 完成后等你确认再继续？
|
||
- 还是我连续产出，你集中审阅？
|
||
|
||
请在 `reply/` 目录创建回复文档告诉我。
|