feat: 初版插件市场完成,准备调整re-03

This commit is contained in:
2025-12-13 02:11:02 +08:00
parent 3628971a6e
commit e9c43fbb0e
9 changed files with 1121 additions and 0 deletions

View File

@@ -0,0 +1,251 @@
---
description: 任务执行流程。基于 task-spec.md 执行任务,包含流程设计、迭代实现、验证交付、文档更新和收尾。
---
# Aide 任务执行
你正在执行 Aide 任务执行流程。本流程基于任务细则task-spec.md完成实际的任务实施。
## 流程概览
```
流程设计 → 迭代实现 → 验证交付 → 文档更新 → 收尾
```
## 运行特点
- **完整闭环**包含状态记录、git 提交、流程校验
- **可追溯**:每个步骤都有记录,支持中断恢复
- **自动化**:状态管理和版本控制通过 aide 程序处理
## 前置条件
确认存在 `task-spec.md`
- 存在:读取并理解任务细则
- 不存在:提示用户先执行 `/aide:prep` 或提供任务细则
---
## 环节 1流程设计
### 1.1 启动任务
执行命令开始新任务:
```bash
aide flow start flow-design "开始任务: <任务简述>"
```
### 1.2 理解任务细则
仔细阅读 `task-spec.md`
- 明确任务目标和成功标准
- 理解执行步骤和依赖关系
- 识别技术决策和约束
### 1.3 分析项目环境
根据任务需要:
- 阅读相关代码文件
- 了解项目结构和约定
- 识别需要修改的模块
### 1.4 制定执行计划
产出执行计划,包含:
- 具体的实现步骤
- 每个步骤的预期产出
- 步骤间的依赖关系
- 潜在风险和应对方案
> 复杂任务建议使用 sequential-thinking 进行结构化规划
### 1.5 完成流程设计
记录步骤推进:
```bash
aide flow next-step "流程设计完成,计划 N 个实现步骤"
```
---
## 环节 2迭代实现
### 2.1 进入实现环节
```bash
aide flow next-part impl "开始迭代实现"
```
### 2.2 按计划执行
对于每个实现步骤:
1. **执行前**:明确本步骤目标
2. **执行中**:自由发挥,完成实际编码/修改
3. **执行后**:记录完成
```bash
aide flow next-step "<本步骤完成的内容简述>"
```
### 2.3 处理问题
遇到问题时:
**一般问题(可继续)**
```bash
aide flow issue "<问题描述>"
```
记录后继续执行,后续解决。
**严重错误(阻塞)**
```bash
aide flow error "<错误描述>"
```
必须先解决再继续。处理方式:
1. 尝试自行解决最多3次
2. 成功:在 `discuss/` 创建分析文档记录解决过程
3. 失败:停止并告知用户
### 2.4 需要回退时
发现设计问题需要回退:
```bash
aide flow back-part flow-design "发现 xxx 问题,需要调整设计"
```
步骤内小回退:
```bash
aide flow back-step "<回退原因>"
```
---
## 环节 3验证交付
### 3.1 进入验证环节
```bash
aide flow next-part verify "开始验证交付"
```
### 3.2 对照任务细则验证
逐项检查 `task-spec.md` 中的成功标准:
- 每个标准是否满足
- 每个交付物是否完成
- 功能是否正常工作
### 3.3 执行测试
根据项目情况:
- 运行已有测试套件
- 手动测试关键功能
- 验证边界情况
### 3.4 记录验证结果
```bash
aide flow next-step "验证完成: <验证结论>"
```
验证失败时:
- 记录失败原因
- 回退到实现环节修复
- 修复后重新验证
---
## 环节 4文档更新
### 4.1 进入文档环节
```bash
aide flow next-part docs "开始文档更新"
```
### 4.2 更新相关文档
根据任务影响更新:
- `README.md`(如有用户可见变更)
- `CHANGELOG.md`(记录本次变更)
- 其他相关文档
### 4.3 CHANGELOG 更新规范
在 `CHANGELOG.md` 中:
1. 在 `[Unreleased]` 区块添加本次变更
2. 使用语义化分类Added/Changed/Fixed/Removed
3. 简明描述变更内容
### 4.4 记录完成
```bash
aide flow next-step "文档更新完成"
```
---
## 环节 5收尾
### 5.1 进入收尾环节
```bash
aide flow next-part finish "开始收尾"
```
### 5.2 清理工作
- 删除临时文件和调试代码
- 确保代码格式规范
- 检查是否有遗漏的 TODO
### 5.3 最终检查
确认:
- 所有计划步骤已完成
- 所有测试通过
- 文档已更新
- 仓库状态干净
### 5.4 完成任务
```bash
aide flow next-step "任务完成"
```
### 5.5 向用户汇报
总结本次任务:
- 完成了什么
- 主要变更点
- 遗留问题(如有)
- 后续建议(如有)
---
## 错误恢复机制
### ⚠ 警告级别
- 记录问题:`aide flow issue "<描述>"`
- 分析是否影响继续
- 可继续:记录"继续-xxx"
- 需解决:记录"待解决-xxx"
### ✗ 错误级别
- 记录错误:`aide flow error "<描述>"`
- 必须解决后才能继续
- 尝试自行解决最多3次
- 成功:在 `discuss/` 创建分析文档
- 失败:停止并告知用户
---
## 注意事项
1. **状态同步**:每个步骤变化都要通过 `aide flow` 记录
2. **原子提交**aide flow 会自动处理 git add 和 commit
3. **业务自由**:编写业务代码时自由发挥,不受格式约束
4. **简体中文**:所有输出和记录使用简体中文
5. **可恢复**:任务中断后可通过状态记录恢复进度

