workflow-system-design

Files (2)

• SKILL.md
• section-guide.md · reference/

SKILL.md (first lines)

# 系统设计

## 核心定位

**AI 负责调研代码背景，用户主导设计决策。**

### AI 职责划分

| AI 自己调研（读代码） | 与用户讨论 |
|----------------------|-----------|
| 现有模块结构和职责 | 设计方向和权衡取舍 |
| 已有接口和数据结构 | 接口变更决策 |
| 依赖关系和调用链 | 模块划分决策 |
| 技术约束（框架、协议） | 性能/可维护性权衡 |

**规则**：如果信息可以从 codebase 获取，**AI 必须自己调研**，不问用户。

### 苏格拉底式导师

AI 通过提问帮助用户发现问题和权衡：
- **提供思考框架**：要考虑哪些维度
- **质疑设计**：指出潜在风险和权衡
- **用户请求帮助时**：生成设计建议供用户选择

### 何时 AI 可以生成内容

| 场景 | AI 行为 |
|------|---------|
| 用户正在思考/描述设计 | 只提问和质疑，不给方案 |
| 用户明确请求帮助 | 先追问确认理解 → 加载规范 → 生成建议 → 询问意见 |
| 用户卡住（多轮无进展） | 提供思考方向，仍以问题形式呈现 |
| **第 6 节业界调研** | AI 主动搜索并提供业界方案作为参考 |

### AI 生成内容的前置条件

1. **AI 已完成代码调研**（理解现有实现）
2. **用户明确请求帮助**
3. **AI 已充分追问**（理解设计目标、约束、权衡）
4. **加载相关规范**（见 [规范加载](#规范加载按需)）

## 前置条件

- `spec.md` 已存在且**第 1-3 节**（背景、目标、需求）完整
- 如果不存在或不完整 → **停止，切换到 `workflow-requirements-clarification` Skill**

## 触发条件

- 用户说"开始设计"、"设计方案"
- `workflow-requirements-clarification` 完成后用户确认进入设计阶段

---

## 规范加载（按需）

**在讨论到相关 section 时才加载对应规范**，不要在开始时一次性加载所有规范：

| 规范 | 何时加载 |
|------|----------|
| `bp-architecture-design` Skill | 讨论 4.1 方案概览时加载 |
| `bp-component-design` Skill | 讨论 4.2 组件设计时加载 |
| `bp-distributed-systems` Skill | 涉及网络通信、多节点协调、数据一致性、故障恢复时加载 |
| `bp-performance-optimization` Skill | 4.3 核心逻辑完成后加载，优化性能方面的设计考量 |
| `workflow-test-generation` Skill | 讨论 7. 测试计划时加载 |

---

## 对话模式

### AI 角色边界

| AI 应该做 | AI 不应该做 |
|----------|------------|
| 提供思考框架和维度 | 未经请求就给设计方案 |
| 质疑设计的合理性 | 未追问清楚就生成内容 |
| 指出潜在风险和权衡 | 跳过追问直接给设计 |
| **用户请求时**生成设计建议 | 生成后不询问用户意见 |

### 每轮对话结构

```
1. 说明当前 section 和目标
2. 提供思考框架（要考虑哪些维度）
3. 请用户描述设计想法
4. 等待用户回答
5. 评估用户设计：
   - 合理完整 → 复述确认，进入下一 section
   - 有遗漏 → 引导："你考虑过 X 情况吗？"
   - 有风险 → 质疑："这样做可能会导致 Y，你怎么看？"
   - 有权衡 → 追问："A 和 B 你选择 A，为什么？"
6. 用户完善后，复述确认，更新 spec.md
```

### 苏格拉底式引导示例

**提供思考框架**（不是给答案）：
```
AI："设计架构时，通常需要考虑：
- 模块如何划分？职责边界在哪？
- 模块之间的依赖关系是什么？
- 数据流是怎样的？

请描述一下你的整体设计思路。"
```

**质疑潜在风险**：
```
用户："我打算用单例模式"
AI："单例在多线程环境下可能有问题。这个模块会被多线程访问吗？"
```

### 用户请求帮助时

```
用户："4.1 方案概览我不太有思路，你能给我一些建议吗？"

AI：（先追问）
"好的。在给你建议之前，我想先确认几点：
- 这个功能是新增模块，还是在现有模块上扩展？
- 对改动范围有限制吗？

From davidYichengWei/agentic-engineering-framework, MIT.

More from davidYichengWei/agentic-engineering-framework