用途：在既有主 Web 应用中实现或扩展面向用户的工作流，对接现有后端 API，并遵循团队的设计系统、路由与测试约定。适用于以后端契约、鉴权模型和核心业务规则均已存在，且改动仅限 Web 前端、不涉及数据模型或服务归属变更的功能。
输入：功能描述（用户流程与预期的简短叙述）；相关 API（端点、请求/响应类型及源定义链接）；目标路由/组件（路径、组件名或功能模块）；设计参考（Figma 链接或可参照的现有界面）；约束（性能上限、无障碍要求、安全限制）。
约定：框架为 React + TypeScript；路由使用现有 router 与路由布局模式；样式使用内部设计系统组件（Buttons、Inputs、Modals、Toasts 等）；状态管理优先复用现有状态库（如 React Query、Redux、Zustand）并沿用既定模式。
必要行为：所有 props 与 API 响应强类型化；用现有基础组件处理 loading、empty、error、success 状态；保证键盘可访问与屏幕阅读器友好；在适用处遵循功能开关与灰度发布机制。
必要产出：相应功能模块中更新后的组件与 hooks；核心展示逻辑的单元测试；新流程的集成或组件测试（若仓库已使用 React Testing Library、Cypress、Playwright）；简短 CHANGELOG 或 PR 描述（放在 PR 中，不写入本文件）。
实施清单：定位相关功能模块与现有组件；确认后端 API 与类型，必要时更新共享 TypeScript 类型；实现 UI 并通过现有数据层接入 API 调用；新增或更新测试覆盖新行为与边界情况；运行所需校验命令。
验证：运行 pnpm lint、pnpm test -- --runInBand --watch=false、pnpm typecheck（如单独配置）（命令需按项目实际情况调整）。完成标准为所有测试、linter 与类型检查通过，新 UI 在正常、错误与边界情况下符合规格，且未修改无关文件或模块。
限制：不创建新的后端服务或修改持久化数据模型；不修改鉴权/授权流程；不引入新的前端框架或设计系统。若需求涉及后端契约变更，应停止并转为后端任务；若设计参考与现有无障碍标准冲突，优先无障碍并在 PR 描述中说明差异。