feat: 准备解决一些问题

This commit is contained in:
2025-12-17 01:26:41 +08:00
parent 973e60ec1d
commit 9ea8b36297
5 changed files with 63 additions and 180 deletions

View File

@@ -1,161 +0,0 @@
# 任务细则
> 生成时间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. ✓ 所有相关文档已同步更新