[aide] task-optimize: 任务分析和细则生成完成

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. ✓ 所有相关文档已同步更新