diff --git a/.aide/flow-status.json b/.aide/flow-status.json index 9a0a0cd..b1f4e5d 100644 --- a/.aide/flow-status.json +++ b/.aide/flow-status.json @@ -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完成:同步更新所有相关文档" } ] } diff --git a/.aide/flow-status.lock b/.aide/flow-status.lock index a4901cb..f87195b 100755 --- a/.aide/flow-status.lock +++ b/.aide/flow-status.lock @@ -1 +1 @@ -81279 \ No newline at end of file +82752 \ No newline at end of file diff --git a/.aide/project-docs/README.md b/.aide/project-docs/README.md index 816002e..d178180 100644 --- a/.aide/project-docs/README.md +++ b/.aide/project-docs/README.md @@ -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 提交顺序:状态先保存再提交 + ## 输出格式约定 | 前缀 | 含义 | diff --git a/.aide/project-docs/blocks/aide-plugin-commands.md b/.aide/project-docs/blocks/aide-plugin-commands.md index 4b51f6f..75174f0 100644 --- a/.aide/project-docs/blocks/aide-plugin-commands.md +++ b/.aide/project-docs/blocks/aide-plugin-commands.md @@ -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 命令行工具 ## 注意事项 diff --git a/.aide/project-docs/blocks/aide-plugin-skills.md b/.aide/project-docs/blocks/aide-plugin-skills.md index a02b79f..8baacaf 100644 --- a/.aide/project-docs/blocks/aide-plugin-skills.md +++ b/.aide/project-docs/blocks/aide-plugin-skills.md @@ -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 上下文占用 diff --git a/.aide/project-docs/blocks/aide-program-flow.md b/.aide/project-docs/blocks/aide-program-flow.md index 70ee94f..73a8eb1 100644 --- a/.aide/project-docs/blocks/aide-program-flow.md +++ b/.aide/project-docs/blocks/aide-program-flow.md @@ -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 # 查看任务详情 ## Git 集成 -每次 flow 操作自动执行: -1. `git add .` -2. `git commit -m "[aide] : "` +**执行顺序**(已优化): +1. 运行 pre_commit_hooks +2. 更新 FlowStatus(内存) +3. 保存状态到磁盘(flow-status.json) +4. `git add .` +5. `git commit -m "[aide] : "` +6. 更新 commit hash 到状态文件 + +> **关键改进**:状态文件先保存再执行 git 操作,确保 flow-status.json 的更新包含在 commit 中 提交信息格式: - 正常操作:`[aide] impl: 完成数据库模型设计` @@ -99,3 +107,4 @@ aide flow show # 查看任务详情 - 状态文件使用文件锁防止并发写入 - 归档文件保存在 `.aide/logs/` 目录 - Hooks 支持 PlantUML 自动校验和构建 +- Git 提交在状态保存之后执行,确保 .aide 目录变更被包含