研发编号规则约束
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_84d07600/id-convention。
技能介绍
问题从哪来
多人协作里,需求、任务、缺陷和文档如果各用一套简称或临时编号,沟通里会出现「那个 001」「上次改过的 PRD」这类歧义;追踪、归档和 Git 分支/提交也很难和工单一一对应。编号本质是团队的通用语言,需要分段、可解析、全项目一致的规则,而不是事后补文档。
技能如何约束编号
本规则定义统一骨架:项目标识(2~4 位大写字母)+ 对象类型 + 模块/分类(2 位数字)+ 序号(3 位起)+ 可选版本/后缀;段间用 -,WBS 层级用 .,字母大写、无空格。
核心对象类型包括 REQ(需求)、TSK(任务)、BUG、VER(版本)、DOC(文档)、ADR、API、ENV、CFG 等,并给出各类型示例与衍生规则,例如:
- 需求变更:原编号不变,末尾追加
-V[版本号];优先级用 S/A/B/C 标签,不写进编号 - 需求驱动任务:
UMS-REQ-01-001.T1;非需求驱动任务:UMS-TSK-06-001 - 版本:语义化
V主.次.修,阶段后缀-alpha.N/-beta.N/-rc.N,内部构建号+build.N由 CI 生成 - 文档:类型缩写(PRD、SRS、TSD 等)与文件名
[编号]_[简称].md的对应关系 - Git:
feature/、bugfix/等前缀,分支名含任务编号;提交类型feat/fix/docs等,描述含编号、≤50 字
管理原则强调 不回收、不跳号补号、废弃只改状态、规则变更下一迭代生效且不回溯已有编号。
适用边界
模块编号(如 01 用户、02 订单)需在项目启动时自行定义并全局唯一;技能不提供具体项目的模块表,只给常见映射示例。严重等级、Bug 来源、需求优先级等用标签表达,不嵌入编号字符串。
使用场景
- 新项目启动时需要定义 UMS/PAY 等项目标识,并为各业务模块分配 01~99 的两位模块号
- 从 UMS-REQ-01-001 拆解开发任务,任务编号需写成 UMS-REQ-01-001.T1 并与 Git 分支 feature/…-001-… 对齐
- 需求评审通过后正式变更,要在原编号 UMS-REQ-01-001 末尾递增 -V2 而不是另起新号
- 编写 PRD/SRS 时按 UMS-DOC-PRD-001-V1.0-日期 命名文件,并同步更新文档次版本或修订号
适合人员
- 负责多模块产品 backlog 的产品经理,需要给每条需求稳定编号并区分 -V 版本与 S/A/B/C 优先级标签
- 带 5~15 人研发小组的技术负责人,要在迭代里统一 REQ/TSK/BUG 编号并写进分支与 commit
- 维护发布流水线的 DevOps,需要 VER 语义化版本、alpha/beta/rc 后缀与 CI 生成的 +build 号规则
- 写 ADR、接口文档与部署方案的技术写作者,需要 DOC/ADR 类型缩写与文件命名和版本递增一致