Skip to main content

其他官方参考适配器

文档状态
draft
文档 Owner
DOC
事实源
canonical-docs
更新
2026/10/16

本文只说明已读取的官方参考 revision be10a1b79df723d6d7612b5651c8522704dafb2e。GitHub Issues、Jira Cloud、Asana 和 GitLab 在这个版本有适配器代码；不表示团队部署已包含、启用或跑通这些来源。Linear 见专页，公共机制见接入边界。

下列均为 tracker 配置片段，未实跑，不能代替完整 WORKFLOW、已有认证与项目授权。先替换占位符并核对来源真实状态；不要通过复制示例扩大凭据或项目范围。

GitHub Issues​

tracker:
  kind: github
  provider:
    repo: YOUR_ORG/YOUR_REPO
    token: $GITHUB_TOKEN
    api_url: https://api.github.com
  active_states: [open]
  terminal_states: [closed]

id 为仓库 issue number 的字符串，标识为 GH-<number>，native_ref 保留来源定位。Issues API 返回的 PR 不可派发；隐藏或删除后返回 404 的 issue 在刷新中省略。此适配器不提供 Linear 式 blocker 映射；来源工具是 github_api。

源码：Adapter · Client。

Jira Cloud​

tracker:
  kind: jira
  provider:
    base_url: $JIRA_BASE_URL
    email: $JIRA_EMAIL
    api_token: $JIRA_API_TOKEN
    project_key: YOUR_PROJECT_KEY
  active_states: [YOUR_ACTIVE_STATUS]
  terminal_states: [YOUR_TERMINAL_STATUS]

状态占位符必须换成项目原生状态名。id 为 Jira 不变 ID，identifier 为 issue key；状态来自 fields.status.name。inward Blocks 关系映射为 blocker，new 状态类别在 blocker 未终态时等待，不能套用 Linear 的状态名。原生工具是 jira_rest；认证可访问范围仍由实际凭据决定。

源码：Adapter · Client。

Asana​

tracker:
  kind: asana
  provider:
    project_gid: YOUR_PROJECT_GID
    api_key: $ASANA_PAT
    endpoint: https://app.asana.com/api/1.0
  active_states: [YOUR_ACTIVE_SECTION]
  terminal_states: [YOUR_TERMINAL_SECTION]

状态取指定项目 membership 的 section 名称，不是随意定义的统一 Todo / Done。任务以 gid 和 ASANA-<gid> 标识，保留项目与 section 的 native_ref；completed task 和 section 条目不可派发。标签来自 tags，已删除或移出所选项目的任务在刷新中省略。工具是 asana_api。

源码：Adapter · Client。

GitLab Issues​

tracker:
  kind: gitlab
  provider:
    project_path: YOUR_GROUP/YOUR_PROJECT
    api_key: $GITLAB_PAT
    api_url: https://gitlab.com/api/v4
  active_states: [opened]
  terminal_states: [closed]

id 是项目 IID 的字符串，标识为 GL-<iid>，native_ref 保留项目定位。使用实际 issue 状态 opened / closed，不把 MR 生命周期或团队审核状态名放入这个示例。工具是 gitlab_api；它与团队用于受控 MR 合并的扩展合同不同。

源码：Adapter · Client。

换来源时重新核对​

先明确实例与原生任务范围，处理正在运行的 worker、待保留目录和外部副作用，再由配置 owner 调整对应实例；不能仅改 kind 并继续复用另一来源的 ID 或状态。接入结果按完成判据核对，不以配置成功解析证明真实可用。官方 README 的来源说明见固定版本。

Last updated on by source2728