diff --git a/.aide/flow-status.json b/.aide/flow-status.json new file mode 100644 index 0000000..84bdaa6 --- /dev/null +++ b/.aide/flow-status.json @@ -0,0 +1,16 @@ +{ + "task_id": "2025-12-16T20-22-50", + "current_phase": "task-optimize", + "current_step": 1, + "started_at": "2025-12-16T20:22:50+08:00", + "history": [ + { + "timestamp": "2025-12-16T20:22:50+08:00", + "action": "start", + "phase": "task-optimize", + "step": 1, + "summary": "开始任务准备: 多模块调整(skill创建/run命令修改/流程图规范/flow提交顺序)", + "git_commit": "283fc63aca060ee9c71b88bd797ccb488d8d31d2" + } + ] +} diff --git a/.aide/flow-status.lock b/.aide/flow-status.lock index 20cd4cd..002d524 100755 --- a/.aide/flow-status.lock +++ b/.aide/flow-status.lock @@ -1 +1 @@ -75338 \ No newline at end of file +75918 \ No newline at end of file diff --git a/task-spec.md b/task-spec.md new file mode 100644 index 0000000..92126a1 --- /dev/null +++ b/task-spec.md @@ -0,0 +1,161 @@ +# 任务细则 + +> 生成时间:2025-12-16 +> 任务来源:task-now.md +> 复杂度等级:复杂(需拆分为子计划) + +## 任务概述 + +对 Aide 工作流体系进行多模块调整,包括:创建新 skill、修改 run 命令、强化流程图规范、创建示例程序、调整 flow 提交顺序、更新文档。 + +## 子计划列表 + +### 子计划 1:创建口语化内容解析 skill + +**目标**:创建一个 skill,用于识别和解析口语化的任务描述 + +**输入**:`statements/optimize.md` 作为基础 + +**输出**:`aide-marketplace/aide-plugin/skills/task-parser.md` + +**功能要求**: +1. 语义解析:分析口语化表达,提取核心意图和真实需求 +2. 批判性分析:识别逻辑漏洞、盲点、过度设计 +3. 建设性建议:提出优化方向和替代方案 +4. 规范化转换:将口语化内容转化为结构化任务描述 + +**扩展内容**(基于原材料发挥): +- 上下文关联:识别任务与项目现有内容的关联 +- 隐含需求挖掘:发现未明确说明但实际需要的内容 +- 复杂度预判:初步评估任务复杂度 + +--- + +### 子计划 2:修改 run 命令集成 skill 触发 + +**目标**:在 run 命令中添加口语化内容检测和 skill 触发逻辑 + +**修改文件**:`aide-marketplace/aide-plugin/commands/run.md` + +**修改位置**:在 1.3 任务分析之前 + +**新增逻辑**: +``` +如果任务文档或用户对话具有以下特征之一: +- 使用非正式的口头表达方式 +- 包含大量"我觉得"、"好像"、"大概"等模糊表述 +- 句子结构松散,缺乏条理性 +- 包含冗余或重复的表达 + +则: +1. 触发 task-parser skill 学习解析方法 +2. 对内容进行深度理解和规范化转换 +3. 将转换后的结构化内容作为后续分析的基础 +``` + +--- + +### 子计划 3:强化流程图规范 + +**目标**:明确定义两种流程图类型及其规范 + +**修改文件**:`aide-marketplace/aide-plugin/commands/run.md` + +**修改位置**:2.2 创建流程图部分 + +**新增内容**: + +#### 流程图类型定义 + +| 类型 | 适用场景 | 必需性 | +|------|----------|--------| +| 任务执行流程图 | 所有任务 | 必需 | +| 程序逻辑流图 | 含程序设计与代码编写的任务 | 必需 | + +#### 任务执行流程图规范 +- 展示任务执行的步骤顺序 +- 体现任务分解和依赖关系 +- 包含关键决策点和分支 + +#### 程序逻辑流图规范 +- **入口点**:从程序入口函数(如 main)开始 +- **结构体现**:展示顺序、分支、循环等控制结构 +- **语义化抽象**:将代码逻辑抽象为人类可理解的业务描述 +- **模块化表示**: + - 函数/模块表示为"盒子" + - 标注输入和输出 + - 复杂模块可用子流程图详细展开 +- **层次化组织**: + - 主流程图展示整体逻辑 + - 子系统/模块可单独绘制详图 + +--- + +### 子计划 4:创建 Python 示例程序并绘制流程图 + +**目标**:验证流程图规范的有效性 + +**位置**:`test-cache/demo-program/` + +**程序要求**: +- 语言:Python +- 复杂度:中低 +- 特点:模块化设计,包含多个文件 + +**产出**: +1. Python 程序代码 +2. 程序逻辑流图(PlantUML) + - 主流程图 + - 关键模块详图(如需要) + +--- + +### 子计划 5:调整 aide flow 的 git 提交顺序 + +**目标**:确保 flow-status.json 的更新包含在 git commit 中 + +**修改文件**:`aide-program/aide/flow/tracker.py` + +**当前顺序**(`_apply_action` 方法): +1. run_pre_commit_hooks +2. git.add_all() +3. git.commit(message) +4. 创建新的 FlowStatus(内存) +5. 返回 FlowStatus +6. (在 `_run` 中)storage.save_status(updated) + +**目标顺序**: +1. run_pre_commit_hooks +2. 创建新的 FlowStatus(内存) +3. storage.save_status(updated) +4. git.add_all() +5. git.commit(message) + +**技术方案**: +- 重构 `_apply_action` 方法,将 git 操作分离 +- 或在 `_run` 中调整调用顺序 + +--- + +### 子计划 6:同步更新所有相关文档 + +**更新列表**: +1. `.aide/project-docs/blocks/aide-plugin-skills.md` - 添加新 skill 说明 +2. `.aide/project-docs/blocks/aide-plugin-commands.md` - 更新 run 命令说明 +3. `.aide/project-docs/blocks/aide-program-flow.md` - 更新 flow 模块说明 +4. `aide-marketplace/aide-plugin/skills/aide.md` - 如有必要 + +## 执行顺序 + +``` +子计划1 → 子计划2 → 子计划3 → 子计划4 → 子计划5 → 子计划6 +``` + +## 成功标准 + +1. ✓ 新 skill 文件存在且功能完整 +2. ✓ run 命令能识别口语化内容并触发 skill +3. ✓ 流程图规范清晰明确,区分两种类型 +4. ✓ 示例程序正常运行,流程图正确展示程序逻辑 +5. ✓ flow 命令的 git 提交包含最新的 flow-status.json +6. ✓ 所有相关文档已同步更新