用途：在主要 Web 应用中实现或扩展面向用户的工作流，对接已有后端 API，并遵循既有设计系统、路由与测试约定。
适用时机：改动以 UI/UX 为主且依赖一个或多个已有 API；后端契约、认证模型与核心业务规则已存在；仅影响 Web 前端，不涉及数据模型或服务归属变更。
输入：功能描述（用户流程与结果简述）、相关 API（端点、请求/响应类型及源码定义链接）、目标路由/组件（路径、组件名或功能模块）、设计参考（Figma 链接或需对齐的现有页面）、约束（性能限制、无障碍要求与安全限制）。
范围外：创建新后端服务或修改持久化数据模型；修改认证/授权流程；引入新的前端框架或设计系统。
约定：框架为 React + TypeScript；路由使用现有路由与布局模式；样式使用内部设计系统组件（Buttons、Inputs、Modals、Toasts 等）；状态管理优先使用现有库（如 React Query、Redux、Zustand）并遵循既有模式。
必需行为：为所有 props 与 API 响应提供强类型；使用现有基础组件处理加载、空、错误与成功状态；确保键盘可访问且对屏幕阅读器友好；在适用处遵循功能开关与发布机制。
必需产物：在对应功能模块中更新组件与 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 描述中标注差异。