[aide] impl: 子计划6完成:同步更新所有相关文档

This commit is contained in:
2025-12-16 20:37:04 +08:00
parent 18047787b2
commit e070be693e
6 changed files with 71 additions and 19 deletions

View File

@@ -1,7 +1,7 @@
# aide-plugin-commands
> 路径aide-marketplace/aide-plugin/commands/
> 最后更新2025-12-15
> 最后更新2025-12-16
## 概述
@@ -50,15 +50,31 @@ Aide 插件的斜杠命令定义,是面向 LLM 的执行指令文件。
### /aide:run
- **用途**:任务执行(核心命令)
- **触发 skill**aide
- **触发 skill**aide, task-parser按需
- **新增功能**
- 口语化内容检测:在任务分析前检测内容特征
- 自动触发 task-parser skill 解析口语化内容
- 流程图规范:区分任务执行流程图和程序逻辑流图
- **标准流程**
1. task-optimize - 任务准备
2. flow-design - 流程设计
1. task-optimize - 任务准备(含口语化检测)
2. flow-design - 流程设计(含流程图规范)
3. impl - 迭代实现
4. verify - 验证交付
5. docs - 文档更新
6. finish - 收尾
## 流程图要求
### 任务执行流程图(所有任务必需)
- 展示任务执行的步骤顺序
- 体现决策点和依赖关系
### 程序逻辑流图(程序类任务必需)
- 从入口函数开始
- 体现顺序/分支/循环结构
- 语义化抽象,模块化表示
- 支持层次化组织
## 设计原则
- 执行文件给 LLM 看,聚焦执行指令
@@ -67,7 +83,7 @@ Aide 插件的斜杠命令定义,是面向 LLM 的执行指令文件。
## 依赖关系
- 依赖aide skill, env-config skill
- 依赖aide skill, env-config skill, task-parser skill
- 调用aide 命令行工具
## 注意事项

View File

@@ -1,7 +1,7 @@
# aide-plugin-skills
> 路径aide-marketplace/aide-plugin/skills/
> 最后更新2025-12-15
> 最后更新2025-12-16
## 概述
@@ -13,6 +13,7 @@ Aide 插件的技能定义,提供专门知识供 LLM 按需学习。
|------|------|
| `aide/SKILL.md` | aide 基础命令指南(始终加载) |
| `env-config/SKILL.md` | 环境配置详细指南(按需触发) |
| `task-parser/SKILL.md` | 口语化任务内容解析(按需触发) |
## 技能说明
@@ -35,11 +36,23 @@ Aide 插件的技能定义,提供专门知识供 LLM 按需学习。
- 多项目场景处理
- 故障排除指南
### task-parser skill
- **触发方式**:当任务文档或用户对话具有明显口语化特征时触发
- **内容**
- 口语化内容识别标准
- 语义解析方法(表层理解、深层提取、结构重组)
- 批判性分析(逻辑漏洞、盲点、过度设计)
- 建设性优化建议
- 上下文关联分析
- 规范化输出格式
## 设计理念
**Skill 拆分原则**
- `aide` skill基础知识始终需要
- `env-config` skill专门知识仅在配置环境时需要
- `task-parser` skill专门知识仅在解析口语化内容时需要
这样设计的好处:
1. 减少 LLM 上下文占用

View File

@@ -1,7 +1,7 @@
# aide-program-flow
> 路径aide-program/aide/flow/
> 最后更新2025-12-15
> 最后更新2025-12-16
## 概述
@@ -12,7 +12,7 @@
| 文件 | 说明 |
|------|------|
| `__init__.py` | 模块初始化 |
| `tracker.py` | FlowTracker 主逻辑(~200 行) |
| `tracker.py` | FlowTracker 主逻辑(~220 行) |
| `storage.py` | 状态文件读写(~147 行) |
| `types.py` | 数据结构定义(~103 行) |
| `validator.py` | 环节校验器(~50 行) |
@@ -25,7 +25,7 @@
### FlowTracker
- **职责**:编排一次 flow 动作(校验 → hooks → git → 落盘 → 输出)
- **职责**:编排一次 flow 动作(校验 → hooks → 落盘 → git → 输出)
- **位置**`tracker.py:20`
- **关键方法**
- `start(phase, summary)` - 开始新任务
@@ -35,6 +35,8 @@
- `back_part(phase, reason)` - 回退到之前环节
- `issue(description)` - 记录一般问题
- `error(description)` - 记录严重错误
- `_apply_action()` - 应用动作,生成新状态和 commit 消息
- `_do_git_commit()` - 执行 git 操作并更新 commit hash
### FlowStorage
@@ -80,9 +82,15 @@ aide flow show <task_id> # 查看任务详情
## Git 集成
每次 flow 操作自动执行
1. `git add .`
2. `git commit -m "[aide] <phase>: <summary>"`
**执行顺序**(已优化)
1. 运行 pre_commit_hooks
2. 更新 FlowStatus内存
3. 保存状态到磁盘flow-status.json
4. `git add .`
5. `git commit -m "[aide] <phase>: <summary>"`
6. 更新 commit hash 到状态文件
> **关键改进**:状态文件先保存再执行 git 操作,确保 flow-status.json 的更新包含在 commit 中
提交信息格式:
- 正常操作:`[aide] impl: 完成数据库模型设计`
@@ -99,3 +107,4 @@ aide flow show <task_id> # 查看任务详情
- 状态文件使用文件锁防止并发写入
- 归档文件保存在 `.aide/logs/` 目录
- Hooks 支持 PlantUML 自动校验和构建
- Git 提交在状态保存之后执行,确保 .aide 目录变更被包含