CraftKit/plugins/dev/skills/design-frontend-data/SKILL.md

name, description

name	description
design-frontend-data	设计前端请求边界、视图模型、状态所有权、缓存、并发和请求响应转换。适用于前端数据层与状态流设计；页面结构、HTTP API 设计、接口字段映射或直接编码不应触发。

前端数据设计

让传输模型、领域数据、视图状态和组件局部状态边界清晰，并适配项目真实框架与请求封装。

工作流

1. 确认框架版本、渲染模式、请求客户端、状态管理和现有数据边界。
2. 区分服务端状态、共享客户端状态、页面状态、局部状态和可派生状态。
3. 设计加载、成功、空、错误、取消、重试、竞态、缓存失效和乐观更新行为。
4. 按 官方来源 核实浏览器请求和框架状态语义。
5. 输出数据流、所有权、转换边界、并发策略、错误策略和测试点，不预设字段或请求封装。
6. 用户要求保存设计文档时读取 .craftkit/project.json 的 documents 配置，过程设计使用 workRoot，共享设计使用 designRoot。

落盘前检索同主题的需求、设计、规范或知识，优先更新已有权威文档。共享长期文档新建或实质修改后按 .craftkit/standards/document-maintenance.md 更新审核状态；排版和错字修正不改变状态。rnrn写入后在 workRoot/<task>/task.json 登记本次创建、更新或引用的文档及 relationship；已有记录时保守合并。关联旧文档不转移所有权，也不产生删除权限；不修改项目级默认配置。

具体 API 字段映射交由 prepare-api，页面组合交由 design-frontend。