diff --git a/aide-marketplace/.claude-plugin/marketplace.json b/aide-marketplace/.claude-plugin/marketplace.json new file mode 100644 index 0000000..6c97bda --- /dev/null +++ b/aide-marketplace/.claude-plugin/marketplace.json @@ -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 工作流体系插件,提供任务准备和执行的标准化流程" + } + ] +} diff --git a/aide-marketplace/aide-plugin/.claude-plugin/plugin.json b/aide-marketplace/aide-plugin/.claude-plugin/plugin.json new file mode 100644 index 0000000..4b2dfe5 --- /dev/null +++ b/aide-marketplace/aide-plugin/.claude-plugin/plugin.json @@ -0,0 +1,9 @@ +{ + "name": "aide-plugin", + "description": "Aide 工作流体系插件,提供任务准备和执行的标准化流程", + "version": "1.0.0", + "author": { + "name": "Aide Team" + }, + "keywords": ["workflow", "task", "aide", "productivity"] +} diff --git a/aide-marketplace/aide-plugin/commands/exec.md b/aide-marketplace/aide-plugin/commands/exec.md new file mode 100644 index 0000000..3b88491 --- /dev/null +++ b/aide-marketplace/aide-plugin/commands/exec.md @@ -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. **可恢复**:任务中断后可通过状态记录恢复进度 diff --git a/aide-marketplace/aide-plugin/commands/init.md b/aide-marketplace/aide-plugin/commands/init.md new file mode 100644 index 0000000..b4710a2 --- /dev/null +++ b/aide-marketplace/aide-plugin/commands/init.md @@ -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. **简体中文**:所有输出使用简体中文 diff --git a/aide-marketplace/aide-plugin/commands/prep.md b/aide-marketplace/aide-plugin/commands/prep.md new file mode 100644 index 0000000..712c390 --- /dev/null +++ b/aide-marketplace/aide-plugin/commands/prep.md @@ -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 '' +``` + +程序会启动 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. **核心优先**:聚焦任务分析和优化本身,形式问题交给程序处理 diff --git a/aide-marketplace/aide-plugin/skills/aide/SKILL.md b/aide-marketplace/aide-plugin/skills/aide/SKILL.md new file mode 100644 index 0000000..f5d84be --- /dev/null +++ b/aide-marketplace/aide-plugin/skills/aide/SKILL.md @@ -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 +{ + "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 +``` + +**示例**: +```bash +aide config get flow.phases +``` + +**输出**: +``` +["flow-design", "impl", "verify", "docs", "finish"] +``` + +### aide config set + +设置配置值。 + +```bash +aide config set +``` + +**示例**: +```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 构建失败" +``` diff --git a/discuss/02-commands与skill设计完成报告.md b/discuss/02-commands与skill设计完成报告.md new file mode 100644 index 0000000..30a75da --- /dev/null +++ b/discuss/02-commands与skill设计完成报告.md @@ -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/` 目录下的文件,确认设计是否满足需求。 diff --git a/reply/re-02.md b/reply/re-02.md new file mode 100644 index 0000000..5d6b496 --- /dev/null +++ b/reply/re-02.md @@ -0,0 +1,3 @@ +1. 我同意方案A +2. 由你在遵循commands设计理念的规则下自行发挥,编写能实现目标效果的最优commands +3. 连续完成commands和skills部分,暂时不处理aide细节设计, \ No newline at end of file diff --git a/reply/re-03.md b/reply/re-03.md new file mode 100644 index 0000000..027f061 --- /dev/null +++ b/reply/re-03.md @@ -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),