Agent Skills
返回列表
研发编号规则约束

研发编号规则约束

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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 类型缩写与文件命名和版本递增一致