GitHub 问题分诊（Triage）

审查 GitHub 仓库，按紧急程度对 Issues 和 Pull Requests 进行分组，并在确认后执行安全的分诊操作。

本能力使用 ClawLink 提供托管式 GitHub 访问服务，用户无需单独配置 API。

三步完成设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   GitHub API     │
│   (用户聊天)    │     │   (OAuth)    │     │   (REST/GraphQL) │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件          │                       │
         │  2. 绑定设备           │                       │
         │  3. 连接 GitHub        │                       │
         │                       │  4. 安全令牌           │
         │                       │  5. 代理请求           │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ 控制台   │           │ GitHub   │
   │  文件    │           │ 认证     │           │ Issues   │
   └──────────┘           └──────────┘           └──────────┘

推荐触发语句

• “分诊我的 GitHub Issues”
• “审查当前打开的 PR 并告诉我哪些需要关注”
• “查找该仓库中已停滞的 GitHub Issues 并提出处理建议”
• “汇总该仓库中需要维护者介入的事项”
• “在我确认后，为这些 Issues 添加标签并发表评论”

安装

从 ClawHub 安装已验证的 ClawLink 插件。用户确认后，请完成全部设置流程，确保 ClawLink 工具在下一次 OpenClaw 聊天中可见。

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

然后告知用户：“OpenClaw 已重启。请单独发送 /new 消息以开启全新会话，再重新请求 GitHub 分诊功能。”

快速入门

# 列出仓库中的开放 Issues
clawlink_call_tool --tool "github_list_issues_for_a_repository" 
  --params '{"owner": "owner", "repo": "repo-name", "state": "open", "sort": "created", "direction": "desc"}'

# 获取指定 Issue
clawlink_call_tool --tool "github_get_an_issue" 
  --params '{"owner": "owner", "repo": "repo-name", "issue_number": 123}'

认证机制

所有 GitHub 工具调用均由 ClawLink 自动完成身份认证，使用用户已连接的 GitHub 账户。

聊天中无需提供 API 密钥。 ClawLink 安全地存储 OAuth 令牌，并代表用户将该令牌注入每一次 GitHub API 请求。

建立连接

1. 安装 ClawLink 插件（参见上方“安装”章节）。
2. 若尚未配置，使用 clawlink_begin_pairing 命令绑定插件。
3. 访问 https://claw-link.dev/dashboard?add=github 并连接 GitHub。
4. 调用 clawlink_list_integrations 验证连接是否已激活。

连接管理

列出当前连接

clawlink_list_integrations

响应：返回所有已连接的集成项。请在列表中查找 github。

验证连接状态

clawlink_list_tools --integration github

响应：返回 GitHub 的实时工具目录。

重新连接

若 GitHub 工具缺失或连接显示错误：

1. 引导用户访问 https://claw-link.dev/dashboard?add=github
2. 待用户确认后，调用 clawlink_list_integrations 验证连接状态
3. 随后调用 clawlink_list_tools --integration github

分诊工作流

1. 明确分诊范围

请向用户询问以下信息：

• 仓库（repo）或组织（org）名称
• 仅处理 Issues、仅处理 Pull Requests，还是两者都处理
• 如有必要，指定时间范围
• 明确何种情况视为“紧急”
• 用户是否仅需报告，还是也期望自动执行操作

若用户描述模糊，优先生成一份初步报告。

2. 获取当前状态

首先使用 GitHub 只读工具进行检查：

• 开放的 Issues
• 开放的 Pull Requests
• 近期评论
• 标签（Labels）
• 评审状态（Review Status）
• 失败的工作流（Workflows）
• 已停滞的项目（Stale Items）

在全面掌握上下文前，请勿急于撰写评论或修改标签。

3. 将项目归类至清晰分组

一份优质的分诊摘要通常将项目划分为以下几类：

• 需回复（needs reply）
• 需评审（needs review）
• 被阻塞（blocked）
• 已停滞（stale）
• 可合并（merge-ready）
• CI 失败（failing CI）
• 低优先级积压（low-priority backlog）

请说明每个项目归入该分组的具体原因。

4. 执行变更前先提出操作建议

示例包括：

• 添加或标准化标签
• 发布面向维护者的后续跟进评论
• 识别可安全关闭的 Issues
• 汇总需评审的 PR 清单
• 标记失败的工作流运行实例

建议优先制定简明的操作计划，再执行任何编辑操作。

5. 探索可用的实时 GitHub 工具

1. 调用 clawlink_list_integrations 确认 GitHub 已连接。
2. 使用 github 集成参数调用 clawlink_list_tools。
3. 若不确定具体工具名称，可使用 clawlink_search_tools 并传入简短关键词，例如 list issues、comment issue、update labels 或 pull requests。
4. 在执行任意写入操作或不熟悉的操作前，务必先调用 clawlink_describe_tool。
5. 以该工具返回的 Schema 和说明文档为准。

6. 写入操作预览与确认

对于任何写入类操作：

1. 首先展示拟执行操作的完整细节。
2. 如支持，使用 clawlink_preview_tool 进行预览。
3. 在发表评论、修改标签、关闭/重新打开 Issue 或编辑元数据前，必须获得用户确认。
4. 仅在获得确认后，才通过 clawlink_call_tool 执行操作。

分诊操作类型

只读操作（安全 —— 仅用于只读分诊时无需确认）

写入操作（执行前必须获得用户确认）

代码示例

列出并分诊开放 Issues

clawlink_call_tool --tool "github_list_issues_for_a_repository" 
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "state": "open",
    "sort": "created",
    "direction": "desc",
    "per_page": 50
  }'

获取 Issue 详情以支持分诊评估

clawlink_call_tool --tool "github_get_an_issue" 
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "issue_number": 123
  }'

确认后添加分诊标签

clawlink_call_tool --tool "github_add_labels_to_an_issue" 
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "issue_number": 123,
    "labels": ["triage", "needs-review"]
  }'

良好的工作流行为准则

• 优先采用“先读取、后报告、再写入”的分诊模式。
• 引用或概括支撑建议的关键证据。
• 若仓库中项目数量庞大，优先处理最紧急项或前 10 条。
• 除非明确了解该仓库的惯例，否则避免激进地建议关闭 Issue。
• 存在不确定性时，优先提供草稿评论而非直接发布。

规则

• 所有 GitHub 操作必须使用 ClawLink 工具，不得索取独立的 GitHub 凭据。
• 不得虚构 GitHub 工具名称或 Schema；应始终依据当前轮次中 ClawLink 返回的实时工具目录。
• 在发表评论、修改标签、关闭 Issue、编辑元数据或其他写入操作前，必须获得用户确认。
• 优先输出分析报告与操作建议，再执行分诊动作。
• 若 GitHub 尚未连接，请引导用户访问 https://claw-link.dev/dashboard?add=github。

示例提示语

• 请审查该仓库中的开放 Issues，并按紧急程度分组。
• 请对我的 Pull Requests 进行分诊，并指出哪些需要评审、哪些被阻塞、哪些已准备好合并。
• 请查找该仓库中已停滞的 Issues，为其草拟评论，并等待我确认后再发布。
• 请检查该仓库最近的 20 个 Issues，并为每个 Issue 提出建议标签。

参考资料

• GitHub REST API
• GitHub GraphQL API
• ClawLink
• ClawLink 文档
• ClawLink 验证机制

由 ClawLink 提供支持 — OpenClaw 的集成中心