产品白皮书技能
本技能根据公司标准模板编写产品白皮书，支持0-1首次编写和1-10迭代更新两种模式。
触发词
- "写产品白皮书"
- "生成产品白皮书"
- "产品白皮书"
- "编写产品白皮书"
依赖检查与安装
在执行任何工作前，检查以下skill是否已安装（位于 ~/.workbuddy/skills/ 目录）：
- 雷达-政策 - 扫描教育部及省厅政策动态
- 雷达-行业趋势 - 扫描高校信息化行业趋势报告
- 雷达-竞品 - 扫描竞品动态和产品特点
- 雷达-招投标 - 扫描相关招投标参数变化
检查方法：尝试使用 Skill tool 调用这些skill，如果返回错误（skill not found），则需要安装。
安装方法：
1. 从当前skill的 dependencies/ 目录，将对应的skill文件夹复制到 ~/.workbuddy/skills/
2. 使用 Bash tool 执行复制命令（示例）：
- cp -r "C:/Users/Administrator/.workbuddy/skills/产品白皮书/dependencies/雷达-政策" "C:/Users/Administrator/.workbuddy/skills/"
- cp -r "C:/Users/Administrator/.workbuddy/skills/产品白皮书/dependencies/雷达-行业趋势" "C:/Users/Administrator/.workbuddy/skills/"
- cp -r "C:/Users/Administrator/.workbuddy/skills/产品白皮书/dependencies/雷达-竞品" "C:/Users/Administrator/.workbuddy/skills/"
- cp -r "C:/Users/Administrator/.workbuddy/skills/产品白皮书/dependencies/雷达-招投标" "C:/Users/Administrator/.workbuddy/skills/"
3. 复制完成后，再次尝试调用以确认安装成功。
注意：如果 dependencies/ 目录中缺少某个skill，提示用户手动创建或安装该skill。
工作流程
整体原则：最小交互，一次生成。用户只需说一句话触发（如"帮我生成阳光跑V1.0.0的产品白皮书"），你只问必要问题，然后一次性生成全部内容。
Step 0: 解析用户指令
从用户一句话中提取已知信息：
- 产品名称（从"xxx产品"中提取）
- 产品版本号（如V1.0.0、V2.1.7）
- 如果用户未明确版本号，需询问确认
Step 1: 询问两个必要问题
问题一：该产品之前是否有过白皮书？
- 有 → 请用户提供上一版白皮书文件或路径，标记为"迭代版本（1-10）"
- 没有 → 标记为"第一版（0-1）"，更改记录备注填"创建"
问题二：请提供产品需求文档地址
- 用户会提供一个Axure网页链接（含原型设计+需求说明），你直接打开链接，逐页仔细查看、确认产品设计和功能
- 如链接无法访问，请用户提供替代方式（本地HTML导出路径等）
Step 2: 询问辅助材料（可选）
询问用户当前产品是否有以下辅助材料：
- 功能清单（Excel/文档）
- 用户使用手册
- 管理员操作手册
如有，请用户提供；如无，跳过此步，仅基于Axure原型编写。
Step 3: 收集基础信息
从用户指令或简短询问中确认：
- 产品名称：用于封面和页眉
- 产品版本：用于封面和更改记录
- 作者姓名：用于更改记录"作者"字段
- （迭代版）上一版本白皮书，用于对比生成变更备注
Step 4: 深入阅读需求文档
必须完整、仔细阅读产品需求文档：
- 使用浏览器打开Axure原型链接
- 先记录完整的站点地图（Sitemap）结构，提取所有页面名称和层级关系，这是后续写功能介绍的目录依据
- 逐页查看所有页面，不遗漏任何功能模块
- 重点关注：
- 产品说明/产品概述页面
- 所有功能模块页面（H5端、管理端、移动端等）
- 菜单层级结构（哪些是顶级模块、哪些是子功能）
- 业务流程图
- 交互规则说明
- 权限与角色设计
- 数据字段与校验规则 - 如有功能清单Excel，逐条阅读所有sheet
- 如有用户手册/管理员手册，仔细阅读操作流程
输出：在脑海中形成对产品的完整理解，并确认已准确掌握全部菜单层级结构。
Step 5: 生成目录大纲并确认
基于模板结构，结合产品实际情况生成目录。目录结构必须严格对齐模板：
一、行业背景（可根据产品调整子目录）
二、产品简介（按模板固定格式，含整体业务流程）
三、技术架构
3.1 技术路线（至少10点）
3.2 安全要求（至少5点）
3.3 技术特性（至少10点）
3.4 技术优势（至少10点）
四、产品特点（至少5点，标题5-10字）
五、产品价值（从不同角色视角提炼价值）
六、功能介绍（按产品端/模块展开，子目录严格对应原型菜单结构，自上而下、由左及右，最多5级）
七、运行环境
功能介绍目录规则：
- 先用户端、后管理端
- 子目录与Axure原型中的菜单结构逐级对应，不编造、不遗漏、不调序
- 大模块标题下需要一段整体概述段落
- 总览内容需概括性描述，不要逐条罗列功能点名称
展示目录大纲给用户确认，如有调整立即修改。只确认一次。
Step 6: 一次性生成全部内容
目录确认后，直接生成全部章节内容，一次性输出给用户。不再逐模块确认。
通用写作规范：
- 概括优先、避免罗列：用自然段落概括功能和能力，不要逐字段、逐菜单罗列
- 不编造功能：严格遵守原型中的菜单结构和功能范围，不写原型中不存在的功能
- 用语专业简练：避免口语化、口水话（如"不再因""将…转变为""容易产生争议""让管理从…走向…"等），删除"对xxx而言"等开篇套话
- 不确定处标注：技术细节不确定时标注"由技术负责人确认"，不要凭空编造
- 配图标注：所有需要配图的位置标注【配图：xxx具体描述】，由使用者后续人工添加
- 减少括号：尽量用"如：xxx、xxx"代替括号内补充说明
- 全文禁止提及具体第三方产品名称（如泛微），统一用通用描述（如"系统流程引擎"）
各模块编写规则：
二、产品简介：
- 整合为自然段落，不要分"产品性质""产品定义""适用场景"等分点
- 不要使用"产品名 = xxx + xxx"公式行
- 必须包含"整体业务流程"子章节，描述各环节的作用，侧重点为客观中性的操作流程描述（谁→做什么→产出什么）
- 业务流程描述面向非技术读者，避免技术术语堆砌
- 产品简介中的业务流程与产品特点、产品价值需做区分：简介讲"怎么运作"，特点讲"有什么能力"，价值讲"解决什么效益"
三、技术架构：
- 主体采用分层架构描述（基础设施层、AI/业务服务层、业务应用层、终端接入层等），按实际情况调整
- 各层描述为流畅自然段落，融合功能定位、核心组件、技术选型、关键能力、业务价值五个维度
- 子目录按模板固定顺序：3.1技术路线 → 3.2安全要求 → 3.3技术特性 → 3.4技术优势
- 3.1技术路线使用"1、"格式编号，至少10点
- 3.2安全要求使用"1、名称：描述。"格式，至少5点
- 3.3技术特性使用"1、特性名称：描述。"格式，至少10点
- 3.4技术优势使用"1、★ 优势名称：描述。"格式，至少10点
- 部署方式需向用户确认（私有化部署 vs SaaS），不要擅自写多租户、灰度发布等不适用场景
四、产品特点：
- 至少5点，每个特点标题严格控制在5-10字
- 只正面描述自身优势，不拉踩竞品，不做"与其他产品相比…"类对比
- 内容精炼、不堆砌技术细节
- 覆盖"人无我有、人有我优、人优我特"三个维度
五、产品价值：
- 与产品特点严格区分：特点是能力描述，价值是从不同角色视角讲效益
- 面向不同角色（师生、管理员、领导层、信息化部门）分别提炼价值
- 不要用"对xxx而言"开头，直接切入内容
- 删除口水话和空洞的总结句
六、功能介绍：
- 大模块标题下需要一段整体概述段落（如"6.2 H5用户端"下先写一段概述，再逐功能点展开）
- 每个功能点写成一个流畅的自然段落，不分点不分类
- 内容融合：该功能能做什么 + 使用场景 + 核心价值，不要机械套用"功能定位/应用场景/功能说明/业务价值"四点分列
- 总览部分概括性描述，不要罗列所有功能点名称
- 子目录严格对应原型菜单结构
Step 7: 用户反馈调整
全部内容输出后，询问用户"哪里需要调整？"。支持两种调整模式：
- 模块迭代模式：用户逐模块提出修改意见，你仅修改并展示该模块内容，最后统一整合
- 全文调整模式：用户一次性给出全部修改意见
根据反馈修改至用户满意。
同时告知用户模板填写信息：
- 封面：产品名称、产品版本
- 更改记录：新增行标红（日期=当天、版本=当前、作者=姓名、备注=创建/变更摘要）
- 页眉右侧：产品名称+版本+产品白皮书
- 页码：从目录页之后开始
注意事项
- 写作风格：参考已有白皮书（
D:/02 Do/【产品】一平三端/一平台三端V2.1.7产品白皮书.docx）的写作风格和用语习惯 - 图文标注：所有需要配图的位置必须标注"【配图：...】"，由使用者后续人工添加；不要在正文中使用【】做额外标注
- 技术架构：如无法获取技术信息，基于行业调研编写草稿并标注待确认，不要留空
- 迭代版本：必须获取上一版本白皮书，对比生成变更备注
- 先查后写：功能介绍的子目录必须来自原型实际菜单结构，不要凭记忆或推测
- 区分模块边界：产品简介（怎么运作）≠ 产品特点（有什么能力）≠ 产品价值（解决什么效益），三段内容不可互相重复
- 私有化部署：涉及部署方式时需向用户确认，不要擅自假定多租户、灰度发布等云服务特性
- 通知功能：如产品涉及消息通知，需在产品特点和产品价值中纳入描述，具体规则从原型中查阅
参考资料
- 公司白皮书模板：
D:/02 Do/文档模板/产品白皮书模板20260608.docx - 参考白皮书：
D:/02 Do/【产品】一平三端/一平台三端V2.1.7产品白皮书.docx - 雷达技能：雷达-政策、雷达-行业趋势、雷达-竞品、雷达-招投标
