GitHub 集成
将您的 GitHub 存储库连接到 SprintFlint，以自动将拉取请求链接到工单、创建分支并跟踪代码更改。
连接GitHub
要将您的组织连接到 GitHub：
- 单击侧边栏中的头像
- 前往“组织设置”
- 点击“连接GitHub”
- 授权 SprintFlint 访问您的存储库
权限 - SprintFlint 请求对您的存储库的读取权限。我们用它来检测拉取请求并将它们链接到工单。我们绝不会修改您的代码。
将存储库链接到项目
在组织级别连接 GitHub 后，将特定存储库链接到项目：
- 导航到您的项目设置
- 从下拉列表中选择一个存储库
- 保存项目
自动公关检测
SprintFlint 自动检测拉取请求并通过扫描您的工单编号（例如， PROJ-123）在：
- 分行名称 - e.g.,
feature/PROJ-123-user-auth,proj-123-auth,proj123 - 公关标题 - 例如，“PROJ-123：添加用户身份验证”
- 公关说明 - 例如，“此 PR 实现了 PROJ-123”
常见的关键词如 fixes, closes, 或 resolves 支持但可选 - 仅工单号就足够了。
创建分支
SprintFlint 可以直接从 UI 为工单创建分支：
- 打开一个工单
- 在侧边栏中，单击“创建分支”
- SprintFlint 创建分支并打开 GitHub 桌面
分支命名
当通过 SprintFlint 创建分支或使用自动播放功能时，分支会自动使用您的项目前缀命名，后跟工单编号和 AI 生成的标题。对于开发人员来说，他们只需引用工单编号或将其包含在分支名称中即可。例如：
{prefix}{issue-number}-{kebab-case-title}例如：
- 带前缀
sf-:sf-123-add-user-authentication - 带前缀
PROJ-:proj-123-add-user-authentication
拉取请求状态
将 PR 链接到工单后，您将看到：
- 公关标题 - 拉取请求标题
- 状态 - 开放、合并或关闭
- 链接 - 直接链接至 GitHub 上的 PR
网络钩子
SprintFlint 使用 GitHub Webhooks 接收有关拉取请求的实时更新。当您连接存储库时，我们会自动创建一个 Webhook。
Webhook 权限 - 您需要对存储库进行管理员访问才能创建 Webhook。如果您没有管理员访问权限，请要求存储库管理员连接集成。
断开GitHub
断开 GitHub 的连接：
- 前往“组织设置”
- 点击“断开GitHub”
- 确认断开连接
断开连接将：
- 删除存储的访问令牌
- 从连接的存储库中删除 webhook
- 保留现有的 PR 链接（作为历史数据）
故障排除
PR 未被检测到
如果拉取请求没有自动链接：
- 确保存储库链接到正确的项目
- 检查您的工单编号格式是否与项目前缀匹配
- 验证 GitHub 中的 Webhook 是否处于活动状态（存储库设置 → Webhooks）
权限错误
如果您看到权限错误：
- 重新授权GitHub连接
- 确保您有权访问存储库
- 检查存储库是否未被重命名或删除