1k-git-workflow

本技能用于统一 OneKey 仓库的 Git 协作规范，覆盖分支管理、分支命名、提交信息格式与 PR 创建四部分。\n\n分支管理：主开发分支为 x，工作流为“x → 创建特性分支 → 开发 → 以 PR 合回 x”。禁止使用 onekey、master 或 main 作为基础分支；禁止直接在 x 分支上工作，必须新建特性分支。\n\n分支命名：特性分支用 feat/description 或 feature/description，缺陷修复用 fix/description，重构用 refactor/description。\n\n提交信息：采用 Conventional Commits 格式，type 包括 feat、fix、refactor、perf 或 optimize、chore、docs；格式为“type: 简短描述”，使用小写，首行不超过 72 字符，必要时带问题编号，例如 fix: resolve login bug OK-12345。若由 Claude Code 提交，不得包含 “Generated with Claude Code” 链接和 “Co-Authored-By: Claude” 署名，提交信息应与人写提交无差别。\n\nPR 命名：与提交信息格式一致，如 feat: add dark mode support、fix: resolve authentication timeout issue。\n\n常用操作：创建分支先执行 git checkout x、git pull origin x、git checkout -b feat/my-new-feature。提交推荐使用 /commit 命令，它会自动执行 yarn lint:staged 与 yarn tsc:staged 预检并生成规范提交信息；也可手动执行 git add .、yarn lint:staged、yarn tsc:staged，通过后再 git commit -m "feat: add user profile page"。预检为强制要求，禁止提交未通过 lint 或 TypeScript 编译的代码。推送使用 git push -u origin feat/my-new-feature，随后通过 GitHub UI 或 gh CLI 创建 PR。同步最新 x 分支使用 git fetch origin 与 git rebase origin/x。\n\n适用场景为在该仓库中做任何代码改动与提交。限制：规范针对该仓库，主分支与预检要求以此仓库约定为准；其余平台或仓库是否适用暂未提供。