managing-git-workflow

Managing Git Workflow 技能为 HASH 仓库内部的代码品质与项目可追踪性提供了完整的框架。此技能专为 HASH 仓库的软件工程师与开发者设计，确保他们的贡献符合组织标准。通过自动化并引导本地开发与版本控制之间的交互，此技能降低了从任务执行到项目整合过程中的摩擦。

• 标准化分支命名规范，采用 <shortname>/h-XXXX-description 格式，强制要求将每次变更与特定的 Linear 票据连结。

• 强制执行结构化的 Pull Request (PR) 标题格式 (H-XXXX: Description)，以确保清晰的可追踪性并简化开发进度追踪。

• 引导使用者落实官方 PR 模板，涵盖目的、相关连结、实作细节以及合并前的强制检查清单。

• 提供循序渐进的 PR 审核协定，包含用于取得完整差异档、审核内嵌注解以及验证 Linear 问题需求的命令列工具。

• 促进与 Linear 项目管理工具的整合，在进行环境感知代码审核时呈现相关票据资讯。

• 在开发生命周期的每个阶段使用此技能：包括初始化功能分支、编写提交资讯、开启 PR 或进行同侪代码审核时。

• 输入通常包含您的开发者 ID、目标 Linear 票据编号以及变更的描述性意图。输出为分支/PR 的格式化字串或自我验证清单。

• 确保所有 PR 皆引用其关联的 H-XXXX 票据编号，以维持仓库的整洁与历史纪录。

• 审核代码时，利用提供的 Shell 指令（如 gh pr diff、gh pr view）以确保变更内容具有完整可见性，而非截断的摘要。

• 在最终确认任何合并请求前，务必参考合并前检查清单（涵盖函数库变更、文件与系统影响），以维持高信任度且安全的开发标准。