agent-aide/discuss/01-设计路线图与优先级.md

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/ 目录创建回复文档告诉我。