本文へ移動
cccskills
無料GitHub で公開

fec-backend-requirements-handoff

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

インストール方法を見る

含まれるファイル(1)

  • SKILL.md2.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

前后端需求交接

用途

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

流程

  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 需要什么数据和行为、哪些规则仍需确认,以及后续前后端需要共同决定的问题。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

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

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

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.

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

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

日本語の概要は準備中です。原文の説明を表示しています。

bovinphang/frontend-craft222026年9月26日 更新

bovinphang のスキルをすべて見る

このスキルの問題を報告する