用途：在主要 Web 应用中实现或扩展面向用户的工作流，对接已有后端 API，并遵循既有设计系统、路由与测试约定。
适用场景：功能主要是 UI/UX 变更且由一个或多个已有 API 支撑；后端契约、鉴权模型和核心业务规则已存在；变更仅影响 Web 前端，不涉及 schema 或服务归属调整。
输入：功能描述（用户流程与结果的简短叙述）、相关 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 描述中标注差异。