✨ feat: 完成commands和skills

aide-marketplace/aide-plugin/commands/exec.md

@@ -76,7 +76,7 @@ aide flow next-part main "流程设计完成，进入实现环节"
 
 ---
 
-## 环节 2：迭代实现 (main)
+## 环节 2：迭代实现 (impl)
 
 ### 按计划执行
 

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. 汇报就绪状态
 

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

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` | 流程设计 |
+| `task-optimize` | 任务优化 | prep 阶段使用 |
-| `impl` | 迭代实现 |
+| `flow-design` | 流程设计 | exec 阶段使用 |
-| `verify` | 验证交付 |
+| `impl` | 迭代实现 | exec 阶段使用 |
-| `docs` | 文档更新 |
+| `verify` | 验证交付 | exec 阶段使用 |
-| `finish` | 收尾 |
+| `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 "实现完成，开始验证"
 ```
 

aide-requirements.md

@@ -91,9 +91,17 @@
 **触发时机**：进入项目开始工作时
 
 **职责**：
-1. 触发 LLM 对项目内容的主动认知
+1. 检测 aide 运行时环境（不依赖配置文件）
-2. 检测开发环境并自动修复问题
+2. 初始化 .aide 目录和配置文件
-3. 介绍 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. 任务分析（理解目标、识别复杂度、分析环境）
+1. 启动流程追踪（`aide flow start task-optimize`）
-2. 任务优化（准确性、简洁性、可执行性）
+2. 任务分析（理解目标、识别复杂度、分析环境）
-3. 待定项处理（通过 `aide decide` 程序化呈现）
+3. 任务优化（准确性、简洁性、可执行性）
-4. 结果生成（LLM 自由发挥，产出 task-spec.md）
+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. 流程规划（理解细则、制定计划、环境准备）
+1. 流程设计（理解细则、制定计划、环境准备）- flow-design 环节
-2. 迭代实现（按计划执行、状态同步、阻塞处理）
+2. 迭代实现（按计划执行、状态同步、阻塞处理）- impl 环节
-3. 验证交付（对照标准、功能验证）
+3. 验证交付（对照标准、功能验证）- verify 环节
-4. 文档收尾（变更记录、版本发布）
+4. 文档更新（变更记录、版本发布）- docs 环节
+5. 收尾（清理、总结）- finish 环节
 
 **核心原则**：
 - 业务代码编写：LLM 自由发挥，不加程序约束
 - 状态管理、版本控制：通过 `aide flow` 程序处理，避免信息污染
+- 流程管理：通过 `aide flow` 自动处理状态记录和 git 提交
+
+**运行特点**：
+- LLM 不需要主动关注 git 操作和状态记录
+- 专注于任务实现本身
 
 ---
 
@@ -152,8 +175,8 @@
 - 集成 git 操作：每次步骤变化自动 `git add . && git commit`
 - 流程校验：检测环节跳转是否符合预期流程
 - 环节特定行为：
-  - flow-design 环节：检验 PlantUML 语法
+  - flow-design 环节：检验 PlantUML 语法，生成 PNG 流程图
-  - docs-upgrade 环节：检验 CHANGELOG 更新
+  - 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 关注

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` 参数说明<br>2. 调整执行顺序为：runtime检查 → init → 项目认知 → 项目环境检查 |
+| `prep.md` | 1. 调整流程追踪启动时机到最开始<br>2. 添加参数说明<br>3. 添加注意事项（不主动提及git和状态记录） |
+| `exec.md` | 1. 添加参数说明<br>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 系统的核心设计原则，保持了文档的一致性和完整性。