[aide] impl: 子计划6完成:同步更新所有相关文档
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"task_id": "2025-12-16T20-22-50",
|
||||
"current_phase": "impl",
|
||||
"current_step": 9,
|
||||
"current_step": 10,
|
||||
"started_at": "2025-12-16T20:22:50+08:00",
|
||||
"history": [
|
||||
{
|
||||
@@ -73,7 +73,15 @@
|
||||
"action": "next-step",
|
||||
"phase": "impl",
|
||||
"step": 9,
|
||||
"summary": "子计划5完成:调整 aide flow 的 git 提交顺序"
|
||||
"summary": "子计划5完成:调整 aide flow 的 git 提交顺序",
|
||||
"git_commit": "18047787b28d002a8df1dfe6c21d694f9eb7534c"
|
||||
},
|
||||
{
|
||||
"timestamp": "2025-12-16T20:37:04+08:00",
|
||||
"action": "next-step",
|
||||
"phase": "impl",
|
||||
"step": 10,
|
||||
"summary": "子计划6完成:同步更新所有相关文档"
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
@@ -1 +1 @@
|
||||
81279
|
||||
82752
|
||||
@@ -1,7 +1,7 @@
|
||||
# Aide 项目导览
|
||||
|
||||
> 本文档面向 LLM,用于快速了解项目结构和脉络。
|
||||
> 最后更新:2025-12-15
|
||||
> 最后更新:2025-12-16
|
||||
|
||||
## 项目简介
|
||||
|
||||
@@ -23,7 +23,7 @@ Aide 是一套面向 Claude Code 的工作流辅助体系,旨在解决 AI 辅
|
||||
▼
|
||||
aide-plugin (Claude Code 插件)
|
||||
├── Commands: /aide:setup, /aide:load, /aide:docs, /aide:run
|
||||
└── Skills: aide, env-config
|
||||
└── Skills: aide, env-config, task-parser
|
||||
│
|
||||
▼ 调用
|
||||
aide-program (命令行工具)
|
||||
@@ -66,13 +66,19 @@ aide-program (命令行工具)
|
||||
|
||||
## 标准工作流程
|
||||
|
||||
1. **task-optimize** - 任务优化:分析任务、识别待定项
|
||||
2. **flow-design** - 流程设计:创建 PlantUML 流程图
|
||||
1. **task-optimize** - 任务优化:分析任务、识别待定项、口语化内容解析
|
||||
2. **flow-design** - 流程设计:创建 PlantUML 流程图(任务流程图 + 程序逻辑流图)
|
||||
3. **impl** - 迭代实现:按计划执行
|
||||
4. **verify** - 验证交付:对照任务细则验证
|
||||
5. **docs** - 文档更新:更新相关文档
|
||||
6. **finish** - 收尾:清理临时文件、汇报完成
|
||||
|
||||
## 最近更新(2025-12-16)
|
||||
|
||||
- 新增 `task-parser` skill:口语化任务内容解析
|
||||
- 强化流程图规范:区分任务执行流程图和程序逻辑流图
|
||||
- 优化 `aide flow` git 提交顺序:状态先保存再提交
|
||||
|
||||
## 输出格式约定
|
||||
|
||||
| 前缀 | 含义 |
|
||||
|
||||
@@ -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 命令行工具
|
||||
|
||||
## 注意事项
|
||||
|
||||
@@ -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 上下文占用
|
||||
|
||||
@@ -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 目录变更被包含
|
||||
|
||||
Reference in New Issue
Block a user