SuperAPI AI 工具集

managing-git-workflow

部署与运维

查看项目

更新于 10-16 05:50

技能介绍

该技能用于指导 HASH 项目的 Git 与 PR 工作流。公共基线是普通 Git 与 GitHub,无需特定客户端或访问 HASH 的 Linear 工作区即可参与贡献。贡献政策以 .github/CONTRIBUTING.md 为准,PR 内容以 .github/pull_request_template.md 为准。

用途与用法:当工作有对应的 HASH Linear issue 时,需保持可追溯性。分支命名为 <shortname>/<team-key>-xxxx-description,Linear 标识符用小写,例如 ln/fe-1437-hash-monorepo-import;PR 标题为 {ISSUE-ID}: Description,标识符保留大写,例如 H-6786: ...;在 PR 的相关链接中关联该 issue,不可公开访问时标记为 (internal)。常见标识符前缀有 FE-、SRE-、BE-、H-。无 Linear 访问权限的贡献者可用描述性分支名与 PR 标题,并为重要工作关联公开 issue 或 discussion。无论哪种情况,PR 描述都应自包含。

审查 PR:用 gh pr view <PR_NUMBER> --comments、gh pr diff <PR_NUMBER> 以及 gh api 获取评论记录与完整 diff,以 PR 描述和关联公开 issue 作为审查契约,完整检查 diff,区分阻塞性问题与可选建议,给出精确的文件与行位置。

合并队列:HASH 通过 GitHub 合并队列合并,主要面向维护者。enqueue 后 auto_merge 仍为 null,不能作为依据;可通过 timeline 中的 added_to_merge_queue 事件或 gh-readonly-queue/ 引用上的 merge_group 工作流运行来验证。ejection 可能源于其他 PR 或基础设施故障,需对比 PR 级运行的相同步骤,并注意 turbo.json 的 globalDependencies 与队列中 cargo hack --optional-deps --feature-powerset clippy 带来的特性条件差异。