feat: 完成commands和skills

This commit is contained in:
2025-12-13 03:28:21 +08:00
parent 7f7e4fd586
commit 52dffe2803
6 changed files with 293 additions and 38 deletions

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