[aide] task-optimize: 开始任务准备: 重写 README.md,提供快速上手指南
This commit is contained in:
@@ -1,210 +0,0 @@
|
||||
---
|
||||
description: 任务准备流程。分析用户任务描述,优化表述,处理待定项,产出可执行的任务细则。
|
||||
argument-hint: [任务原文档路径]
|
||||
---
|
||||
|
||||
# Aide 任务准备
|
||||
|
||||
你正在执行 Aide 任务准备流程。将任务描述转化为清晰、可执行的任务细则。
|
||||
|
||||
## 参数
|
||||
|
||||
- `$ARGUMENTS`:任务原文档路径(可选)
|
||||
- 未传入时使用配置中的默认路径
|
||||
|
||||
---
|
||||
|
||||
## 前置准备
|
||||
|
||||
**首先触发 `aide` skill 学习 aide 命令的使用方法。**
|
||||
|
||||
这是必要步骤,确保你了解 `aide flow` 等命令的正确用法。
|
||||
|
||||
---
|
||||
|
||||
## 开始
|
||||
|
||||
### 启动流程追踪
|
||||
|
||||
```bash
|
||||
aide flow start task-optimize "开始任务准备: <任务简述>"
|
||||
```
|
||||
|
||||
### 确定任务文档
|
||||
|
||||
```bash
|
||||
# 如果传入了参数
|
||||
任务文档 = $ARGUMENTS
|
||||
|
||||
# 如果未传入参数,使用配置默认值
|
||||
aide config get task.source
|
||||
```
|
||||
|
||||
读取任务文档内容。如文档不存在,询问用户提供任务内容或指定文档路径。
|
||||
|
||||
---
|
||||
|
||||
## 阶段 1:任务分析
|
||||
|
||||
### 深度理解任务
|
||||
|
||||
- 任务要解决什么问题?
|
||||
- 最终交付物是什么?
|
||||
- 成功的标准是什么?
|
||||
- 涉及哪些模块/系统?
|
||||
- 是否有技术难点?
|
||||
|
||||
### 分析项目环境
|
||||
|
||||
根据需要阅读相关代码/文档,理解任务与项目现有结构的关系。
|
||||
|
||||
> 复杂任务(多子目标、多方案对比)建议使用 sequential-thinking 进行结构化分析
|
||||
|
||||
### 记录进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "任务分析完成"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 阶段 2:任务优化
|
||||
|
||||
### 准确性优化
|
||||
|
||||
- 识别**歧义**和**不明确之处**
|
||||
- 识别**隐含假设**和**未说明的前提**
|
||||
- 明确任务**边界**
|
||||
|
||||
### 简洁性优化
|
||||
|
||||
- 识别**冗余表述**
|
||||
- 区分**真冗余**与**必要强调**
|
||||
|
||||
### 可执行性优化
|
||||
|
||||
- 将抽象要求转化为**具体步骤**
|
||||
- 确保每个步骤有明确的**输入、输出、验证标准**
|
||||
- 识别可能的**替代方案**
|
||||
|
||||
### 生成待定项
|
||||
|
||||
对于存在多种方案、有歧义、需要用户确认的内容,准备待定项数据。
|
||||
|
||||
### 记录进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "任务优化完成,生成待定项"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 阶段 3:待定项处理
|
||||
|
||||
### 有待定项时
|
||||
|
||||
1. 将待定项数据写入 JSON 文件(如 `.aide/pending-items.json`)
|
||||
2. 提交待定项数据:
|
||||
|
||||
```bash
|
||||
aide decide submit .aide/pending-items.json
|
||||
```
|
||||
|
||||
3. 告知用户访问输出的链接进行确认
|
||||
4. 用户完成后获取结果:
|
||||
|
||||
```bash
|
||||
aide decide result
|
||||
```
|
||||
|
||||
### 记录进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "用户完成待定项确认"
|
||||
```
|
||||
|
||||
### 无待定项时
|
||||
|
||||
任务描述已足够清晰,直接进入下一阶段。
|
||||
|
||||
---
|
||||
|
||||
## 阶段 4:结果生成
|
||||
|
||||
### 生成任务细则
|
||||
|
||||
整合原始描述、优化结果、用户决策,产出任务细则:
|
||||
|
||||
```markdown
|
||||
# 任务细则
|
||||
|
||||
## 任务目标
|
||||
[清晰描述任务要达成的目标]
|
||||
|
||||
## 成功标准
|
||||
[明确的、可验证的成功标准]
|
||||
|
||||
## 执行步骤
|
||||
1. [步骤1]
|
||||
2. [步骤2]
|
||||
...
|
||||
|
||||
## 技术决策
|
||||
[已确认的技术选型]
|
||||
|
||||
## 约束与边界
|
||||
[任务范围边界]
|
||||
```
|
||||
|
||||
### 记录进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "生成任务细则,等待用户确认"
|
||||
```
|
||||
|
||||
### 用户确认
|
||||
|
||||
向用户展示任务细则,询问确认:
|
||||
- **确认**:保存到任务细则文档
|
||||
- **需修改**:根据反馈调整
|
||||
|
||||
```bash
|
||||
aide flow next-step "用户确认任务细则"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 完成
|
||||
|
||||
任务准备完成,任务细则已保存。
|
||||
|
||||
```bash
|
||||
aide flow next-step "任务准备完成"
|
||||
```
|
||||
|
||||
提示用户:
|
||||
```
|
||||
任务细则已保存到 task-spec.md
|
||||
|
||||
可执行 /aide:exec 开始任务执行
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 处理问题
|
||||
|
||||
遇到问题时:
|
||||
|
||||
```bash
|
||||
# 一般问题
|
||||
aide flow issue "<问题描述>"
|
||||
|
||||
# 严重错误
|
||||
aide flow error "<错误描述>"
|
||||
```
|
||||
|
||||
需要回退时:
|
||||
|
||||
```bash
|
||||
aide flow back-step "<原因>"
|
||||
```
|
||||
@@ -54,10 +54,19 @@ aide config get task.source
|
||||
|
||||
#### 1.3 任务分析
|
||||
|
||||
##### 深度理解任务
|
||||
|
||||
- 任务要解决什么问题?
|
||||
- 最终交付物是什么?
|
||||
- 成功的标准是什么?
|
||||
- 涉及哪些模块/系统?
|
||||
- 是否有技术难点?
|
||||
|
||||
##### 分析项目环境
|
||||
|
||||
根据需要阅读相关代码/文档,理解任务与项目现有结构的关系。
|
||||
|
||||
> 复杂任务(多子目标、多方案对比)建议使用 sequential-thinking 进行结构化分析
|
||||
|
||||
#### 1.4 复杂度评估
|
||||
|
||||
@@ -68,10 +77,26 @@ aide config get task.source
|
||||
|
||||
#### 1.5 任务优化
|
||||
|
||||
- 识别歧义和不明确之处
|
||||
- 识别隐含假设
|
||||
- 明确任务边界
|
||||
- 生成待定项(如有)
|
||||
##### 准确性优化
|
||||
|
||||
- 识别**歧义**和**不明确之处**
|
||||
- 识别**隐含假设**和**未说明的前提**
|
||||
- 明确任务**边界**
|
||||
|
||||
##### 简洁性优化
|
||||
|
||||
- 识别**冗余表述**
|
||||
- 区分**真冗余**与**必要强调**
|
||||
|
||||
##### 可执行性优化
|
||||
|
||||
- 将抽象要求转化为**具体步骤**
|
||||
- 确保每个步骤有明确的**输入、输出、验证标准**
|
||||
- 识别可能的**替代方案**
|
||||
|
||||
##### 生成待定项
|
||||
|
||||
对于存在多种方案、有歧义、需要用户确认的内容,准备待定项数据。
|
||||
|
||||
#### 1.6 待定项处理(如有)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user