sayurinana/agent-aide
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

✨ feat: 完成commands和skills

Browse Source
This commit is contained in:
sayurinana(vm)
2025-12-13 03:28:21 +08:00
parent 7f7e4fd586
commit 52dffe2803
6 changed files with 293 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
aide-marketplace/aide-plugin/commands/exec.md
View File

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

6
aide-marketplace/aide-plugin/commands/init.md
View File

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

16
aide-marketplace/aide-plugin/commands/prep.md
View File

@@ -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

46
aide-marketplace/aide-plugin/skills/aide/SKILL.md
View File

@@ -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 "实现完成，开始验证"
```

55
aide-requirements.md
View File

@@ -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 关注

206
discuss/03-re-03意见调整完成报告.md Normal file
View File

@@ -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 系统的核心设计原则，保持了文档的一致性和完整性。