TaskGoblin 连接两类工具,这个区分决定了你如何注册:
- Git 提供商 — GitLab 或 GitHub — 提供你的仓库并开通你的组织。每个组织恰好一个,在登录时选定。
- 能力提供商 — Linear、Jira、Slack 和 Microsoft Teams — 提供循环可以触发、哥布林可以汇报的场所。这些是连接到你已有的组织上的。
全部在组织菜单的 集成 中管理(/{organisation}/integrations)。
连接一个提供商就会装上它的默认循环。 这是值得记住的实际后果:集成不只是一份凭据,而是随之而来的一组常驻行为。各自安装了什么,见事件循环。
Git 提供商(GitLab 或 GitHub)
登录就是连接你的 git 提供商——一次 OAuth 授权同时完成身份验证、开通组织和连接仓库。这就是为什么没有单独的"连接仓库"步骤。
GitLab
连接 GitLab 会枚举你所属的群组,并为每个群组开通一个 TaskGoblin 组织,外加一个个人组织。哥布林在合并请求和 issue 中以 @taskgoblin 身份发言。若令牌需要刷新,集成页面提供一键重新连接。
安装:审查合并请求、处理被指派的 issue。
GitHub
GitHub 是一个 GitHub App,不是传统 OAuth 应用。你把 TaskGoblin 应用安装到想要的组织上,每次安装成为一个 TaskGoblin 组织。应用按需签发短期安装令牌,哥布林以 taskgoblin[bot] 身份发言。由于权限通过安装本身刷新,GitHub 组织从不需要手动重新连接。
安装:审查拉取请求、处理被打标签的 issue。
由 git 开通的组织会锁定到创建它的提供商——该提供商的卡片提供重新连接而不是断开连接。
能力提供商
Linear
对当前组织的一键 OAuth 授权。连接后,哥布林可以领取指派给 TaskGoblin 智能体的 issue,读取 issue 及其评论作为上下文,并把状态、活动和合并请求链接发回 issue 上。
安装:处理被指派的 issue。
Jira
一次 Atlassian OAuth 授权,把你的 Jira 站点连接到当前组织。哥布林会领取指派给 TaskGoblin 账号的 issue,并回应 issue 评论中的提及——以评论形式回复在 issue 上,并在你要求时推动它走完工作流。
Jira 的 issue 很少会指明仓库,所以哥布林会从请求本身、你的组织记忆以及你已连接的仓库中推断目标——实在无法判断时它会询问,而不是猜。告诉它一次就够了,它会把答案记下来。
安装:处理被指派的 issue。
Slack
连接 Slack 后,任何人都能在线程里提及哥布林,并在对话发生的地方得到回复。机器人令牌不会过期,因此没有需要刷新的东西。当计划循环的指令指定了频道时,摘要和提醒也会送到 Slack。
不安装自己的循环——它是场所,不是触发器。
Microsoft Teams
在 Teams 频道、群聊或私信中提及哥布林,它会就地回复,并随着工作推进不断编辑自己的那条消息。连接会验证你的 Microsoft 租户;没有需要你管理的机器人令牌。
不安装自己的循环。
哥布林如何以自己的身份认证
你从不需要把个人访问令牌粘贴进 TaskGoblin,哥布林也从不会看到你的凭据。
每个提供商都有自己的机器人身份——GitLab、Slack 和 Teams 上是 @taskgoblin,GitHub 上是 taskgoblin[bot]。在沙箱内部,git 凭据在运行时按组织下发(GitLab OAuth 令牌,或新签发的 GitHub 安装令牌),并注入到智能体周围的环境中,而不是交给它去读取。
这条边界是刻意为之,也解释了为什么哥布林通过自己的集成发表评论,而不是用拿到的 git 令牌:用你的令牌发的评论会以你的名义出现。哥布林说的每一句话,都以它自己的身份说出。
断开连接
在集成页面断开某个提供商,哥布林会立刻失去该访问权限——依赖它的循环停止触发,那里不再读取或发布任何内容。重新连接会恢复同一个连接。