[ PROMPT_NODE_25748 ]
Frontend To Backend Requirements 说明文档
[ SKILL_DOCUMENTATION ]
# 前端到后端需求
一个 Claude Code 技能,供前端开发人员以协作、非指令性的方式为后端开发人员记录数据需求和 API 需求。
## 目的
此技能帮助前端开发人员沟通**他们需要什么数据**,而不是规定**后端应该如何实现**。它创建了一个结构化的需求文档,描述 UI 需求、用户操作、需要处理的状态以及业务规则,将实现细节留给后端团队。
## 何时使用此技能
在以下情况使用此技能:
- 你需要将 API 需求从前端传达给后端
- 你正在规划一个需要后端支持的新功能
- 你想记录 UI 需要显示哪些数据
- 你正在描述需要后端操作的用户行为
- 用户说出类似以下短语时:
- “后端需求”
- “我需要什么数据”
- “API 需求”
- “后端应该提供什么”
- 描述 UI 组件的数据需求
## 工作原理
该技能引导你以结构化格式记录需求,该格式:
1. **描述功能** - 你正在构建什么屏幕/组件及其目的
2. **列出数据需求** - 需要显示什么信息(无需指定字段名称)
3. **识别操作** - 用户可以做什么以及预期的结果
4. **定义状态** - 加载、空状态、错误和需要处理的边界情况
5. **浮现不确定性** - 需要澄清的问题和假设
6. **邀请协作** - 开启后端输入和反馈的讨论
所有输出都发送到 `.claude/docs/ai//backend-requirements.md` - 不会产生聊天输出。
## 关键特性
### 前端负责
- 需要什么数据
- 存在哪些操作
- 需要处理的 UI 状态
- 面向用户的验证
- 显示需求
### 后端负责
- 数据如何结构化
- 端点设计
- 字段名称和类型
- API 约定
- 性能和缓存策略
### 协作原则
- **描述,不要规定** - 说出你需要什么,而不是如何提供它
- **包含上下文** - 解释为什么需要它有助于后端做出更好的决策
- **浮现未知** - 不要隐藏困惑,邀请澄清
- **邀请反馈** - 明确要求后端的输入
- **保持谦逊** - 你是在请求,而不是在要求
## 输出格式
该技能创建一个具有此结构的 Markdown 文档:
markdown
# 后端需求:
## 上下文
[我们正在构建什么,它是给谁用的]