提示词增强器（Prompt Enhancer）

将简短的开发请求转化为清晰详细的需求规格，通过分析项目上下文（代码结构、依赖、规范、现有模式）生成更准确的、上下文感知的提示词。在实施前将增强后的需求呈现给用户确认。

使用场景

在以下情况使用此技能：

• 用户提供简短的开发请求，如"帮我做登录功能"、"加个 API"
• 请求缺少具体实现细节
• 用户上传了项目文件或提到"这个项目"
• 任务需要理解项目架构

核心工作流程

第一步：分析项目上下文

检查上传文件：

view /mnt/user-data/uploads

采集关键信息：

• 项目结构和组织方式
• 技术栈（package.json、pubspec.yaml、requirements.txt 等）
• 现有模式（状态管理、API 调用、路由）
• 代码规范（命名、文件结构）
• 类似的已有功能

第二步：提取请求意图

从用户的简短请求中识别：

• 功能类型：新功能、Bug 修复、重构、API 集成
• 范围：单一页面、完整流程、后端 + 前端
• 依赖：相关功能或系统

第三步：构建增强需求

创建结构化需求文档：

# [功能名] 实现需求

## 项目上下文
- 框架：[检测到的框架和版本]
- 架构：[检测到的模式]
- 状态管理：[检测到的库]
- 关键库：[列出相关依赖]

## 实现范围

### 主要功能
1. [主功能 1]
2. [主功能 2]
3. [主功能 3]

### 文件结构

[基于项目预期的文件结构]

## 详细需求

### 1. [层/组件名称]
- **位置**：[文件路径]
- **用途**：[做什么]
- **实现内容**：
  - [具体需求 1]
  - [具体需求 2]
- **遵循现有模式**：[引用已有模式]

### 2. [下一个层/组件]
...

## 成功标准
- [ ] [验收标准 1]
- [ ] [验收标准 2]
- [ ] [验收标准 3]
- [ ] 保持现有代码风格和架构一致性
- [ ] 为所有主要功能编写测试

## 待确认事项
- [需要澄清的问题]
- [做出的假设]

按以上需求进行吗？有需要修改的地方请告诉我！

有效增强的技巧

始终请求澄清

如果项目上下文不清楚或不够：

如果能上传项目文件，我可以生成更准确的需求。
或者请告诉我以下信息：
- 使用的框架
- 状态管理库
- 现有项目结构

包含视觉参考

适当时提及已有页面/组件：

参照现有 ProfileScreen 的类似布局实现
- AppBar 样式相同
- 复用 TextFormField 设计
- 使用 PrimaryButton 组件

标注依赖关系

## 关联功能
- UserRepository：复用于用户信息查询
- TokenStorage：使用现有的令牌存储逻辑
- ErrorHandler：应用通用错误处理

参考文件

详细模式请参见：

• 增强模式：references/enhancement-patterns.md
• 框架指南：references/framework-guides.md