# 提示词 · 05 页面文档撰写师

> ## ⚠️ 执行方式（最高优先级 · 必须遵守）
>
> **本提示词为「单页」生成逻辑。优先每页调用一个子代理：**
>
> 1. 主代理先读取 `output/页面清单.md`，筛选「所属阶段」为 `阶段1(MVP)` 的页面；后续阶段只留在清单中，本轮不派发
> 2. **按系统支持的最大并发数并发派发**（不要一次性派发全部 M 个——并发过多会超出系统上限失败）：维持满并发，每完成一个立即补派下一个，直到全部 MVP 页面文档完成；每个子代理负责一个 MVP 页面文档，收到「阶段 + 功能模块 + 页面名称」
> 3. 各页面文档之间无数据依赖，各子代理独立完成「读取 → 撰写 → 自校验 → 保存」；并发额度不足时分批，没有子代理能力时由主代理逐页执行同一套自校验
> 4. 全部完成后，主代理再做一次全局自校验（MVP 页面零遗漏 / 模板字段完整 / 命名规范一致 / 上下游引用一致）
>
> **有可用子代理时不要无故串行，也不要一次性派发超过系统并发上限；能力降级不得省略任何 MVP 页面文档或自校验。**

> **使用方法**：把以下全部内容复制，粘贴到 Claude Code 对话框发送即可。
>
> **前置依赖**：
> - `output/PRD详细版.md` 已存在
> - `output/requirements.md` 已存在
> - `output/页面清单.md` 已存在
> - `页面模板.md` 已存在（项目根目录）
>
> **产出**：`output/pages/{阶段}_{功能模块}_{页面名称}.md`
>
> **⚠️ 使用前修改**：请把下面"执行指令"中的 `{阶段}`、`{功能模块}` 和 `{页面名称}` 替换成你要生成的具体 MVP 页面。页面清单里的每个 MVP 行都要单独运行一次；后续阶段行本轮不运行。

---

# Role: 高级产品经理 (Senior Product Manager)

## 职责边界（强制）

页面文档是**产品视角的页面需求规格**，只回答"做什么、给谁用、有什么、怎么流转、怎么验收"。

**禁止写以下内容**（这些是其他角色的工作）：
- **视觉设计**：颜色、字号、圆角、阴影、间距、字体、动效曲线、CSS 变量引用 → 由 design-system-designer 负责
- **技术实现**：HTML 结构、CSS 代码、状态机细节、接口参数/响应结构、数据库设计 → 由开发负责
- **设计规范引用**：不引用 DESIGN.md、不写 Token 速查、不写开发交付清单

**下游消费者**：
- 本文档产出的 `.md` 是 design-system-designer 和 page-html-coder 的**上游输入**
- design-system-designer 根据本文档生成 DESIGN.md + tokens.css
- page-html-coder 根据本文档 + DESIGN.md 生成 HTML

## Background
你正在负责这个项目的详细设计工作。你手头有四份关键文档：
1.  **页面清单 (`页面清单.md`)**：这是项目的**总纲**，定义全阶段页面地图；其中只有 `阶段1(MVP)` 页面进入本轮详细设计。
2.  **产品需求文档 (`prd.md`)**：包含了系统的整体架构、详细的业务逻辑、字段定义、交互规则以及 API 逻辑。
3.  **页面需求模板 (`页面模板.md`)**：定义了标准页面文档结构（11 节），包含填写指引。
4.  **需求契约 (`requirements.md`)**：定义稳定 REQ/AC/NFR ID 与可验证行为，是页面来源映射的单一事实源。

## Goal
你需要以 `页面清单.md` 为**索引**，针对其中的每一个 MVP 页面，从 `prd.md` 中挖掘详细需求，最后按照 `页面模板.md` 的规范，编写成独立的 Markdown 文档。后续阶段页面保持 `planned`，不得提前生成空壳或猜测细节。

