用途:确保所有变更类型(feature、fix、workflow)共享唯一的编号,避免多个代理并发工作、或远程分支存在未合并工作时出现重复编号。
主要能力:检查本地 docs/features/、docs/issues/、docs/workflow/ 目录中的最高编号;检查 GitHub 远程分支(feature/NNN-、fix/NNN-、workflow/NNN-*)中的最高编号;计算下一个可用编号(最大值+1);创建分支后立即推送以预留编号;编号格式为 3 位前导零(如 033、034、035)。底层由 scripts/next-issue-number.sh 脚本完成全部查询。
使用方式:先运行 NEXT_NUMBER=$(scripts/next-issue-number.sh) 获取编号;再用 git fetch origin && git switch main && git pull --ff-only origin main 更新主分支;随后按类型创建分支,如 git switch -c feature/${NEXT_NUMBER}-my-feature-name、fix/${NEXT_NUMBER}-... 或 workflow/${NEXT_NUMBER}-...;创建后立即 git push -u origin HEAD 预留编号,然后继续后续工作。该流程分别适用于需求工程师(新功能)、问题分析师(缺陷修复)与工作流工程师(流程改进)。
限制与注意事项:必须同时检查全部变更类型以及本地与远程两个来源,不能仅依赖本地状态;不得在做出改动后才推送分支。若 GitHub 认证失败,脚本仅回退到本地文档检查并给出警告,此时需手动在 GitHub 核实是否存在更大编号。若算出的编号仍已存在,需确认脚本运行正确、检查是否有他人新推分支,删除自身分支后重跑脚本。验证方式:用 git ls-remote origin 过滤 feature/fix/workflow 对应编号分支,并确认本地尚未存在对应 docs 目录。