View File

@@ -0,0 +1,70 @@
---
description: 项目认知与环境初始化。进入新项目或开始工作前使用,触发对项目的主动认知和环境检测修复。
---
# Aide 初始化
你正在使用 Aide 工作流体系。本命令帮助你快速认知项目并确保环境就绪。
## 执行步骤
### 1. 项目认知
**目标**:快速建立对项目的整体理解
执行以下操作:
1. 阅读项目根目录的 `README.md`(如存在)
2. 阅读 `CLAUDE.md`(如存在)
3. 浏览项目目录结构,理解核心模块划分
4. 识别项目类型(前端/后端/全栈/工具库/文档等)
5. 识别主要技术栈和依赖
**产出**向用户简要汇报项目概况3-5句话
### 2. 环境检测与修复
**目标**:确保开发环境就绪,避免后续业务逻辑被环境问题打扰
执行命令:
```bash
aide env ensure
```
根据输出处理:
- `✓` 开头:环境就绪,继续下一步
- `⚠` 开头:有警告但可继续,记录并继续
- `✗` 开头环境有问题尝试按提示修复3次失败则停止并告知用户
### 3. Aide 数据目录初始化
检查 `.aide/` 目录是否存在:
- 不存在:执行 `aide init`(会自动创建目录和默认配置)
- 已存在:跳过
检查 `.gitignore` 是否包含 `.aide/`
- 不包含:添加 `.aide/``.gitignore`
- 已包含:跳过
### 4. 汇报就绪状态
向用户汇报:
1. 项目概况来自步骤1
2. 环境状态来自步骤2
3. 可用的 Aide 命令提示
示例汇报:
```
项目概况:这是一个基于 Rust 的 CLI 工具项目,使用 clap 处理命令行参数。
环境状态:✓ 环境就绪 (rust:1.75, cargo:1.75)
Aide 已就绪,可用命令:
- /aide:prep - 开始任务准备(分析优化任务描述)
- /aide:exec - 开始任务执行(需要先完成 prep
```
## 注意事项
1. **沉没成本小**:如果在初始化过程中发现严重环境问题无法解决,建议用户修复后重开对话
2. **不执行业务操作**:本命令只做认知和环境准备,不修改任何业务代码
3. **简体中文**:所有输出使用简体中文

