✨ feat: 初版插件市场完成,准备调整re-03
This commit is contained in:
17
aide-marketplace/.claude-plugin/marketplace.json
Normal file
17
aide-marketplace/.claude-plugin/marketplace.json
Normal file
@@ -0,0 +1,17 @@
|
||||
{
|
||||
"name": "aide-marketplace",
|
||||
"owner": {
|
||||
"name": "Aide Team"
|
||||
},
|
||||
"metadata": {
|
||||
"description": "Aide 工作流体系插件市场",
|
||||
"version": "1.0.0"
|
||||
},
|
||||
"plugins": [
|
||||
{
|
||||
"name": "aide-plugin",
|
||||
"source": "./aide-plugin",
|
||||
"description": "Aide 工作流体系插件,提供任务准备和执行的标准化流程"
|
||||
}
|
||||
]
|
||||
}
|
||||
9
aide-marketplace/aide-plugin/.claude-plugin/plugin.json
Normal file
9
aide-marketplace/aide-plugin/.claude-plugin/plugin.json
Normal file
@@ -0,0 +1,9 @@
|
||||
{
|
||||
"name": "aide-plugin",
|
||||
"description": "Aide 工作流体系插件,提供任务准备和执行的标准化流程",
|
||||
"version": "1.0.0",
|
||||
"author": {
|
||||
"name": "Aide Team"
|
||||
},
|
||||
"keywords": ["workflow", "task", "aide", "productivity"]
|
||||
}
|
||||
251
aide-marketplace/aide-plugin/commands/exec.md
Normal file
251
aide-marketplace/aide-plugin/commands/exec.md
Normal 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. **可恢复**:任务中断后可通过状态记录恢复进度
|
||||
70
aide-marketplace/aide-plugin/commands/init.md
Normal file
70
aide-marketplace/aide-plugin/commands/init.md
Normal 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. **简体中文**:所有输出使用简体中文
|
||||
219
aide-marketplace/aide-plugin/commands/prep.md
Normal file
219
aide-marketplace/aide-plugin/commands/prep.md
Normal 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. **核心优先**:聚焦任务分析和优化本身,形式问题交给程序处理
|
||||
364
aide-marketplace/aide-plugin/skills/aide/SKILL.md
Normal file
364
aide-marketplace/aide-plugin/skills/aide/SKILL.md
Normal file
@@ -0,0 +1,364 @@
|
||||
---
|
||||
name: aide
|
||||
description: Aide 工作流工具集。提供环境管理、进度追踪、待定项确认等功能。当需要执行 aide 命令、管理任务进度、处理待定项确认时使用。
|
||||
---
|
||||
|
||||
# Aide 工具使用指南
|
||||
|
||||
Aide 是一套命令行工具,用于支持 Aide 工作流体系。所有 aide 命令的输出遵循精简原则。
|
||||
|
||||
## 输出格式
|
||||
|
||||
| 前缀 | 含义 |
|
||||
|------|------|
|
||||
| `✓` | 成功 |
|
||||
| `⚠` | 警告(可继续) |
|
||||
| `✗` | 错误(需处理) |
|
||||
| `→` | 进行中/信息 |
|
||||
|
||||
**静默原则**:无输出 = 正常完成
|
||||
|
||||
---
|
||||
|
||||
## aide env - 环境管理
|
||||
|
||||
### aide env ensure
|
||||
|
||||
检测并修复开发环境。
|
||||
|
||||
```bash
|
||||
aide env ensure
|
||||
```
|
||||
|
||||
**输出示例**:
|
||||
```
|
||||
✓ 环境就绪 (python:3.12, uv:0.4.0)
|
||||
```
|
||||
|
||||
```
|
||||
⚠ 已修复: 创建虚拟环境 .venv
|
||||
✓ 环境就绪 (python:3.12)
|
||||
```
|
||||
|
||||
```
|
||||
✗ Python 版本不满足要求 (需要 >=3.10, 当前 3.8)
|
||||
建议: 安装 Python 3.10+ 或使用 pyenv 管理版本
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## aide flow - 进度追踪
|
||||
|
||||
进度追踪工具,集成 git 自动提交和流程校验。
|
||||
|
||||
### aide flow start
|
||||
|
||||
开始新任务。
|
||||
|
||||
```bash
|
||||
aide flow start <环节名> "<总结>"
|
||||
```
|
||||
|
||||
**参数**:
|
||||
- `<环节名>`:flow-design / impl / verify / docs / finish
|
||||
- `<总结>`:本次操作的简要说明
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow start flow-design "开始任务: 实现用户登录功能"
|
||||
```
|
||||
|
||||
### aide flow next-step
|
||||
|
||||
记录小步骤前进。
|
||||
|
||||
```bash
|
||||
aide flow next-step "<总结>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow next-step "完成数据库模型设计"
|
||||
```
|
||||
|
||||
### aide flow back-step
|
||||
|
||||
记录小步骤回退。
|
||||
|
||||
```bash
|
||||
aide flow back-step "<原因>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow back-step "发现字段命名不符合规范,需要调整"
|
||||
```
|
||||
|
||||
### aide flow next-part
|
||||
|
||||
进入下一个大环节。
|
||||
|
||||
```bash
|
||||
aide flow next-part <环节名> "<总结>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow next-part impl "流程设计完成,开始实现"
|
||||
```
|
||||
|
||||
### aide flow back-part
|
||||
|
||||
回退到之前的大环节。
|
||||
|
||||
```bash
|
||||
aide flow back-part <环节名> "<原因>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow back-part flow-design "实现中发现设计遗漏,需要补充"
|
||||
```
|
||||
|
||||
### aide flow issue
|
||||
|
||||
记录一般问题(不阻塞继续)。
|
||||
|
||||
```bash
|
||||
aide flow issue "<描述>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow issue "测试覆盖率较低,后续需要补充"
|
||||
```
|
||||
|
||||
### aide flow error
|
||||
|
||||
记录严重错误(需要解决)。
|
||||
|
||||
```bash
|
||||
aide flow error "<描述>"
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide flow error "数据库连接失败,无法继续"
|
||||
```
|
||||
|
||||
### 环节名称列表
|
||||
|
||||
| 环节名 | 说明 |
|
||||
|-------|------|
|
||||
| `flow-design` | 流程设计 |
|
||||
| `impl` | 迭代实现 |
|
||||
| `verify` | 验证交付 |
|
||||
| `docs` | 文档更新 |
|
||||
| `finish` | 收尾 |
|
||||
|
||||
### 流程校验
|
||||
|
||||
aide flow 会自动校验环节跳转是否合理:
|
||||
- `flow-design` → `impl` ✓
|
||||
- `impl` → `verify` ✓
|
||||
- `impl` → `flow-design` ✓(回退)
|
||||
- `flow-design` → `finish` ✗(跳过环节)
|
||||
|
||||
### Git 集成
|
||||
|
||||
每次调用 aide flow 命令都会自动执行:
|
||||
1. `git add .`
|
||||
2. `git commit -m "<自动生成的提交信息>"`
|
||||
|
||||
提交信息格式:`[aide] <环节>: <总结>`
|
||||
|
||||
---
|
||||
|
||||
## aide decide - 待定项确认
|
||||
|
||||
通过 Web 界面处理待定项确认。
|
||||
|
||||
### aide decide
|
||||
|
||||
提交待定项数据并启动 Web 服务。
|
||||
|
||||
```bash
|
||||
aide decide '<json数据>'
|
||||
```
|
||||
|
||||
**JSON 格式**:
|
||||
```json
|
||||
{
|
||||
"task": "任务简述",
|
||||
"source": "now-task.md",
|
||||
"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"]
|
||||
},
|
||||
{
|
||||
"value": "option_b",
|
||||
"label": "选项B描述",
|
||||
"score": 70,
|
||||
"pros": ["优点1"],
|
||||
"cons": ["缺点1", "缺点2"]
|
||||
}
|
||||
],
|
||||
"recommend": "option_a"
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
**输出**:
|
||||
```
|
||||
→ Web 服务已启动
|
||||
→ 请访问: http://localhost:3721
|
||||
→ 等待用户完成决策...
|
||||
```
|
||||
|
||||
### aide decide result
|
||||
|
||||
获取用户决策结果。
|
||||
|
||||
```bash
|
||||
aide decide result
|
||||
```
|
||||
|
||||
**输出格式**:
|
||||
```json
|
||||
{
|
||||
"decisions": [
|
||||
{"id": 1, "chosen": "option_a"},
|
||||
{"id": 2, "chosen": "option_b", "note": "用户的补充说明"}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
> 注:`note` 字段仅在用户添加备注时出现
|
||||
|
||||
---
|
||||
|
||||
## aide config - 配置管理
|
||||
|
||||
### aide config get
|
||||
|
||||
获取配置值。
|
||||
|
||||
```bash
|
||||
aide config get <key>
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide config get flow.phases
|
||||
```
|
||||
|
||||
**输出**:
|
||||
```
|
||||
["flow-design", "impl", "verify", "docs", "finish"]
|
||||
```
|
||||
|
||||
### aide config set
|
||||
|
||||
设置配置值。
|
||||
|
||||
```bash
|
||||
aide config set <key> <value>
|
||||
```
|
||||
|
||||
**示例**:
|
||||
```bash
|
||||
aide config set env.python.version ">=3.11"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## aide init
|
||||
|
||||
初始化 .aide 目录和默认配置。
|
||||
|
||||
```bash
|
||||
aide init
|
||||
```
|
||||
|
||||
**操作**:
|
||||
1. 创建 `.aide/` 目录
|
||||
2. 生成默认 `config.toml`
|
||||
3. 检查并更新 `.gitignore`
|
||||
|
||||
**输出**:
|
||||
```
|
||||
✓ 已创建 .aide/ 目录
|
||||
✓ 已生成默认配置
|
||||
✓ 已添加 .aide/ 到 .gitignore
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 数据存储
|
||||
|
||||
所有 aide 数据文件存放在项目根目录的 `.aide/` 下:
|
||||
|
||||
```
|
||||
.aide/
|
||||
├── config.toml # 项目配置
|
||||
├── flow-status.json # 当前任务进度
|
||||
├── decisions/ # 待定项决策记录
|
||||
│ └── {timestamp}.json
|
||||
└── logs/ # 操作日志
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见用法示例
|
||||
|
||||
### 开始新任务
|
||||
|
||||
```bash
|
||||
aide flow start flow-design "开始任务: 实现用户认证模块"
|
||||
```
|
||||
|
||||
### 记录实现进度
|
||||
|
||||
```bash
|
||||
aide flow next-step "完成 User 模型定义"
|
||||
aide flow next-step "完成密码加密工具"
|
||||
aide flow next-step "完成登录接口"
|
||||
```
|
||||
|
||||
### 进入下一环节
|
||||
|
||||
```bash
|
||||
aide flow next-part verify "实现完成,开始验证"
|
||||
```
|
||||
|
||||
### 处理待定项
|
||||
|
||||
```bash
|
||||
# 提交待定项(JSON 数据较长时建议保存到文件后通过 cat 传入)
|
||||
aide decide '{"task":"...", "items":[...]}'
|
||||
|
||||
# 获取结果
|
||||
aide decide result
|
||||
```
|
||||
|
||||
### 记录问题
|
||||
|
||||
```bash
|
||||
aide flow issue "部分边界情况未覆盖测试"
|
||||
aide flow error "CI 构建失败"
|
||||
```
|
||||
168
discuss/02-commands与skill设计完成报告.md
Normal file
168
discuss/02-commands与skill设计完成报告.md
Normal file
@@ -0,0 +1,168 @@
|
||||
# Commands 与 SKILL.md 设计完成报告
|
||||
|
||||
## 一、完成内容
|
||||
|
||||
### 1.1 插件目录结构
|
||||
|
||||
```
|
||||
aide-marketplace/
|
||||
├── .claude-plugin/
|
||||
│ └── marketplace.json ✓ 已创建
|
||||
└── aide-plugin/
|
||||
├── .claude-plugin/
|
||||
│ └── plugin.json ✓ 已创建
|
||||
├── commands/
|
||||
│ ├── init.md ✓ 已创建
|
||||
│ ├── prep.md ✓ 已创建
|
||||
│ └── exec.md ✓ 已创建
|
||||
└── skills/
|
||||
└── aide/
|
||||
└── SKILL.md ✓ 已创建
|
||||
```
|
||||
|
||||
### 1.2 文件说明
|
||||
|
||||
| 文件 | 行数 | 说明 |
|
||||
|------|------|------|
|
||||
| `init.md` | ~80 | 项目认知与环境初始化命令 |
|
||||
| `prep.md` | ~180 | 任务准备流程命令 |
|
||||
| `exec.md` | ~200 | 任务执行流程命令 |
|
||||
| `SKILL.md` | ~280 | aide 工具完整使用指南 |
|
||||
|
||||
---
|
||||
|
||||
## 二、设计要点
|
||||
|
||||
### 2.1 Commands 设计理念
|
||||
|
||||
**聚焦思考方法论,不涉及工具细节**
|
||||
|
||||
三个 Command 分别定义了:
|
||||
- **init**:认知框架建立 + 环境准备
|
||||
- **prep**:任务分析优化的思考方法
|
||||
- **exec**:任务执行的流程框架
|
||||
|
||||
Command 只告诉 LLM "怎么思考"和"流程是什么",具体工具调用由 SKILL.md 负责。
|
||||
|
||||
### 2.2 SKILL.md 设计理念
|
||||
|
||||
**纯工具说明,便于快速查阅**
|
||||
|
||||
SKILL.md 包含:
|
||||
- 所有 aide 子命令的语法和参数
|
||||
- 输入输出格式
|
||||
- 典型使用示例
|
||||
|
||||
不包含流程指导和业务逻辑。
|
||||
|
||||
### 2.3 职责分离
|
||||
|
||||
| 内容 | 所属位置 |
|
||||
|------|----------|
|
||||
| 流程阶段划分 | Commands |
|
||||
| 思考方向指导 | Commands |
|
||||
| 决策边界定义 | Commands |
|
||||
| 命令语法 | SKILL.md |
|
||||
| 参数说明 | SKILL.md |
|
||||
| 输出格式 | SKILL.md |
|
||||
|
||||
---
|
||||
|
||||
## 三、与原体系对比
|
||||
|
||||
### 3.1 保留的核心内容
|
||||
|
||||
| 原体系 | 新设计 |
|
||||
|--------|--------|
|
||||
| A/B 双流程 | prep/exec 命令 |
|
||||
| 任务分析阶段 | prep 阶段1 |
|
||||
| 任务优化阶段 | prep 阶段2 |
|
||||
| 待定项处理 | prep 阶段3 + aide decide |
|
||||
| 流程设计环节 | exec 环节1 |
|
||||
| 任务主体循环 | exec 环节2 |
|
||||
| 验证结果 | exec 环节3 |
|
||||
| 文档更新 | exec 环节4 |
|
||||
| 收尾 | exec 环节5 |
|
||||
|
||||
### 3.2 精简的内容
|
||||
|
||||
| 原体系 | 新设计 |
|
||||
|--------|--------|
|
||||
| MCP调用基准表 | 删除(Claude Code 自行处理) |
|
||||
| 模板/命令详细说明 | 移入 SKILL.md |
|
||||
| CSV 状态文件格式 | 改为 JSON,由程序管理 |
|
||||
| PlantUML 命令 | 由 aide flow 在特定环节自动校验 |
|
||||
| 执行自检表 | 简化为注意事项 |
|
||||
|
||||
### 3.3 新增的改进
|
||||
|
||||
| 改进 | 说明 |
|
||||
|------|------|
|
||||
| init 命令 | 新增项目认知阶段,环境问题前置解决 |
|
||||
| aide decide Web 界面 | 待定项可视化操作 |
|
||||
| aide flow git 集成 | 自动 add + commit |
|
||||
| 流程校验 | 防止环节跳跃 |
|
||||
| 环节特定行为 | flow-design 检查 PlantUML,docs 检查 CHANGELOG |
|
||||
|
||||
---
|
||||
|
||||
## 四、使用流程示意
|
||||
|
||||
### 4.1 完整工作流
|
||||
|
||||
```
|
||||
用户进入项目
|
||||
↓
|
||||
/aide:init → 项目认知 + 环境检测
|
||||
↓
|
||||
/aide:prep → 任务分析 + 优化 + 待定项 → task-spec.md
|
||||
↓
|
||||
/aide:exec → 流程设计 → 实现 → 验证 → 文档 → 收尾
|
||||
↓
|
||||
任务完成
|
||||
```
|
||||
|
||||
### 4.2 aide 命令调用时机
|
||||
|
||||
| 阶段 | aide 命令 |
|
||||
|------|-----------|
|
||||
| init | `aide env ensure`, `aide init` |
|
||||
| prep | `aide decide`, `aide decide result` |
|
||||
| exec | `aide flow start/next-step/next-part/...` |
|
||||
|
||||
---
|
||||
|
||||
## 五、待后续设计
|
||||
|
||||
以下内容暂未在本次设计中实现:
|
||||
|
||||
1. **aide flow 详细设计**
|
||||
- 状态机定义
|
||||
- 流程校验规则
|
||||
- 环节特定行为的具体实现
|
||||
|
||||
2. **aide decide Web 界面**
|
||||
- 前端页面设计
|
||||
- 交互流程
|
||||
- API 接口
|
||||
|
||||
3. **aide 程序实现**
|
||||
- Python 入口
|
||||
- 各模块代码
|
||||
|
||||
4. **配置文件**
|
||||
- 完整字段定义
|
||||
- 默认值模板
|
||||
|
||||
---
|
||||
|
||||
## 六、下一步建议
|
||||
|
||||
1. **审阅本次设计**:确认 Commands 和 SKILL.md 的内容是否符合预期
|
||||
2. **进入实现阶段**:开始开发 aide 程序
|
||||
3. **优先级建议**:
|
||||
- 先实现 `aide env ensure`(init 依赖)
|
||||
- 再实现 `aide decide`(prep 依赖)
|
||||
- 最后实现 `aide flow`(exec 依赖)
|
||||
|
||||
请查阅 `aide-marketplace/` 目录下的文件,确认设计是否满足需求。
|
||||
3
reply/re-02.md
Normal file
3
reply/re-02.md
Normal file
@@ -0,0 +1,3 @@
|
||||
1. 我同意方案A
|
||||
2. 由你在遵循commands设计理念的规则下自行发挥,编写能实现目标效果的最优commands
|
||||
3. 连续完成commands和skills部分,暂时不处理aide细节设计,
|
||||
20
reply/re-03.md
Normal file
20
reply/re-03.md
Normal file
@@ -0,0 +1,20 @@
|
||||
# 调整意见
|
||||
|
||||
1. command init中指导的是先`aide env ensure`再`aide init`(视.aide/是否存在):
|
||||
- env的检查需要用到环境配置文件,但配置文件在.aide下
|
||||
- init会创建配置文件,但后续没提要再次检查env
|
||||
- 这个顺序是否存在问题
|
||||
|
||||
能不能把init提到env前执行,在设计程序时保证init的运行不依赖于任何需要另外安装的包,保证只要aide封装脚本检测到了python3就一定能运行init,
|
||||
|
||||
如果无法保证(比如要引入配置文件解析的包),那能否把env拆分为两部分,然后:
|
||||
|
||||
1. 先执行aide env ensure --aide-runtime 本身所需runtime的环境检查和自动修复保证可运行所有aide程序
|
||||
2. 执行aide init确保配置文件
|
||||
3. 执行aide env检查项目所需环境配置
|
||||
|
||||
2. 把状态记录、流程变更、git操作等全部程序化封装为aide指令后,剩下的部分已经很轻量了,prep和exec都不需要也不应该再主动向LLM提出关于git操作、状态记录等操作的提示词,只要让LLM有流程和步骤的概念,按要求执行aide flow即可,不应该再主动关注那些自动化的操作本身的事,
|
||||
|
||||
3. 而且我希望的是prep的最开始就要执行aide flow,我在before-2.md中已经举了很详细的从头开始的先后调用的示例了,你要更正prep的指导内容,并更新skill中关于开头部分的flow环节名
|
||||
|
||||
4. 我想要prep和exec都要可以接受传入指定文档路径参数,prep指定任务原文档,exec指定任务细则文档,当未传入时,使用项目的环境配置文件中设置的默认的原文档和细则文档(这个配置应该要在init阶段最后检查项目环境配置时由aide env输出反馈给LLM,通常默认情况下原文档默认为task-now.md, 细则文档默认为task-spec.md),
|
||||
Reference in New Issue
Block a user