✨ feat: 更新了command，上下文爆了
This commit is contained in:
@@ -1,168 +1,131 @@
|
||||
---
|
||||
description: 任务准备流程。分析用户任务描述，优化表述，处理待定项，产出可执行的任务细则（task-spec.md）。
|
||||
description: 任务准备流程。分析用户任务描述，优化表述，处理待定项，产出可执行的任务细则。
|
||||
argument-hint: [任务原文档路径]
|
||||
---
|
||||
|
||||
# Aide 任务准备
|
||||
|
||||
你正在执行 Aide 任务准备流程。本流程帮助用户将模糊的任务描述转化为清晰、可执行的任务细则。
|
||||
你正在执行 Aide 任务准备流程。将任务描述转化为清晰、可执行的任务细则。
|
||||
|
||||
## 流程概览
|
||||
## 参数
|
||||
|
||||
```
|
||||
任务分析 → 任务优化 → 待定项处理 → 结果生成 → 用户确认
|
||||
- `$ARGUMENTS`：任务原文档路径（可选）
|
||||
- 未传入时使用配置中的默认路径
|
||||
|
||||
---
|
||||
|
||||
## 开始
|
||||
|
||||
### 确定任务文档
|
||||
|
||||
```bash
|
||||
# 如果传入了参数
|
||||
任务文档 = $ARGUMENTS
|
||||
|
||||
# 如果未传入参数，使用配置默认值
|
||||
aide config get task.source
|
||||
```
|
||||
|
||||
## 运行特点
|
||||
读取任务文档内容。如文档不存在，询问用户提供任务内容或指定文档路径。
|
||||
|
||||
- **轻量化**：不创建工作目录、不记录状态、不 git 提交
|
||||
- **用户确认制**：待定项和最终结果都需要用户确认
|
||||
- **可返工**：用户不满意可返回重新优化
|
||||
### 启动流程追踪
|
||||
|
||||
```bash
|
||||
aide flow start task-optimize "开始任务准备: <任务简述>"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 阶段 1：任务分析
|
||||
|
||||
### 1.1 获取任务描述
|
||||
### 深度理解任务
|
||||
|
||||
确认任务描述来源：
|
||||
- 用户已提供任务描述：直接使用
|
||||
- 用户指定文件（如 `now-task.md`）：读取文件内容
|
||||
- 用户未提供：询问用户任务内容
|
||||
|
||||
### 1.2 深度分析
|
||||
|
||||
对任务描述进行全面分析：
|
||||
|
||||
**理解核心目标**
|
||||
- 任务要解决什么问题？
|
||||
- 最终交付物是什么？
|
||||
- 成功的标准是什么？
|
||||
- 涉及哪些模块/系统？
|
||||
- 是否有技术难点？
|
||||
|
||||
**识别复杂度**
|
||||
- 涉及哪些模块/文件/系统？
|
||||
- 是否有多个子目标？
|
||||
- 是否存在技术难点？
|
||||
### 分析项目环境
|
||||
|
||||
**分析项目环境**
|
||||
- 任务与项目现有结构的关系
|
||||
- 是否需要了解特定代码/文档？
|
||||
- 是否有相关历史实现可参考？
|
||||
根据需要阅读相关代码/文档，理解任务与项目现有结构的关系。
|
||||
|
||||
> 复杂任务（多子目标、多方案对比）建议使用 sequential-thinking 进行结构化分析
|
||||
|
||||
### 1.3 产出分析结论
|
||||
### 记录进度
|
||||
|
||||
在心中形成对任务的完整理解，为下一阶段做准备。
|
||||
```bash
|
||||
aide flow next-step "任务分析完成"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 阶段 2：任务优化
|
||||
|
||||
### 2.1 准确性优化
|
||||
### 准确性优化
|
||||
|
||||
- 识别任务描述中的**歧义**和**不明确之处**
|
||||
- 识别**歧义**和**不明确之处**
|
||||
- 识别**隐含假设**和**未说明的前提**
|
||||
- 明确任务**边界**：哪些在范围内，哪些不在
|
||||
- 明确任务**边界**
|
||||
|
||||
### 2.2 简洁性优化
|
||||
### 简洁性优化
|
||||
|
||||
- 识别**冗余表述**（同一意思重复多次）
|
||||
- 识别**冗余表述**
|
||||
- 区分**真冗余**与**必要强调**
|
||||
- 保持简洁但不丢失关键信息
|
||||
|
||||
### 2.3 可执行性优化
|
||||
### 可执行性优化
|
||||
|
||||
- 将抽象要求转化为**具体步骤**
|
||||
- 确保每个步骤有明确的**输入、输出、验证标准**
|
||||
- 考虑步骤间的**顺序和依赖关系**
|
||||
- 识别可能的**替代方案**
|
||||
|
||||
### 2.4 生成待定项
|
||||
### 生成待定项
|
||||
|
||||
对于以下情况，生成待定项：
|
||||
- 存在**多种可行方案**需要用户选择
|
||||
- 描述**有歧义**需要用户澄清
|
||||
- 存在**隐含假设**需要用户确认
|
||||
- 识别出**可以优化**但需要用户认可的内容
|
||||
对于存在多种方案、有歧义、需要用户确认的内容，准备待定项数据。
|
||||
|
||||
待定项数据格式：
|
||||
```json
|
||||
{
|
||||
"task": "任务简述",
|
||||
"source": "任务描述来源文件",
|
||||
"items": [
|
||||
{
|
||||
"id": 1,
|
||||
"title": "问题标题",
|
||||
"location": {
|
||||
"file": "now-task.md",
|
||||
"start": 5,
|
||||
"end": 7
|
||||
},
|
||||
"context": "为什么这是一个需要确认的问题",
|
||||
"options": [
|
||||
{
|
||||
"value": "option_a",
|
||||
"label": "选项A描述",
|
||||
"score": 85,
|
||||
"pros": ["优点1", "优点2"],
|
||||
"cons": ["缺点1"]
|
||||
}
|
||||
],
|
||||
"recommend": "option_a"
|
||||
}
|
||||
]
|
||||
}
|
||||
### 记录进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "任务优化完成，生成待定项"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 阶段 3：待定项处理
|
||||
|
||||
### 3.1 提交待定项
|
||||
### 有待定项时
|
||||
|
||||
提交待定项数据：
|
||||
|
||||
如果有待定项，执行：
|
||||
```bash
|
||||
aide decide '<json数据>'
|
||||
```
|
||||
|
||||
程序会启动 Web 服务并输出访问链接。
|
||||
告知用户访问链接进行确认。
|
||||
|
||||
### 3.2 等待用户决策
|
||||
用户完成后获取结果：
|
||||
|
||||
告知用户：
|
||||
```
|
||||
待定项已生成，请访问以下链接进行确认：
|
||||
http://localhost:xxxx
|
||||
|
||||
完成后请告诉我，我会读取您的决策结果。
|
||||
```
|
||||
|
||||
### 3.3 获取决策结果
|
||||
|
||||
用户确认完成后，执行：
|
||||
```bash
|
||||
aide decide result
|
||||
```
|
||||
|
||||
读取用户的决策结果，整合到后续的任务细则中。
|
||||
### 记录进度
|
||||
|
||||
### 3.4 无待定项的情况
|
||||
```bash
|
||||
aide flow next-step "用户完成待定项确认"
|
||||
```
|
||||
|
||||
如果分析后没有待定项（任务描述已经足够清晰），直接进入下一阶段。
|
||||
### 无待定项时
|
||||
|
||||
任务描述已足够清晰，直接进入下一阶段。
|
||||
|
||||
---
|
||||
|
||||
## 阶段 4：结果生成
|
||||
|
||||
### 4.1 生成任务细则
|
||||
### 生成任务细则
|
||||
|
||||
基于：
|
||||
- 原始任务描述
|
||||
- 分析优化结果
|
||||
- 用户决策结果（如有）
|
||||
|
||||
产出 `task-spec.md`，包含：
|
||||
整合原始描述、优化结果、用户决策，产出任务细则：
|
||||
|
||||
```markdown
|
||||
# 任务细则
|
||||
@@ -175,45 +138,61 @@ aide decide result
|
||||
|
||||
## 执行步骤
|
||||
1. [步骤1]
|
||||
- 输入：xxx
|
||||
- 输出：xxx
|
||||
- 验证：xxx
|
||||
2. [步骤2]
|
||||
...
|
||||
...
|
||||
|
||||
## 技术决策
|
||||
[记录已确认的技术选型和方案]
|
||||
[已确认的技术选型]
|
||||
|
||||
## 约束与边界
|
||||
[任务范围边界、不包含的内容]
|
||||
|
||||
## 风险与假设
|
||||
[已识别的风险和前提假设]
|
||||
[任务范围边界]
|
||||
```
|
||||
|
||||
### 4.2 用户最终确认
|
||||
### 记录进度
|
||||
|
||||
向用户展示 `task-spec.md` 内容，询问确认：
|
||||
|
||||
```
|
||||
任务细则已生成，请审阅上述内容。
|
||||
|
||||
- 如果满意，请回复"确认"，我将保存为 task-spec.md
|
||||
- 如果需要修改，请说明具体问题，我会进行调整
|
||||
```bash
|
||||
aide flow next-step "生成任务细则，等待用户确认"
|
||||
```
|
||||
|
||||
### 4.3 处理用户反馈
|
||||
### 用户确认
|
||||
|
||||
- **用户确认**：保存 `task-spec.md`，prep 流程结束
|
||||
- **用户要求修改**：根据反馈返回相应阶段重新处理
|
||||
- **用户否决**：询问具体问题，必要时从分析阶段重来
|
||||
向用户展示任务细则，询问确认：
|
||||
- **确认**：保存到任务细则文档
|
||||
- **需修改**：根据反馈调整
|
||||
|
||||
```bash
|
||||
aide flow next-step "用户确认任务细则"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 注意事项
|
||||
## 完成
|
||||
|
||||
1. **不做假设**：遇到模糊需求主动询问，不要自行假设
|
||||
2. **用户主导**：所有重要决策都需要用户确认
|
||||
3. **保持精简**：任务细则要清晰可执行，避免冗余
|
||||
4. **简体中文**：所有输出使用简体中文
|
||||
5. **核心优先**：聚焦任务分析和优化本身，形式问题交给程序处理
|
||||
任务准备完成，任务细则已保存。
|
||||
|
||||
提示用户：
|
||||
```
|
||||
任务细则已保存到 task-spec.md
|
||||
|
||||
可执行 /aide:exec 开始任务执行
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 处理问题
|
||||
|
||||
遇到问题时：
|
||||
|
||||
```bash
|
||||
# 一般问题
|
||||
aide flow issue "<问题描述>"
|
||||
|
||||
# 严重错误
|
||||
aide flow error "<错误描述>"
|
||||
```
|
||||
|
||||
需要回退时：
|
||||
|
||||
```bash
|
||||
aide flow back-step "<原因>"
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user