任务模板：新增页面

适用场景

• 新增一个页面或子页面
• 新增一个现有功能下的详情页、列表页、设置页
• 需要接入已有导航和数据链路

开始前先确认

1. 这是独立功能页，还是已有功能下的一个子页
2. 页面需要页面局部状态、功能共享状态，还是全局状态
3. 页面数据来自已有 repository 还是需要新增接口

先读哪些文档

1. AGENTS.md
2. docs/01-architecture/app-layering.md
3. docs/01-architecture/state-management-matrix.md
4. 目标功能文档，例如 docs/02-features/*.md
5. docs/06-decisions/ADR-0002-新增功能默认状态方案.md

执行步骤

1. 找到最接近的现有页面作为参照
2. 先决定状态作用域：
   • 页面局部：优先本地 state
   • 功能局部共享：沿用当前模块既有方案
   • 应用全局：复用 Redux 或 Riverpod 入口
3. 将页面放入对应功能目录，不要新建随意目录层级
4. 复用现有导航、标题栏、列表、加载和弹窗组件
5. 若页面依赖新数据，再补 repository 或 API 入口
6. 补充对应功能文档，至少记录入口、状态方案和主要数据流

本仓库的默认选择

• 若新增 repos 子页：优先跟随该模块当前 Provider 结构
• 若新增趋势页相关子页：优先跟随 Riverpod 结构
• 若只是很轻的局部页面交互：优先页面本地 state

禁止事项

• 不要为了新页面顺手引入新的状态管理库
• 不要直接把页面私有状态放进全局容器
• 不要复制粘贴一套新的网络调用链路绕过 repository

最低验证

• 页面可正常进入与返回
• 主要交互可执行
• 若依赖列表或详情数据，至少完成一次加载与刷新验证
• 若接入导航，验证入口页到新页面再返回的链路

输出要求

至少说明：

• 页面放在哪个功能目录
• 选择了哪种状态方案，为什么
• 是否复用了已有 repository 或新增了数据边界
• 跑了哪些验证

收尾步骤

新增页面完成后，author 不应直接宣布完成。 必须先使用新的 reviewer subagent 审查页面边界、状态方案和验证覆盖，再对外汇报结果。