✨ feat: 文档同步

2025-12-15 18:53:39 +08:00
parent 67162d2337
commit 1329643932
16 changed files with 987 additions and 85 deletions
--- a/aide-marketplace/aide-plugin/docs/commands/run.md
+++ b/aide-marketplace/aide-plugin/docs/commands/run.md
@@ -0,0 +1,214 @@
+# /aide:run 命令设计文档
+
+## 一、概述
+
+`/aide:run` 是任务执行的核心命令，整合了任务准备和任务执行功能。
+
+### 1.1 设计目标
+
+| 目标 | 说明 |
+|------|------|
+| 统一入口 | 一个命令完成任务准备和执行 |
+| 状态感知 | 自动检测 flow 状态，支持续接 |
+| 复杂度适应 | 支持简单任务直接执行，复杂任务拆分子计划 |
+
+### 1.2 与旧命令的关系
+
+本命令整合了原 `/aide:prep` 和 `/aide:exec` 的功能。
+
+---
+
+## 二、执行流程
+
+### 2.1 总体流程
+
+```
+┌─────────────────────────────────────────┐
+│            /aide:run                     │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     强制触发 aide skill                  │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     aide flow status                     │
+│     (检查当前 flow 状态)                 │
+└─────────────────────────────────────────┘
+                    │
+        ┌──────────┴──────────┐
+        ▼                     ▼
+   [无活跃任务]          [有活跃任务]
+   [或已 finish]         [未完成]
+        │                     │
+        ▼                     ▼
+   新任务流程              续接流程
+```
+
+### 2.2 新任务流程
+
+```
+┌─────────────────────────────────────────┐
+│     task-optimize (任务准备)             │
+├─────────────────────────────────────────┤
+│ 1. aide flow start task-optimize        │
+│ 2. 读取任务文档                          │
+│ 3. 任务分析                              │
+│ 4. 复杂度评估                            │
+│ 5. 任务优化                              │
+│ 6. 待定项处理（如有）                    │
+│ 7. 生成任务细则                          │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     flow-design (流程设计)               │
+├─────────────────────────────────────────┤
+│ 1. aide flow next-part flow-design      │
+│ 2. 制定执行计划                          │
+│ 3. 创建流程图（PlantUML）                │
+│ 4. aide flow next-part impl             │
+│    (自动校验并生成 PNG)                  │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     impl (迭代实现)                      │
+├─────────────────────────────────────────┤
+│ 按计划执行，每步记录：                   │
+│ aide flow next-step "<完成内容>"         │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     verify (验证交付)                    │
+├─────────────────────────────────────────┤
+│ 1. aide flow next-part verify           │
+│ 2. 对照任务细则验证                      │
+│ 3. 执行测试（如适用）                    │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     docs (文档更新)                      │
+├─────────────────────────────────────────┤
+│ 1. aide flow next-part docs             │
+│ 2. 更新 README、CHANGELOG 等            │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     finish (收尾)                        │
+├─────────────────────────────────────────┤
+│ 1. aide flow next-part finish           │
+│ 2. 清理临时文件                          │
+│ 3. 向用户汇报                            │
+└─────────────────────────────────────────┘
+```
+
+### 2.3 续接流程
+
+```
+┌─────────────────────────────────────────┐
+│     分析当前进度                         │
+├─────────────────────────────────────────┤
+│ aide flow status                         │
+│ aide flow show <task_id>                 │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     载入项目认知                         │
+├─────────────────────────────────────────┤
+│ 调用 /aide:load 逻辑                     │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     读取任务细则                         │
+├─────────────────────────────────────────┤
+│ aide config get task.spec                │
+└─────────────────────────────────────────┘
+                    │
+                    ▼
+┌─────────────────────────────────────────┐
+│     从中断处继续执行                     │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## 三、复杂任务处理
+
+### 3.1 复杂度评估
+
+根据**任务复杂度评估指导原则**判断：
+
+| 等级 | 特征 | 处理方式 |
+|------|------|----------|
+| 简单 | 单文件或少量文件 | 直接执行 |
+| 中等 | 2-4 个模块 | 直接执行 |
+| 复杂 | 5+ 模块 | **拆分子计划** |
+| 超大 | 10+ 模块 | 拆分独立任务 |
+
+### 3.2 子计划执行模式
+
+```
+task-optimize
+    │
+    ▼
+[flow-design → impl → verify → docs] × N
+    │
+    ▼
+finish
+```
+
+每个子计划完成 docs 后，回退到 flow-design 开始下一个子计划。
+
+---
+
+## 四、职责边界
+
+### 4.1 本命令负责
+
+- 检查 flow 状态
+- 任务分析和优化
+- 复杂度评估和子计划拆分
+- 待定项处理
+- 流程设计和流程图创建
+- 迭代实现
+- 验证交付
+- 文档更新
+- 收尾汇报
+
+### 4.2 本命令不负责
+
+- 环境配置（由 `/aide:setup` 负责）
+- 项目文档创建和维护（由 `/aide:docs` 负责）
+
+---
+
+## 五、触发的 Skill
+
+| Skill | 触发方式 | 用途 |
+|-------|----------|------|
+| aide | 强制触发 | 提供 aide 命令使用指南 |
+
+---
+
+## 六、相关文档
+
+- [执行文件](../../commands/run.md)
+- [aide skill](../../skills/aide/SKILL.md)
+- [aide flow 子命令](../../../../aide-program/docs/commands/flow.md)
+- [aide decide 子命令](../../../../aide-program/docs/commands/decide.md)
+- [plugin 导览](../README.md)
+
+---
+
+## 七、版本信息
+
+- 创建日期：2025-12-15
+- 整合原 `/aide:prep` 和 `/aide:exec`