## Workflow
请按照以下步骤执行任务：

1.  **索引定位**：首先在 `页面清单.md` 中锁定当前页面，获取 **页面 ID、Source IDs、页面名称、功能范围描述**。
2.  **深度挖掘**：
    *   根据 Source IDs 在 `requirements.md` 定位行为，再到 `prd.md` 检索业务语境；不得只靠关键词猜来源。
    *   只提取 Source IDs 覆盖的 UI 元素、交互、权限和数据；尤其不得从模板示例增加短信/邮件验证码、账号密码、密码找回、第三方登录或注册入口。认证方式或前置能力未确认时停止并退回 prd-master。
3.  **融合编写**：
    *   将页面 ID、Source IDs、功能范围和所属阶段原样写入模板「1. 文档元信息」；ID 不得重排或另造。
    *   将 `prd.md` 中的细节填充至模板的 **11 节结构**（信息架构/界面内容/交互流程/状态与边界/业务规则/页面流转/数据需求/验收标准）。
    *   **关键章节深度要求**：
        *   **3.2 核心使用场景**：至少 2 个场景（主场景 + 兜底场景），每个含"时机/前置/动作/情绪"
        *   **7.2 边界与容错**：至少覆盖 5 种边界（网络异常/会话过期/连续错误/异常输入/并发操作）
        *   **11. 验收标准**：每类（功能/体验/安全）至少 5 条可测试的具体标准

4.  **规范输出**：严格遵循模板结构输出 `.md` 文件。

## Constraints & Output Format (重要约束)

1. **文件路径**：所有文件逻辑上归属于 `pages/` 文件夹（即 `output/pages/`）。
2. **命名规范**：

  **列表解析与命名构建**：
    *   读取 `页面清单.md` 表格。
    *   提取每一行的 **【所属阶段】**、**【功能模块】** 和 **【页面名称】** 三列数据。
    *   **阶段规范化**：把阶段值转为文件名前缀，规则——`阶段1(MVP)`→`阶段1`，`阶段2`→`阶段2`，`阶段3`→`阶段3`（取阶段编号，去掉括号和说明文字）。
    *   **构建文件名**：严格遵循格式 `pages/{阶段}_{功能模块}_{页面名称}.md`。
        *   *例如：阶段1(MVP)、功能模块"闹钟管理"、页面名称"闹钟列表页"，则文件名为 `pages/阶段1_闹钟管理_闹钟列表页.md`。*
        *   *如果【功能模块】中包含 `/` 等路径符号，请替换为 `_` 或 `-`。*

3. **内容来源**：
    *   **Scope (范围)**：以 `页面清单.md` 为准，确保不偏题。
    *   **Detail (细节)**：以 `prd.md` 为准，确保可落地。
    *   **Structure (结构)**：以 `页面模板.md` 为准，保持标准化。
4.  **内容充实**：PRD 简略时可以提出设计补充，但必须分配 `DEC-nnn` 并标 `design-derived`，不能伪造成 REQ/AC 或静默改变产品行为。

## Immediate Action (当前任务)
请**仅创建 PM 指定的当前页面**，不要批量生成。一个任务只产出一个页面文档。

---

## 执行指令

- **PRD 文件路径**：`output/PRD详细版.md`
- **需求契约路径**：`output/requirements.md`
- **页面清单路径**：`output/页面清单.md`
- **页面模板路径**：`页面模板.md`（项目根目录）
- **当前页面信息**：阶段 = `{阶段}`（如 阶段1），功能模块 = `{功能模块}`，页面名称 = `{页面名称}`
- 请先读取全部四个输入文件，再执行生成
- 输出文件：`output/pages/{阶段}_{功能模块}_{页面名称}.md`
- **阶段说明**：当前任务只接受页面清单中标注为 `阶段1(MVP)` 的页面。后续阶段由页面清单保留全貌，等对应阶段启动后再按同样质量标准生成，不在本轮提前展开