frontend-to-backend-requirements

前端到后端需求 (frontend-to-backend-requirements) 技能作为前端实现与后端 API 设计之间的结构化桥梁。它专为需要沟通数据需求、UI 状态和业务逻辑的前端开发人员所设计，无需过度干涉后端架构决策或实现细节。通过遵循引导式工作流程，开发者可以清楚表达特定画面所需的数据、启用的用户操作，以及必须处理的边缘案例，让后端开发人员负责“如何实现”，而前端负责“需要什么”。此技能有助于防止模糊不清，减少沟通摩擦，并建立一份需求文档，供后端团队用来提出稳健且高效的解决方案。

• 自动生成标准化的 Markdown 文档，存储于 .claude/docs/ai/<feature-name>/backend-requirements.md。

• 鼓励职责分离，将 UI 状态、用户操作和数据需求与 API 端点设计或字段结构分开。

• 包含专门的讨论日志 (Discussion Log) 部分，用于追踪后端反馈、协商内容及后续决策。

• 强制执行“上下文优先”的文档编写方式，要求在请求数据之前先描述屏幕目标、用户类型和预期工作流程。

• 提供用于提出不确定性和边缘案例的模板，以邀请后端进行反馈并共同解决问题。

• 每当您需要厘清 API 需求、请求 UI 组件的新数据，或描述影响数据获取的业务规则时，请使用此技能。

• 始终保持“请求”模式而非“要求”模式；乐于接受后端关于数据结构、性能或缓存策略的建议。

• 输出内容严格格式化以供文档使用——不提供对话式输出，确保项目仓库中有清晰的技术产出物。

• 非常适合需要减少技术设计讨论开销，同时为前后端整合需求维护清晰真相来源的敏捷团队。

• 通过分析当前功能上下文来确保需求具体、可执行，且不包含过早的实现假设，从而实现无缝运作。