PRD 智能版本化助手

团队在协同编写需求文档时的版本管理痛点

当产品经理使用 Markdown 编写 PRD 或功能设计文档时，常常面临一个具体问题：文档内容的演进与版本交付之间存在断层。团队依赖 Git 等通用版本控制工具管理源文件的变更历史，但在需要向开发、测试或评审方交付一个“定稿”的、带明确版本号（如 v0.2）的快照时，流程变得手动且易出错。你可能需要手动复制文件、重命名并添加版本号，然后确保所有相关方都引用正确的版本。这种操作繁琐，容易导致版本混淆或文件丢失。

Skill 的核心能力与工作流程

本 Skill 提供了一套结构化的解决方案，其核心是 gen_template.js 和 gen_from_md.js 两个脚本，它们围绕“源 Markdown 文档”与“版本化快照”这两个核心实体构建工作流。

1. 模板驱动初始化：通过 gen_template.js，你可以基于内置的通用模板（如 references/通用需求文档模板.md）快速生成一个新文档的初始 Markdown 源文件。这确保了文档结构（如十二章标准）的统一性，你可以选择使用 profile 文件来复用项目公共字段。
2. 单文档/批量生成快照：核心工作发生在 gen_from_md.js 脚本上。你可以指向一个或多个无版本号的源 Markdown 文件。脚本会读取文档信息中的版本号，生成一个如 {文件名}_v0.1.md 的快照文件，并自动将输出目录中旧的同名快照归档至 backup/ 目录，实现清晰的版本迭代。
3. 配置化与复用：通过 profile（公共参数集） 和 manifest（批量任务清单） 文件，你可以将输出目录、归档目录、项目通用信息等抽象出来。对于需要为多个模块批量生成文档的场景（--manifest 模式），可以显著减少重复配置。
4. 安全与规范集成：在生成文档时，对于涉及身份鉴别、访问控制等敏感功能点，可以统一引用 references/通用等保三级安全要求.md 中的合规基线，并在文档的 7.1 章节补充模块特有要求。这避免了将安全规则硬编码到每份文档中。

适用边界与重要注意事项

本 Skill 是一个通用的文档工程化工具，旨在解决标准化结构文档的版本化交付问题，其适用有明确边界：

• 目标明确：它专为 需求文档、PRD、功能设计文档 等结构化 Markdown 文档设计。对于会议纪要、营销文案等非结构化文档，强行套用其模板和流程是不合适的。
• 项目中立：Skill 本身不包含任何特定业务逻辑。所有项目专属的章节内容、角色命名、业务规则（如具体的删除功能是否提供批量操作）都需要写入你自己的源文档或项目级 profile 中。
• 流程建议：它推荐并辅助一种“先有内容，后出版本”的协同模式。源文件是唯一的内容真相，快照是面向交付的定格版本。请勿在快照文件上直接修改内容。
• 注意点：生成前请确认源文档中的版本号与修订记录一致。对于数据导出功能的文件名，建议遵循 {业务前缀}_{YYYYMMDD}_{HHMMSS}.xlsx 的命名规范，以保持项目内一致性。