solution-design

方案设计与选择技能 (增强版)

参数规范

参数	说明	处理方式
需求描述	功能/问题描述	创建 feature 记录
id	已存在的 feature_id 或 fix_id	查询已有记录
无参数	-	列出待处理项供选择

---

前置条件

必需前置条件

• 项目已注册到 memory_mcp

推荐前置条件

• 已完成相关性探索结果

---

⚠️ 重要指令

DO NOT ENTER PLAN MODE - 此技能要求直接执行，不进入计划模式

所有memory_mcp的操作使用子代理来处理，减少主窗口上下文

---

初始化

1. 确定项目 ID

   • 从 CLAUDE.md 读取项目名称
   • 通过 memory_mcp 查询获取 project_id

2. 获取或创建目标条目

   情况A: 参数是已存在的 id (格式如 feat_YYYYMMDD_N 或 fix_YYYYMMDD_N)

   • 直接查询该 id
   • 获取条目详情

   情况B: 参数是需求描述

   • 使用子代理调用 project_add 创建 feature 记录
   • 获取新创建的 feature_id

   情况C: 无参数

   • 列出 features 分组中 status=pending/in_progress 的条目
   • 列出 fixes 分组中 status=pending/in_progress 的条目
   • 让用户选择一个

3. 读取关联内容:

   • 条目的 content 字段（需求/问题描述）
   • 条目的 tags（了解上下文）
   • 如果条目有 related 字段，读取关联的 note 内容

4. 读取项目规范，确保方案符合规范要求

---

阶段 1: 代码库探索与需求分析

目标: 深入理解现有架构和需求

流程:

1. 使用 Explore 代理探索代码库 (thoroughness: medium)

   • 分析现有架构模式
   • 识别相关模块和依赖
   • 查找类似功能的实现参考

2. 需求拆解

   • 识别核心需求点
   • 识别边界条件
   • 识别约束条件（性能、安全、兼容性等）

3. 输出探索摘要给用户确认

---

阶段 2: 方案设计与迭代

目标: 设计多个可行方案并迭代优化

2.1 初始方案设计

设计 2-3 个 不同方向的实现方案，每个方案包含：

方案格式:

## 方案 N: <方案名称>

### 核心思路
<用1-2句话描述方案的核心思想>

### 架构设计
<描述涉及的主要组件和它们的关系>

### 多维度评估
| 维度 | 评分 (1-5) | 说明 |
|------|-----------|------|
| 实现复杂度 | ⭐⭐⭐ | <说明> |
| 可维护性 | ⭐⭐⭐⭐ | <说明> |
| 性能影响 | ⭐⭐ | <说明> |
| 风险等级 | ⭐⭐ | <说明> |
| 扩展性 | ⭐⭐⭐⭐ | <说明> |

### 优点
- <优点1>
- <优点2>
- ...

### 缺点
- <缺点1>
- <缺点2>
- ...

### 技术选型
| 技术点 | 选择方案 | 备选方案 |
|--------|---------|---------|
| <技术点1> | <选择> | <备选> |
| <技术点2> | <选择> | <备选> |

### 实现步骤概要
1. <步骤1>
2. <步骤2>
...

### 影响范围
- **修改文件**: <文件列表>
- **新增文件**: <文件列表>
- **影响模块**: <模块列表>

### 风险识别
- <风险1>: <影响> → <缓解措施>
- <风险2>: <影响> → <缓解措施>

---

2.2 方案对比表格

向用户展示方案对比：

| 方案 | 复杂度 | 可维护性 | 性能 | 风险 | 推荐指数 |
|------|--------|----------|------|------|----------|
| 方案一 | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐⭐ |
| 方案二 | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
| 方案三 | ⭐⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ | ⭐ | ⭐⭐⭐⭐ |