feat: 核心已定稿,准备讨论

This commit is contained in:
2025-12-13 00:35:36 +08:00
parent 3c05d54303
commit 3628971a6e
13 changed files with 1130 additions and 172 deletions

View 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 1Commands 设计
1. `/aide:init` - 从原体系提取项目认知+环境检测的要点
2. `/aide:prep` - 从原 `AI-AGENT_preparation.md` 提取核心流程
3. `/aide:exec` - 从原 `AI-AGENT_execution.md` 提取核心流程
每个 Command 我会产出:
- 详细的 `.md` 文件内容
- frontmatter 配置
- 与 aide 工具的交互点说明
### Phase 2SKILL.md 设计
- aide 程序完整使用说明
- 所有子命令的参数和输出格式
- 典型使用示例
### Phase 3aide flow 详细设计
- 状态机定义(环节 + 步骤)
- git 集成逻辑
- 流程校验规则
- 环节特定行为
### Phase 4aide decide Web 界面
- 前端页面结构
- 交互流程
- API 设计
### Phase 5配置文件
- 完整字段定义
- 默认值
- 注释模板
---
## 五、需要你确认
1. **设计顺序**:同意方案 A自顶向下还是偏好方案 B
2. **Commands 设计方式**
- 我是否应该直接从 `ai-agent-memory/` 提取并改写?
- 还是你希望我先列出提取要点让你确认?
3. **设计粒度**
- 每个 Phase 完成后等你确认再继续?
- 还是我连续产出,你集中审阅?
请在 `reply/` 目录创建回复文档告诉我。