# 子计划 5：用户流程图命令实现

## 目标

创建 `/aide:user-graph` 命令，实现面向用户的长期维护流程图系统，支持分步执行和接续执行。

## 具体步骤

### 5.1 添加配置项

**位置**：`aide-program/aide/` 配置模块

**新增配置项**：

```toml
[user_docs]
# 用户流程图目录路径（相对于项目根目录）
graph_path = "docs/graph-guide"

# 流程图计划文件路径
graph_plan_path = "docs/graph-guide/plan.md"
```

### 5.2 创建命令文件

**位置**：`aide-marketplace/aide-plugin/commands/user-graph.md`

**命令流程**：

```
开始
  │
  ├─ 检查计划文件是否存在
  │     │
  │     ├─ 不存在 → 进入分析和计划阶段
  │     │
  │     └─ 存在 → 进入接续执行阶段
  │
  └─ 结束
```

### 5.3 流程图目录结构设计

以用户示例为参考（api-lib + api + user-interface）：

```
docs/graph-guide/
├── plan.md              # 计划和进度文档
├── guide.puml           # 总导览流程图
├── api-lib/             # 子项目 1
│   ├── guide.puml       # 子项目导览
│   ├── module-a.puml    # 模块 A 流程图
│   └── module-b.puml    # 模块 B 流程图
├── api/                 # 子项目 2
│   ├── guide.puml
│   └── ...
└── user-interface/      # 子项目 3
    ├── guide.puml
    └── ...
```

### 5.4 分析和计划阶段

当计划文件不存在时：

1. **加载项目文档**：
   - 读取 `.aide/project-docs/` 下的项目文档
   - 了解项目结构和模块

2. **区块划分**（按业务逻辑整体）：
   - 不同于项目文档的深度全覆盖
   - 目标是呈现整体形式
   - 识别独立的开发项目/模块

3. **复杂度分析**：
   - 评估每个区块的复杂度
   - 估算每个区块需要的工作量
   - 识别可能需要细分的大型区块

4. **生成计划文档**（plan.md）：

```markdown
# 用户流程图编写计划

## 项目概述
[基于项目文档的简要描述]

## 区块划分

| # | 区块名称 | 类型 | 复杂度 | 状态 |
|---|----------|------|--------|------|
| 1 | api-lib | 库项目 | 高 | pending |
| 2 | api | 应用 | 中 | pending |
| 3 | user-interface | 前端 | 中 | pending |

## 执行步骤

### 区块 1: api-lib
- [ ] 步骤 1.1: 分析模块结构
- [ ] 步骤 1.2: 编写 guide.puml
- [ ] 步骤 1.3: 编写 module-a.puml
- [ ] 步骤 1.4: 编写 module-b.puml
...

### 区块 2: api
...

## 当前进度
- 当前区块：1
- 当前步骤：1.1
- 最后更新：[时间戳]

## 备注
[执行过程中的记录]
```

5. **用户确认**：
   - 展示计划摘要
   - 询问是否开始执行

### 5.5 接续执行阶段

当计划文件存在时：

1. **读取计划文档**
2. **定位当前进度**
3. **继续执行未完成的步骤**
4. **每完成一个步骤，更新计划文档**

### 5.6 流程图类型

根据项目内容决定流程图类型：

**不含程序的项目**：
- 引导用户了解项目的流程图
- 内容导航图
- 学习路径图

**含程序的项目**：
- 引导流程图（如何了解项目）
- 程序逻辑流图（参考 /aide:run 中的规范）
  - 入口点
  - 控制结构
  - 语义化抽象
  - 模块化表示
  - 层次化组织

### 5.7 一套流程图的标准

每个开发项目/区块应包含：

1. **guide.puml**：子项目导览
   - 模块概览
   - 调用关系
   - 数据流向

2. **子模块 puml**：详细流程
   - 核心逻辑
   - 关键函数
   - 状态转换

### 5.8 分步执行机制

为支持大型项目的分步执行：

1. **进度持久化**：通过 plan.md 记录进度
2. **接续点精确定位**：通过区块+步骤编号
3. **上下文恢复**：每次执行前读取项目文档和计划
4. **增量产出**：每步完成后保存产出的 puml 文件

## 验证标准

- [ ] 计划文档格式正确，信息完整
- [ ] 区块划分合理，符合业务逻辑
- [ ] 接续执行能正确定位进度
- [ ] 生成的流程图符合 PlantUML 语法
- [ ] 流程图能正确生成 PNG

## 依赖

- 前置：子计划 4（user-docs 命令）
- 后续：无

## 风险评估

- **风险等级**：高
- **潜在影响**：
  - 大型项目可能需要多次对话完成
  - 区块划分不当可能导致重复工作
  - 流程图质量影响用户理解
- **缓解措施**：
  - 完善的进度跟踪机制
  - 用户确认关键决策
  - 参考优秀的流程图设计