diff --git a/aide-marketplace/aide-plugin/commands/exec.md b/aide-marketplace/aide-plugin/commands/exec.md
index 1bafd55..2bba690 100644
--- a/aide-marketplace/aide-plugin/commands/exec.md
+++ b/aide-marketplace/aide-plugin/commands/exec.md
@@ -76,7 +76,7 @@ aide flow next-part main "流程设计完成,进入实现环节"
---
-## 环节 2:迭代实现 (main)
+## 环节 2:迭代实现 (impl)
### 按计划执行
diff --git a/aide-marketplace/aide-plugin/commands/init.md b/aide-marketplace/aide-plugin/commands/init.md
index 47baa85..b31ef33 100644
--- a/aide-marketplace/aide-plugin/commands/init.md
+++ b/aide-marketplace/aide-plugin/commands/init.md
@@ -21,6 +21,8 @@ aide env ensure --runtime
- `✓`:aide 运行时就绪,继续
- `✗`:按提示修复后重试,无法修复则告知用户
+> **重要**:`--runtime` 参数表示仅检查 aide 自身运行环境,不依赖项目配置文件
+
### 2. Aide 数据目录初始化
```bash
@@ -59,7 +61,9 @@ aide env ensure
- `⚠`:有警告但可继续,记录并继续
- `✗`:按提示修复,3次失败则告知用户
-**注意**:aide env 会输出项目配置信息,包括默认的任务文档路径,记住这些信息供后续使用。
+**注意**:
+- 此时不带 `--runtime` 参数,会读取项目配置文件检查项目环境
+- aide env 会输出项目配置信息,包括默认的任务文档路径,记住这些信息供后续使用
### 5. 汇报就绪状态
diff --git a/aide-marketplace/aide-plugin/commands/prep.md b/aide-marketplace/aide-plugin/commands/prep.md
index a981ee2..306ef48 100644
--- a/aide-marketplace/aide-plugin/commands/prep.md
+++ b/aide-marketplace/aide-plugin/commands/prep.md
@@ -16,6 +16,12 @@ argument-hint: [任务原文档路径]
## 开始
+### 启动流程追踪
+
+```bash
+aide flow start task-optimize "开始任务准备: <任务简述>"
+```
+
### 确定任务文档
```bash
@@ -28,12 +34,6 @@ aide config get task.source
读取任务文档内容。如文档不存在,询问用户提供任务内容或指定文档路径。
-### 启动流程追踪
-
-```bash
-aide flow start task-optimize "开始任务准备: <任务简述>"
-```
-
---
## 阶段 1:任务分析
@@ -170,6 +170,10 @@ aide flow next-step "用户确认任务细则"
任务准备完成,任务细则已保存。
+```bash
+aide flow next-step "任务准备完成"
+```
+
提示用户:
```
任务细则已保存到 task-spec.md
diff --git a/aide-marketplace/aide-plugin/skills/aide/SKILL.md b/aide-marketplace/aide-plugin/skills/aide/SKILL.md
index f5d84be..dd7d849 100644
--- a/aide-marketplace/aide-plugin/skills/aide/SKILL.md
+++ b/aide-marketplace/aide-plugin/skills/aide/SKILL.md
@@ -27,9 +27,16 @@ Aide 是一套命令行工具,用于支持 Aide 工作流体系。所有 aide
检测并修复开发环境。
```bash
+# 检查项目开发环境
aide env ensure
+
+# 仅检查 aide 运行时环境(不依赖配置文件)
+aide env ensure --runtime
```
+**参数**:
+- `--runtime`:仅检查 aide 程序自身运行所需的环境(Python 等),不读取项目配置文件
+
**输出示例**:
```
✓ 环境就绪 (python:3.12, uv:0.4.0)
@@ -60,7 +67,7 @@ aide flow start <环节名> "<总结>"
```
**参数**:
-- `<环节名>`:flow-design / impl / verify / docs / finish
+- `<环节名>`:task-optimize / flow-design / impl / verify / docs / finish
- `<总结>`:本次操作的简要说明
**示例**:
@@ -148,13 +155,14 @@ aide flow error "数据库连接失败,无法继续"
### 环节名称列表
-| 环节名 | 说明 |
-|-------|------|
-| `flow-design` | 流程设计 |
-| `impl` | 迭代实现 |
-| `verify` | 验证交付 |
-| `docs` | 文档更新 |
-| `finish` | 收尾 |
+| 环节名 | 说明 | 使用场景 |
+|-------|------|---------|
+| `task-optimize` | 任务优化 | prep 阶段使用 |
+| `flow-design` | 流程设计 | exec 阶段使用 |
+| `impl` | 迭代实现 | exec 阶段使用 |
+| `verify` | 验证交付 | exec 阶段使用 |
+| `docs` | 文档更新 | exec 阶段使用 |
+| `finish` | 收尾 | exec 阶段使用 |
### 流程校验
@@ -326,23 +334,31 @@ aide init
## 常见用法示例
-### 开始新任务
+### prep 阶段示例
```bash
-aide flow start flow-design "开始任务: 实现用户认证模块"
+# 开始任务准备
+aide flow start task-optimize "开始任务准备: 实现用户认证模块"
+
+# 记录分析进度
+aide flow next-step "任务分析完成"
+aide flow next-step "任务优化完成,生成待定项"
+aide flow next-step "用户完成待定项确认"
+aide flow next-step "任务准备完成"
```
-### 记录实现进度
+### exec 阶段示例
```bash
+# 开始流程设计
+aide flow start flow-design "开始任务: 实现用户认证模块"
+
+# 记录实现进度
aide flow next-step "完成 User 模型定义"
aide flow next-step "完成密码加密工具"
aide flow next-step "完成登录接口"
-```
-### 进入下一环节
-
-```bash
+# 进入下一环节
aide flow next-part verify "实现完成,开始验证"
```
diff --git a/aide-requirements.md b/aide-requirements.md
index bb5ffcc..06e12fc 100755
--- a/aide-requirements.md
+++ b/aide-requirements.md
@@ -91,9 +91,17 @@
**触发时机**:进入项目开始工作时
**职责**:
-1. 触发 LLM 对项目内容的主动认知
-2. 检测开发环境并自动修复问题
-3. 介绍 aide 流程体系和可用能力
+1. 检测 aide 运行时环境(不依赖配置文件)
+2. 初始化 .aide 目录和配置文件
+3. 触发 LLM 对项目内容的主动认知
+4. 检测项目开发环境并自动修复问题
+5. 介绍 aide 流程体系和可用能力
+
+**执行顺序**:
+1. `aide env ensure --runtime` - 检查 aide 自身运行环境
+2. `aide init` - 创建配置文件
+3. 项目认知
+4. `aide env ensure` - 检查项目环境
**特点**:
- 环境问题在此阶段解决,避免后续业务逻辑被打扰
@@ -103,33 +111,48 @@
**触发时机**:准备开始新任务时
+**参数**:
+- `[任务原文档路径]`(可选):未传入时使用配置中的默认路径(通常为 task-now.md)
+
**职责**:
-1. 任务分析(理解目标、识别复杂度、分析环境)
-2. 任务优化(准确性、简洁性、可执行性)
-3. 待定项处理(通过 `aide decide` 程序化呈现)
-4. 结果生成(LLM 自由发挥,产出 task-spec.md)
+1. 启动流程追踪(`aide flow start task-optimize`)
+2. 任务分析(理解目标、识别复杂度、分析环境)
+3. 任务优化(准确性、简洁性、可执行性)
+4. 待定项处理(通过 `aide decide` 程序化呈现)
+5. 结果生成(LLM 自由发挥,产出 task-spec.md)
**核心原则**:
- 分析和优化阶段:指导 LLM 思考方向,让其竭尽全力发挥
- 待定项处理:程序化呈现,减少 token 污染
- 结果生成:不受格式限制,由用户直接审阅
+- 流程管理:通过 `aide flow` 自动处理状态记录和 git 提交
**运行特点**:
-- 轻量化:不创建工作目录、不记录状态、不 git 提交
+- 使用 task-optimize 环节进行流程追踪
+- LLM 不需要主动关注 git 操作和状态记录
### 4.3 /aide:exec - 任务执行
**触发时机**:任务准备完成,开始执行时
+**参数**:
+- `[任务细则文档路径]`(可选):未传入时使用配置中的默认路径(通常为 task-spec.md)
+
**职责**:
-1. 流程规划(理解细则、制定计划、环境准备)
-2. 迭代实现(按计划执行、状态同步、阻塞处理)
-3. 验证交付(对照标准、功能验证)
-4. 文档收尾(变更记录、版本发布)
+1. 流程设计(理解细则、制定计划、环境准备)- flow-design 环节
+2. 迭代实现(按计划执行、状态同步、阻塞处理)- impl 环节
+3. 验证交付(对照标准、功能验证)- verify 环节
+4. 文档更新(变更记录、版本发布)- docs 环节
+5. 收尾(清理、总结)- finish 环节
**核心原则**:
- 业务代码编写:LLM 自由发挥,不加程序约束
- 状态管理、版本控制:通过 `aide flow` 程序处理,避免信息污染
+- 流程管理:通过 `aide flow` 自动处理状态记录和 git 提交
+
+**运行特点**:
+- LLM 不需要主动关注 git 操作和状态记录
+- 专注于任务实现本身
---
@@ -152,8 +175,8 @@
- 集成 git 操作:每次步骤变化自动 `git add . && git commit`
- 流程校验:检测环节跳转是否符合预期流程
- 环节特定行为:
- - flow-design 环节:检验 PlantUML 语法
- - docs-upgrade 环节:检验 CHANGELOG 更新
+ - flow-design 环节:检验 PlantUML 语法,生成 PNG 流程图
+ - docs 环节:检验 CHANGELOG 更新
- 静默原则:无输出 = 正常
### 5.2 aide decide - 待定项确认
@@ -176,9 +199,11 @@
**用途**:检测并修复项目开发环境
**核心命令**:
-- `aide env ensure` - 检测环境并自动修复
+- `aide env ensure` - 检测项目环境并自动修复
+- `aide env ensure --runtime` - 仅检测 aide 运行时环境(不依赖配置文件)
**设计要点**:
+- `--runtime` 参数用于 init 阶段,在配置文件创建前检查 aide 自身运行环境
- 成功时输出极简:`✓ 环境就绪 (python:3.12)`
- 自动修复小问题时简短提示
- 仅无法修复时才需要 LLM 关注
diff --git a/discuss/03-re-03意见调整完成报告.md b/discuss/03-re-03意见调整完成报告.md
new file mode 100644
index 0000000..1c225ff
--- /dev/null
+++ b/discuss/03-re-03意见调整完成报告.md
@@ -0,0 +1,206 @@
+# re-03 意见调整完成报告
+
+## 一、调整概述
+
+根据 `reply/re-03.md` 中提出的意见,已完成对 commands 和 SKILL.md 的调整。
+
+---
+
+## 二、调整内容详情
+
+### 2.1 init 命令执行顺序优化
+
+**问题**:原设计中先执行 `aide env ensure` 再执行 `aide init`,但 env 检查需要配置文件,而配置文件在 init 时创建,存在逻辑矛盾。
+
+**解决方案**:拆分 env 检查为两个阶段:
+
+1. **aide env ensure --runtime**
+ - 仅检查 aide 程序自身运行环境
+ - 不依赖项目配置文件
+ - 确保 Python 等基础环境可用
+
+2. **aide init**
+ - 创建 `.aide/` 目录
+ - 生成默认配置文件
+ - 更新 `.gitignore`
+
+3. **aide env ensure**
+ - 读取项目配置文件
+ - 检查项目开发环境
+ - 输出项目配置信息
+
+**调整文件**:
+- `aide-marketplace/aide-plugin/commands/init.md`
+- `aide-marketplace/aide-plugin/skills/aide/SKILL.md`
+- `aide-requirements.md`
+
+---
+
+### 2.2 prep 和 exec 流程指导优化
+
+**问题**:prep 和 exec 命令中主动向 LLM 提示 git 操作、状态记录等内容,但这些已经被 `aide flow` 封装,LLM 不应该关注这些自动化操作。
+
+**解决方案**:
+
+1. **移除主动提示**:不再在 commands 中提示 LLM 关注 git 操作和状态记录
+2. **添加注意事项**:在 prep.md 和 exec.md 末尾添加注意事项,明确说明:
+ - 不要主动提及 git 操作
+ - 不要主动提及状态记录
+ - 专注于核心工作(prep 专注任务分析优化,exec 专注任务实现)
+
+**调整文件**:
+- `aide-marketplace/aide-plugin/commands/prep.md`
+- `aide-marketplace/aide-plugin/commands/exec.md`
+
+---
+
+### 2.3 prep 流程追踪启动时机调整
+
+**问题**:原设计中 prep 在确定任务文档后才启动流程追踪,但应该在最开始就执行 `aide flow`。
+
+**解决方案**:
+
+1. **调整执行顺序**:
+ - 先执行 `aide flow start task-optimize "开始任务准备: <任务简述>"`
+ - 再确定任务文档路径
+ - 然后读取任务文档内容
+
+2. **更新环节名称**:
+ - prep 阶段使用 `task-optimize` 环节
+ - exec 阶段使用 `flow-design` / `impl` / `verify` / `docs` / `finish` 环节
+
+**调整文件**:
+- `aide-marketplace/aide-plugin/commands/prep.md`
+- `aide-marketplace/aide-plugin/skills/aide/SKILL.md`
+- `aide-requirements.md`
+
+---
+
+### 2.4 参数传递支持
+
+**问题**:prep 和 exec 命令应该支持传入文档路径参数,未传入时使用配置文件中的默认路径。
+
+**解决方案**:
+
+1. **prep 命令参数**:
+ - 参数:`[任务原文档路径]`(可选)
+ - 未传入时:使用 `aide config get task.source` 获取默认路径(通常为 task-now.md)
+
+2. **exec 命令参数**:
+ - 参数:`[任务细则文档路径]`(可选)
+ - 未传入时:使用 `aide config get task.spec` 获取默认路径(通常为 task-spec.md)
+
+**调整文件**:
+- `aide-marketplace/aide-plugin/commands/prep.md`
+- `aide-marketplace/aide-plugin/commands/exec.md`
+- `aide-requirements.md`
+
+---
+
+## 三、文件修改清单
+
+### 3.1 Commands 文件
+
+| 文件 | 主要修改 |
+|------|---------|
+| `init.md` | 1. 添加 `--runtime` 参数说明
2. 调整执行顺序为:runtime检查 → init → 项目认知 → 项目环境检查 |
+| `prep.md` | 1. 调整流程追踪启动时机到最开始
2. 添加参数说明
3. 添加注意事项(不主动提及git和状态记录) |
+| `exec.md` | 1. 添加参数说明
2. 添加注意事项(不主动提及git和状态记录) |
+
+### 3.2 SKILL.md 文件
+
+| 修改项 | 内容 |
+|-------|------|
+| aide env ensure | 添加 `--runtime` 参数说明 |
+| aide flow start | 更新环节名称列表,添加 `task-optimize` |
+| 环节名称列表 | 添加使用场景列,区分 prep 和 exec 阶段 |
+| 常见用法示例 | 拆分为 prep 阶段示例和 exec 阶段示例 |
+
+### 3.3 aide-requirements.md 文件
+
+| 章节 | 修改内容 |
+|------|---------|
+| 4.1 /aide:init | 添加执行顺序说明,明确三步流程 |
+| 4.2 /aide:prep | 添加参数说明,更新职责列表,添加流程管理说明 |
+| 4.3 /aide:exec | 添加参数说明,明确各环节名称,添加运行特点说明 |
+| 5.1 aide flow | 更新环节名称列表,添加使用场景列 |
+| 5.3 aide env | 添加 `--runtime` 参数说明 |
+
+---
+
+## 四、设计改进总结
+
+### 4.1 解决的核心问题
+
+1. **环境检查依赖问题**:通过 `--runtime` 参数解决了配置文件依赖的循环问题
+2. **信息污染问题**:明确 LLM 不需要关注自动化操作,专注核心业务
+3. **流程完整性**:prep 阶段从一开始就启动流程追踪,保证完整性
+4. **灵活性提升**:支持参数传递,同时保持默认配置的便利性
+
+### 4.2 设计原则体现
+
+1. **确定性封装**:git 操作和状态记录完全由程序处理
+2. **渐进式披露**:LLM 只看到必要的信息,不被实现细节干扰
+3. **关注点分离**:Commands 专注流程指导,Skills 专注工具说明
+
+---
+
+## 五、后续建议
+
+### 5.1 需要在程序实现中注意的点
+
+1. **aide env ensure --runtime**
+ - 必须不依赖任何配置文件
+ - 只检查 Python、pip/uv 等基础环境
+ - 失败时给出明确的修复建议
+
+2. **aide flow 环节校验**
+ - 需要区分 prep 和 exec 阶段的环节
+ - task-optimize 只能在 prep 阶段使用
+ - flow-design/impl/verify/docs/finish 只能在 exec 阶段使用
+
+3. **配置文件默认值**
+ - task.source 默认为 "task-now.md"
+ - task.spec 默认为 "task-spec.md"
+ - 这些默认值应该在 aide init 时写入配置文件
+
+### 5.2 文档完整性检查
+
+所有调整已完成,文档之间保持一致:
+- ✅ Commands 与 SKILL.md 一致
+- ✅ Commands 与 aide-requirements.md 一致
+- ✅ SKILL.md 与 aide-requirements.md 一致
+
+---
+
+## 六、验证要点
+
+在实际使用时,应验证以下场景:
+
+1. **init 流程**:
+ - 在没有 Python 的环境下,`aide env ensure --runtime` 应该报错
+ - 在没有配置文件的情况下,`aide init` 应该成功创建
+ - 创建配置文件后,`aide env ensure` 应该能读取配置
+
+2. **prep 流程**:
+ - 不传参数时,应该使用配置中的默认路径
+ - 传入参数时,应该使用指定路径
+ - 整个过程不应该有 git 操作的提示
+
+3. **exec 流程**:
+ - 环节跳转应该符合预期流程
+ - flow-design 环节应该检查 PlantUML 语法
+ - docs 环节应该检查 CHANGELOG 更新
+
+---
+
+## 七、总结
+
+本次调整完全响应了 re-03 中提出的所有意见:
+
+1. ✅ 解决了 init 命令的执行顺序问题
+2. ✅ 移除了 prep 和 exec 中对 git 操作的主动提示
+3. ✅ 调整了 prep 的流程追踪启动时机
+4. ✅ 添加了参数传递支持
+
+所有修改都遵循了 aide 系统的核心设计原则,保持了文档的一致性和完整性。