产品设计统一文档命名规范和文件命名格式规范

产品设计统一文档命名规范与文件命名格式规范一、引言在产品设计全流程中，文档与文件的高效管理是保障团队协作顺畅、知识沉淀有序、版本追溯清晰的核心基础。为避免因命名混乱导致的查找困难、版本混淆、信息孤岛等问题，特制定本统一命名规范，旨在通过标准化命名规则，提升跨角色（产品、设计、开发、测试）协作效率，保证项目文档的可维护性与扩展性。二、适用场景与核心价值适用场景：本规范适用于产品设计全生命周期中产生的各类文档与文件，包括但不限于：需求文档（PRD）、用户故事、原型文件（Axure/Sketch/Figma）、设计稿（UI/UX）、设计规范、用户测试报告、需求变更记录、项目总结文档等。核心价值：高效检索：通过结构化命名快速定位目标文档，减少沟通成本；版本管理：明确版本标识，避免使用“最新版”“最终版”等模糊表述；责任追溯：记录负责人与日期，便于问题溯源与协作分工；规范统一：保证团队内命名逻辑一致，降低新人上手门槛。三、核心命名规则（一）文档命名规范文档命名采用“[项目/产品标识]-[文档类型代码]-[版本号]-[日期]-[负责人]”的组合结构，各要素间用短横线“-”连接，总长度不超过50字符（避免系统兼容性问题）。要素说明示例项目/产品标识统一使用项目简称或产品核心名称（全小写，无特殊字符）user-center（用户中心）文档类型代码见《文档类型代码表》（下表），采用2-3位大写字母缩写PRD（需求文档）版本号采用“主版本号.次版本号.修订号”格式（如V1.0.0），初始版本为V1.0.0V1.0.0日期文档创建/最后修订日期，格式为YYYYMMDD20231025负责人负责人姓名拼音首字母（可后缀数字区分重名，如zhang*01）zhang01（张）文档类型代码表：文档类型代码说明需求文档PRDProductRequirementDocument用户故事USUserStory交互原型PROPrototypeUI设计稿UIUserInterfaceDesignUX设计规范UXUserExperienceGuideline用户测试报告UTRUserTestReport需求变更记录CCRChangeControlRecord项目总结文档PSProjectSummary（二）文件命名规范文件命名在文档命名基础上，增加“[文件具体名称/模块]-[文件格式后缀]”，若文件为设计稿或原型，可补充“[页面/功能关键词]”以细化内容。命名结构：[项目/产品标识]-[文档类型代码]-[版本号]-[日期]-[负责人]-[文件具体名称/模块].[文件格式后缀]示例：需求文档附件：user-center-PRD-V1.0.0-20231025-zhang*01-登录流程.pdfUI设计稿：user-center-UI-V1.0.0-20231025-li*02-登录页.sketch交互原型：user-center-PRO-V1.0.0-20231025-wang*03-用户注册.axure四、规范落地操作流程步骤1：明确项目/产品标识项目启动时，由项目经理统一确定项目简称（如“订单管理”简化为“order-mgt”），并在团队文档中同步公示，避免后续使用不一致的标识。步骤2：选择文档类型代码根据文件内容查阅《文档类型代码表》，准确匹配代码（如“需求变更记录”对应“CCR”），禁止使用自定义代码或模糊缩写。步骤3：设定版本号规则初始版本：首次定稿文档版本号为V1.0.0；次版本更新：内容功能增减（如新增模块、调整流程）时，次版本号递增（如V1.1.0）；修订版本更新：仅修字错误、排版优化等小范围调整时，修订号递增（如V1.0.1）。步骤4：填写日期与负责人信息日期以文档最终定稿日期为准，非创建日期；负责人填写直接责任人姓名拼音首字母（如“陈”为“chen”，重名时可加后缀，如“chen*01”）。步骤5：组合命名并校验按结构顺序组合各要素，检查总长度是否超过50字符，避免使用空格、中文、特殊字符（如!、#、$）；通过团队共享的命名校验工具（如正则表达式校验）或人工复核，保证格式无误后再至文档管理系统（如Confluence、语雀、共享文件夹）。五、命名规范模板示例（一）常见文档命名模板文档类型模板结构完整示例需求文档（PRD）[项目标识]-PRD-[版本号]-[日期]-[负责人]order-mgt-PRD-V1.2.0-20231030-zhang*01交互原型（PRO）[项目标识]-PRO-[版本号]-[日期]-[负责人]order-mgt-PRO-V1.0.0-20231028-li*02UI设计稿（UI）[项目标识]-UI-[版本号]-[日期]-[负责人]order-mgt-UI-V1.1.0-20231029-wang*03用户测试报告（UTR）[项目标识]-UTR-[版本号]-[日期]-[负责人]order-mgt-UTR-V1.0.0-20231031-zhao*01（二）文件命名模板（以设计稿为例）文件内容模板结构完整示例首页设计稿[项目标识]-UI-[版本号]-[日期]-[负责人]-首页.[格式]order-mgt-UI-V1.1.0-20231029-wang*03-home.png订单列表页[项目标识]-UI-[版本号]-[日期]-[负责人]-订单列表.[格式]order-mgt-UI-V1.1.0-20231029-wang*03-order-list.sketch六、执行要点与风险规避（一）强制执行要求新文档优先：所有新增文档与文件必须按规范命名，旧文档可在1个月内逐步迁移，迁移后需在文档管理系统备注原名称；版本同步：文档版本更新时，需同步更新文件命名中的版本号，并保留历史版本（建议通过文件夹版本管理，如“V1.0.0”“V1.1.0”）。（二）常见错误与规避错误类型错误示例正确做法项目标识不统一user-center/UserCenter/UC统一使用小写短横线组合（user-center）版本号格式混乱v1.0/1.0.0/最新版严格按“主版本.次版本.修订号”格式（V1.0.0）要素缺失或顺序错误user-center-PRD-20231025-zhang*01补充版本号（user-center-PRD-V1.0.0-20231025-zhang*01）特殊字符使用user-center/PRD_V1.0.0.docx用短横线“-”替代特殊字符（user-center-PRD-V1.0.0.docx）（三）培训与监督新成员入职时，由产品负责人组织规范培训，并通过考核后方可使用文档管理系统；每月由项目组抽查文档命名情况，对不符合规范的文档要求责任人整改，并同步更新