162 lines
4.7 KiB
Markdown
162 lines
4.7 KiB
Markdown
# 任务细则
|
||
|
||
> 生成时间：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. ✓ 所有相关文档已同步更新
|