✨ feat: 核心已定稿,准备讨论
This commit is contained in:
131
discuss/01-设计路线图与优先级.md
Normal file
131
discuss/01-设计路线图与优先级.md
Normal file
@@ -0,0 +1,131 @@
|
||||
# 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/` 目录创建回复文档告诉我。
|
||||
Reference in New Issue
Block a user