用途:为所有代码变更提供结构化 Git 工作流,防止工作丢失。核心原则包括议题优先(所有工作从 bd 或 GitHub 议题开始)、每个议题一个功能分支、约定式提交、语义化版本、工作日志记录,以及合并前的人工验收测试(UAT)。
主要能力:规范分支命名 <type>/<issue-id>-<short-description>,类型含 feature/、fix/、chore/、docs/、refactor/。约定式提交格式 <type>(<scope>): <description>,类型含 feat、fix、docs、style、refactor、test、chore,破坏性变更可在类型后加 !。语义化版本 MAJOR.MINOR.PATCH,创建附注标签 git tag -a v1.2.0 -m "...",推送 git push origin --tags。工作日志写入 .worklog/YYYY-MM-DD-issue-id-description.md,含摘要、变更、修改文件、测试和恢复说明。
使用方式:先同步并创建分支 git fetch origin、git checkout main、git pull origin main、git checkout -b feature/{issue-id}-description,认领议题 bd update {issue-id} --status in_progress;提交 git add <files>、git commit -m "feat(scope): description",首次推送 git push -u origin feature/{issue-id}-description;完成后运行 npm test,编写工作日志,请求 UAT /uat request <feature-name>,批准后合并 git merge --no-ff、关闭议题 bd close,再删除分支。拒绝时按反馈修改、更新日志并重新请求。
适用场景:需要规范提交历史、版本管理和人工验收的代码库开发流程。
限制:UAT 需人工介入;依赖 bd 或 GitHub 议题系统与 /uat 命令;具体工具与 CI 集成细节暂未提供。