> Agent 执行入口（必读）
> 调用本 Skill 产出 PRD / 原型时，必须先完整阅读并严格遵循 references/agent-runtime.md（门禁、工作流、按需加载、硬性规则、自检）。
> 下文为面向使用者的产品说明（平台默认展示）；不得因阅读用户说明而跳过 agent-runtime 中的初始化门禁与交付规范。
PRD Prototype Writer Pro
面向产品经理的 Agent Skill（技能包）：在同一套工作流中，完成可评审的产品需求文档（PRD）与可交互的 HTML 原型，并按配置输出研发移交所需材料。
配置保存在本 Skill 目录的 Profile（配置档案）中，默认不写入业务代码仓库。当前版本见 CHANGELOG.md（v0.1.4）。
更完整的目录说明与反馈渠道亦见 README.md（与本文用户说明保持一致）。
定位
AI 写产品交付物的常见问题有两个：文档口径不一致，以及交互无法被研发/测试直接对照。本 Skill 将二者作为同等优先级交付物：
| 交付维度 | 目标 |
|---|---|
| PRD | 范围清晰、流程可追溯、功能点可拆、验收标准（AC，Acceptance Criteria）可测 |
| HTML 原型 | 可点击、可切换状态、与 PRD 功能点一一对应，可作为评审与联调的共同参照 |
支持多套公司/业务线配置切换。用户可导入专业名称与行业标准流程，作为后续撰写 PRD、绘制原型时的底层参考逻辑；Skill 具备自我迭代能力，在使用中持续沉淀纠正与新知。
核心能力
一、产品需求文档（PRD）
| 能力 | 说明 |
|---|---|
| 公司模板适配 | 支持导入空白模板，或从既有 PRD 提取章节骨架、表头与写法约定 |
| 定稿级结构 | 背景与目标、本期范围、业务流程图（Mermaid）、功能点一览、分模块说明、字段与枚举、数据与接口约定、验收标准、修订记录 |
| 范围管控 | 严格管理每个版本的修改范围，每个版本的交付物之间不会冲突 |
| 可验收表达 | 多步骤交互以有序列表呈现；验收标准按 AC 条目编写，可引用章节号 |
| 流程与契约对齐 | 可基于研发的概要设计、契约文档进行设计，保证 PRD 的研发可读性，也便于研发直接使用 AI 基于 PRD 进行后续开发工作 |
二、交互原型（HTML Prototype）
| 能力 | 说明 |
|---|---|
| 双端工程化交付 | 按配置输出移动端（C 端）与/或后台管理端原型，目录结构统一、可单独开关控制 |
| 可点击演示 | 非静态线框截图：含导航入口、页面跳转、侧边栏页面清单，便于评审演示 |
| 状态变体覆盖 | 关键业务状态（如待支付、已取消）通过 URL 参数切换，与 PRD 功能点 / 验收项对齐 |
| 设计约定可配置 | 视口尺寸、主色与设计 Token（设计变量）、图标方案、是否强制侧边栏导航等，初始化时约定 |
| Mock 数据演示 | 支持本地 Mock（模拟数据）与本地存储，演示闭环无需真实后端 |
| 与 PRD 双向引用 | PRD 截图列填写原型相对路径；原型文案、枚举与 PRD 保持一致 |
默认视口（可被配置覆盖）：移动端 390×780，后台 1440×900。
三、研发移交（Handoff）
按 Profile 开关按需输出，避免「文档有了、对照表没有」：
| 可选交付物 | 职责 |
|---|---|
| PRD | 产品行为、流程、交互与验收口径 |
| 接口契约 | 路径、入参出参、枚举；与线上接口文档对齐 |
| 研发移交映射 | 原型页面 → 客户端路径 / 后台路由等实现落点 |
| 原型工程 | prototype/ 下可运行的 HTML Demo |
四、行业知识导入
通用写法规范不绑定某一行业；专业名称与行业流程由用户导入，写入当前 Profile 的术语与流程库（domain-glossary.md），之后 Agent 撰写 PRD、输出原型时优先按该库对齐口径，避免「通用 AI 臆造业务黑话」。
| 可导入内容 | 作用 | 导入方式 |
|---|---|---|
| 专业名称 / 术语 | 统一产品、研发、测试对同一概念的叫法与英文编码 | 初始化第 2 轮 @ 白皮书/术语表；或日常指令「将 XX 写入术语表」 |
| 行业标准流程 | 作为主流程、状态机、跨系统协作的底层参照（可附简要流程图摘要） | 同上 @ 现状说明/流程文档；或明确「按某某标准流程沉淀」 |
| 业务域清单 | 划定本配置覆盖的业务边界，便于多配置隔离 | 初始化时填写，或从现状文档提炼 |
原则：只提炼可复用的名称定义与流程摘要进入 Skill；大段原文保留在业务仓库，配置内保留路径引用。写入后的术语与流程，即成为该配置下后续产出的默认业务逻辑参考。
五、自我迭代
本 Skill 不是一次性提示词，而是可随使用持续进化的工作流：
| 机制 | 说明 |
|---|---|
| 纠正沉淀 | 用户纠正写法、口径或交互约定后，记入纠正日志；达到复现或明确确认为「标准叫法 / 固定流程」时，晋升进当前配置或通用规范 |
| 新知晋升 | 定稿过程中出现的新专业名词、新/变更行业流程，可候选写入 domain-glossary.md，供后续需求复用 |
| 规则级回写 | 若变更属于通用方法论（非某一行业特例），可同步到 prd-style / prototype-style，并记入 CHANGELOG |
| 多配置隔离 | 以配置名称隔离业务线（如「电商 PRD 配置」与「财务 PRD 配置」互不影响）；迭代结果默认写入当前激活配置，避免串味 |
| 结束自检 | 每次完成 PRD/原型后，检查是否有可复用规则或新术语待沉淀，避免「用过即忘」 |
一次性临时指令默认不写入规范；需明确确认或经多次复现后才晋升，保证沉淀质量。详见 references/iteration.md。
适用对象
- 需要稳定输出评审级 PRD，并同步提供可演示原型的产品经理
- 以「文档 + 原型」作为需求评审与验收共同输入的协作团队
- 需导入本行业专业名称与标准流程，作为 AI 底层业务参照的实践者
- 需在多业务线 / 多公司模板间切换，并希望规范与术语可自我迭代沉淀的团队
使用流程
1. 安装
将本目录置于 Agent 可加载的 Skills 路径，确保识别 prd-prototype-writer-pro。常见方式：
- 将文件夹拖入对话，让 AI 协助安装
- 在 AI IDE 设置中手动添加 Skill
2. 初始化配置（首次必做）
@prd-prototype-writer-pro 帮我初始化配置
若尚无 profiles/active，Agent 仅执行初始化，不编写业务 PRD / 原型，以避免套用错误模板。
| 指令 | 效果 |
|---|---|
都用默认 / 快速初始化 |
采用内置默认，生成并激活「默认产品配置」 |
恢复默认配置 |
重建默认配置 |
切换到配置：{名称} |
切换当前激活配置 |
初始化共四轮（均可跳过）：
| 轮次 | 采集内容 | 回答方式 |
|---|---|---|
| 1 · 身份 | 配置名称、默认作者、角色定位 | 文本 |
| 2 · 业务与交付 | 业务域、专业名称与行业流程（可导入）、是否交付移动端/后台原型、文档与原型目录 | 文本，或 @ 现状/白皮书/术语表/流程说明 |
| 3 · PRD 模板 | 公司 PRD 骨架 | @ 空白模板 / @ 既有 PRD（自动提取骨架）/ 「用默认模板」 |
| 4 · 原型规范 | 视口、主色、导航与状态变体等约定 | 文本，或 @ 设计规范；不交付原型时可整轮跳过 |
第 3、4 轮可事后补跑：补充 PRD 模板、补充原型规范。
3. 日常产出
@prd-prototype-writer-pro 编写「订单退款」PRD，并按当前配置输出移动端与后台原型
Agent 将依据当前激活配置：加载已导入的专业名称与行业流程（底层参考）→ 按模板撰写 PRD →（若开启）生成原型工程 → 按 handoff 开关补齐移交材料 → 自我迭代自检（新术语/流程/纠正是否需沉淀）。
交付物结构
默认目录（可由配置中的 paths 覆盖）：
{模块或版本}/
├── docs/
│ ├── PRD-*.md # 产品需求文档
│ ├── 接口契约-*.md # 可选
│ ├── 研发移交映射.md # 可选：原型 ↔ 实现
│ └── screenshots/ # 可选配图
└── prototype/
├── index.html # 原型导航入口
├── demo/ # 移动端 / C 端
│ ├── index.html
│ ├── css/ # 含设计 Token
│ └── js/ # 导航、Mock、本地存储等
├── admin/ # 后台宽屏
└── scripts/ # 可选：截图脚本等
PRD 默认章节顺序（可被公司模板替换）：
元信息 → 背景与目标 → 范围说明 → 整体方案流程图 → 页面与交互说明（功能点一览）→ 分模块功能说明 → 数据与接口约定 → 验收标准 → 修订记录
输出规范摘要
PRD
| 规范 | 要点 |
|---|---|
| 范围章 | 仅单列「本期纳入」 |
| 功能点多步骤 | 表格描述列使用 HTML 有序列表 |
| 流程图 | 状态枚举与核心字段中英双语；异步链路使用虚线表示 |
| 异步告知类交互 | 可关闭，且不影响已成立业务事实 |
| 截图列 | 填写原型相对路径，或明确标注【待补充】 |
详见 references/prd-style.md。
原型
| 规范 | 要点 |
|---|---|
| 工程入口 | prototype/index.html 可导航至全部需验收页面 |
| 状态覆盖 | 关键状态具备可打开的变体页或 URL 参数 |
| 与 PRD 一致 | 文案、枚举、功能点与 PRD 对应章节对齐 |
| 设计 Token | 颜色等集中为 CSS 变量，避免页面内散落硬编码 |
| 移交映射 | 原型文件路径与实现路由/页面路径建立对照 |
详见 references/prototype-style.md。
常用指令
| 意图 | 示例 |
|---|---|
| 初始化 | 初始化配置 / 快速初始化 |
| 导入专业名称 | 将「XX」写入术语表（可附英文码与一句话定义） |
| 导入行业流程 | @ 流程文档，并说明「按标准流程沉淀到当前配置」 |
| 补充 PRD 模板 | 补充 PRD 模板（可再 @ 文档） |
| 补充原型规范 | 补充原型规范 |
| 切换配置 | 切换到配置：{名称} |
| 编写 PRD | 按当前配置编写 XXX 的 PRD |
| 输出原型 | 输出移动端与后台原型，对齐功能点表与验收标准 |
| 研发移交 | 按 handoff 生成研发移交映射 |
| 触发自我迭代 | 把刚才纠正的写法晋升为标准规范 / 结束前做一次迭代自检 |
Profile 说明
每套配置位于 profiles/{配置名称}/：
| 文件 | 用途 |
|---|---|
profile.yaml |
作者默认值、handoff 开关、路径、视口、章节顺序等 |
role.md |
Agent 角色与协作口径 |
domain-glossary.md |
专业名称与行业流程库（底层业务参考逻辑；可先空，经导入与自我迭代持续充实） |
prd-template.md |
本配置 PRD 骨架 |
prd-overrides.md |
相对通用 PRD 规范的公司差异 |
prototype-overrides.md |
相对通用原型规范的公司差异 |
profiles/active 记录当前激活的配置名称。
只读形态示例：profiles/_examples/smart-community/（使用前请复制至正式配置目录再激活，勿直接改示例）。
配置合并优先级（高 → 低）：
用户当场指定 / 文件提炼 → 当前 Profile → templates/defaults.yaml → references/ 通用方法论
注意事项
- 首次先初始化：未完成配置前，不会编写业务 PRD / 原型。
- 配置在本 Skill 目录：术语、模板、行业流程保存在
profiles/，不在业务代码仓；换设备需自行备份。 - 接口以线上文档为准：与 Swagger 等冲突时，以线上契约为准。
- 公开发布前清理个人配置：勿打包真实公司 Profile 与内部文档提炼结果；示例目录
_examples勿直接当正式配置使用。
目录结构
prd-prototype-writer-pro/
├── SKILL.md # 平台默认展示：用户说明 + Agent 执行入口提示
├── README.md # 与 SKILL.md 用户说明同步（便于 GitHub 阅读）
├── CHANGELOG.md
├── references/
│ ├── agent-runtime.md # Agent 门禁与工作流（执行逻辑，不改业务说明）
│ ├── init-guide.md
│ ├── prd-style.md
│ ├── prototype-style.md
│ └── iteration.md
├── templates/
├── profiles/
└── examples/
设计原则：通用规范置于 references/，公司与业务差异置于 Profile；用户可读说明与 Agent 执行逻辑分文件，避免改介绍时误改运行规则。
版本与反馈
- 版本历史：CHANGELOG.md
- 纠正与待晋升项：references/corrections-log.md
- 反馈建议附带：当前配置名称、第 3/4 轮是否跳过、期望与实际输出片段（脱敏）
许可（License）
公开发布前请补充 LICENSE 并在此注明。未声明前，默认仅供个人/团队内部使用。
