Skip to content
cccskills
FreePublished on GitHub

fec-backend-requirements-handoff

用于前端工作需要向后端团队说明数据、动作、状态、权限、校验或业务规则需求,但不指定端点设计、字段名、数据库形态或实现细节;中文触发词包括 前后端需求交接、后端需求、API 需求澄清、数据需求说明。

The English summary is being prepared. Showing the original description.

Run score Not tested

See how to install

Files included (1)

  • SKILL.md2.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

前后端需求交接

用途

把前端页面和交互所需的数据、动作、状态和疑问整理成后端可讨论的需求说明。

流程

  1. 明确功能上下文

    • 说明页面、流程或组件是什么,面向哪类用户,以及用户完成任务的成功状态。
    • 如果已有设计稿、路由、用户故事或权限角色,先把它们作为事实来源。
  2. 描述前端展示需求

    • 按屏幕或组件列出需要展示的信息、信息之间的关系、排序/过滤/分页需求和可见性规则。
    • 使用业务语言描述“需要展示什么”,不要提前规定 endpoint、字段名、DTO、数据库表或响应嵌套结构。
  3. 描述用户动作和结果

    • 列出用户能执行的动作、期望结果、成功反馈、失败反馈和是否需要乐观更新。
    • 标出幂等性、撤销、确认、危险操作、批量操作或长任务进度等对 UI 有影响的行为。
  4. 补齐状态和业务规则

    • 覆盖 loading、empty、error、partial、permission denied、expired、conflict、offline 和 retrying 等状态。
    • 记录影响 UI 的权限、生命周期、金额/时区/枚举、校验、可编辑条件和边界规则。
  5. 输出讨论文档

    • 默认写到 docs/backend-requirements/<feature-name>.md;若仓库已有需求文档目录,沿用现有位置。
    • 文档包含 Context、Screens/Components、Data Needs、User Actions、UI States、Business Rules、Uncertainties、Questions for Backend 和 Decision Log。
    • 若用户只需要聊天回复,可以直接输出同样结构的 Markdown,不创建文件。

约束

  • 不替后端规定 URL、HTTP 方法、字段名、数据库 schema、缓存实现或服务拆分。
  • 不把前端猜测写成事实;不确定的业务规则必须进入 Uncertainties 或 Questions。
  • 不忽略错误、空态、权限和部分数据;这些状态决定接口协作质量。
  • 不把内部错误栈、数据库字段或敏感实现细节要求暴露给 UI。
  • 不与 API 集成流程重复:本 skill 描述需求,客户端边界、类型来源和错误映射实现应在后续实现阶段处理。

预期输出

产出一份前端视角的后端需求交接说明,清楚描述 UI 需要什么数据和行为、哪些规则仍需确认,以及后续前后端需要共同决定的问题。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

用于审查或改进前端无障碍、语义结构、键盘支持、焦点管理、ARIA 标签、屏幕阅读器行为、WCAG 2.2 问题、触控无障碍或辅助技术回归;中文触发词包括 无障碍、accessibility、a11y、WCAG、屏幕阅读器。

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

Use when reviewing or improving frontend accessibility, semantic structure, keyboard support, focus management, ARIA labels, screen reader behavior, WCAG 2.2 issues, touch accessibility, or assistive-technology regressions; Chinese triggers include accessibility, accessibility, a11y, WCAG, screen reader.

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

Use when absorbing ideas, capabilities, workflows, architecture, quality systems, ecosystem extensions, or engineering practices from any reference system into the current project through original, project-native redesign rather than copying.

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

用于从参考系统中吸收想法、能力、工作流、架构、质量体系、生态扩展或工程实践,并通过原创的项目内重设计转化为当前项目能力,而不是复制原实现。

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

用于设计、实现或审查前后端 API 集成、类型化 API client、REST/tRPC/OpenAPI 客户端选型、认证刷新、API 错误映射、上传流程、SSE/WebSocket/轮询选择、CORS 相关前端行为或跨边界 loading/error 状态。不要用于纯后端服务架构或仅 TanStack Query 缓存策略;中文触发词包括 API 集成、前后端联调、typed API client、接口错误处理、SSE、WebSocket。

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

Use when designing, implementing, or reviewing frontend-to-backend API integration, typed API clients, REST/tRPC/OpenAPI client choices, auth refresh, API error mapping, upload flows, SSE/WebSocket/polling choices, CORS-facing frontend behavior, or cross-boundary loading/error states. Do not use for backend-only service architecture or TanStack Query cache policy alone; Chinese triggers include API integration, front-end and back-end joint debugging, typed API client, Interface error handling, SSE, WebSocket.

The English summary is being prepared. Showing the original description.

bovinphang/frontend-craft22Updated Sep 26, 2026

See all skills by bovinphang

Report a problem with this skill