View File

@@ -0,0 +1,219 @@
---
description: 任务准备流程。分析用户任务描述优化表述处理待定项产出可执行的任务细则task-spec.md
---
# Aide 任务准备
你正在执行 Aide 任务准备流程。本流程帮助用户将模糊的任务描述转化为清晰、可执行的任务细则。
## 流程概览
```
任务分析 → 任务优化 → 待定项处理 → 结果生成 → 用户确认
```
## 运行特点
- **轻量化**:不创建工作目录、不记录状态、不 git 提交
- **用户确认制**:待定项和最终结果都需要用户确认
- **可返工**:用户不满意可返回重新优化
---
## 阶段 1任务分析
### 1.1 获取任务描述
确认任务描述来源:
- 用户已提供任务描述:直接使用
- 用户指定文件(如 `now-task.md`):读取文件内容
- 用户未提供:询问用户任务内容
### 1.2 深度分析
对任务描述进行全面分析:
**理解核心目标**
- 任务要解决什么问题?
- 最终交付物是什么?
- 成功的标准是什么?
**识别复杂度**
- 涉及哪些模块/文件/系统?
- 是否有多个子目标?
- 是否存在技术难点?
**分析项目环境**
- 任务与项目现有结构的关系
- 是否需要了解特定代码/文档?
- 是否有相关历史实现可参考?
> 复杂任务(多子目标、多方案对比)建议使用 sequential-thinking 进行结构化分析
### 1.3 产出分析结论
在心中形成对任务的完整理解,为下一阶段做准备。
---
## 阶段 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"
}
]
}
```
---
## 阶段 3待定项处理
### 3.1 提交待定项
如果有待定项,执行:
```bash
aide decide '<json数据>'
```
程序会启动 Web 服务并输出访问链接。
### 3.2 等待用户决策
告知用户:
```
待定项已生成,请访问以下链接进行确认:
http://localhost:xxxx
完成后请告诉我,我会读取您的决策结果。
```
### 3.3 获取决策结果
用户确认完成后,执行:
```bash
aide decide result
```
读取用户的决策结果,整合到后续的任务细则中。
### 3.4 无待定项的情况
如果分析后没有待定项(任务描述已经足够清晰),直接进入下一阶段。
---
## 阶段 4结果生成
### 4.1 生成任务细则
基于:
- 原始任务描述
- 分析优化结果
- 用户决策结果(如有)
产出 `task-spec.md`,包含:
```markdown
# 任务细则
## 任务目标
[清晰描述任务要达成的目标]
## 成功标准
[明确的、可验证的成功标准]
## 执行步骤
1. [步骤1]
- 输入xxx
- 输出xxx
- 验证xxx
2. [步骤2]
...
## 技术决策
[记录已确认的技术选型和方案]
## 约束与边界
[任务范围边界、不包含的内容]
## 风险与假设
[已识别的风险和前提假设]
```
### 4.2 用户最终确认
向用户展示 `task-spec.md` 内容,询问确认:
```
任务细则已生成,请审阅上述内容。
- 如果满意,请回复"确认",我将保存为 task-spec.md
- 如果需要修改,请说明具体问题,我会进行调整
```
### 4.3 处理用户反馈
- **用户确认**:保存 `task-spec.md`prep 流程结束
- **用户要求修改**:根据反馈返回相应阶段重新处理
- **用户否决**:询问具体问题,必要时从分析阶段重来
---
## 注意事项
1. **不做假设**:遇到模糊需求主动询问,不要自行假设
2. **用户主导**:所有重要决策都需要用户确认
3. **保持精简**:任务细则要清晰可执行,避免冗余
4. **简体中文**:所有输出使用简体中文
5. **核心优先**:聚焦任务分析和优化本身,形式问题交给程序处理