GitHub Triage


审查 GitHub 仓库，按紧急程度分组问题和拉取请求，并在确认后执行安全的分类操作。

此技能使用 [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=github-triage-workflow) 提供托管的 GitHub 访问服务，用户无需单独配置 API。

3 步骤快速设置

工作原理

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   GitHub API     │
│   (用户聊天)    │     │   (OAuth)    │     │   (REST/GraphQL) │
└─────────────────┘     └──────────────┘     └──────────────────┘
         │                       │                       │
         │  1. 安装插件          │                       │
         │  2. 配对设备          │                       │
         │  3. 连接 GitHub        │                       │
         │                       │  4. 安全令牌注入      │
         │                       │  5. 代理请求          │
         │                       │                       │
         ▼                       ▼                       ▼
   ┌──────────┐           ┌──────────┐           ┌──────────┐
   │  SKILL   │           │ Dashboard│           │ GitHub   │
   │  文件    │           │ 认证     │           │ 问题     │
   └──────────┘           └──────────┘           └──────────┘

有效的触发语句

• “帮我处理我的 GitHub 问题”
• “检查开放的 PR 并告诉我哪些需要关注”
• “找出过期的 GitHub 问题并提出处理建议”
• “总结这个仓库中需要维护者处理的内容”
• “在我确认后，为这些问题添加标签并留言”

安装

从 ClawHub 安装已验证的 ClawLink 插件。用户确认后，完成完整设置，以便在下次 OpenClaw 聊天中看到 ClawLink 工具。

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

然后告知用户：“OpenClaw 已重启。请发送 /new 作为独立消息以开启新对话，再请求一次 GitHub 分类。”

快速入门

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

# 获取特定问题详情
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. 确定分类范围

询问以下内容：

• 仓库或组织名称
• 仅问题、仅拉取请求，或两者都包含
• 是否需要指定时间范围
• 何为“紧急”事项
• 用户是否只需要报告，还是希望直接执行操作

若用户描述模糊，优先默认生成报告。

2. 收集当前状态信息

先使用 GitHub 读取类工具检查：

• 开放的问题
• 开放的拉取请求
• 最近的评论
• 标签情况
• 审查状态
• 失败的工作流
• 过期项目

在未全面了解情况前，不要急于撰写评论或修改标签。

3. 将项目归类至清晰类别

一份良好的分类摘要通常将项目分为：

• 需要回复
• 需要审查
• 被阻塞
• 过期
• 可合并
• CI 流水线失败
• 低优先级待办清单

说明每项为何属于该类别。

4. 提出操作建议，再执行变更

示例建议：

• 添加或统一标签
• 留下维护者跟进评论
• 识别可安全关闭的问题
• 总结需要审查的 PR
• 标记失败的工作流运行

建议先提供简明的操作计划，再进行任何修改。

5. 探索实时 GitHub 工具

1. 调用 clawlink_list_integrations 确认 GitHub 已连接。
2. 使用 github 作为集成参数，调用 clawlink_list_tools。
3. 若不确定具体工具，可使用 clawlink_search_tools 搜索如 列出问题、评论问题、更新标签、拉取请求 等关键词。
4. 在执行写入操作或使用不熟悉工具前，调用 clawlink_describe_tool 获取详细说明。
5. 以返回的工具模式和指引为准，作为操作依据。

6. 预览并确认写入操作

技能：GitHub 问题分类（Triage）

版本：1.0.2

分块：2/2

对于任何写入操作：

1. 首先展示预期执行的具体操作。
2. 若 clawlink_preview_tool 可用，优先使用。
3. 在评论、重新标记、关闭、重新打开或编辑元数据等操作前，必须请求确认。
4. 仅在获得确认后，才使用 clawlink_call_tool 执行操作。

问题分类操作

读取操作（安全 —— 仅读取操作无需确认）

写入操作（执行前需确认）

代码示例

列出并分类开放中的问题

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
  }'

获取问题详情以评估分类

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个开始处理。
• 除非明确知晓仓库惯例，否则避免过度主动关闭问题。
• 若存在不确定情况，建议先起草评论，待确认后再发布。

规则

• 所有 GitHub 操作必须通过 ClawLink 工具执行，不得要求用户提供独立的 GitHub 凭据。
• 不得虚构 GitHub 工具名称或参数结构，必须使用当前会话中可用的 ClawLink 工具目录。
• 在评论、标签变更、问题关闭、元数据修改等写入操作前，必须请求确认。
• 优先进行报告与建议，再采取具体分类动作。
• 若未连接 GitHub，请引导用户前往 https://claw-link.dev/dashboard?add=github。

示例提示

• 审查此仓库中的开放问题，并按紧急程度进行分组。
• 对我的拉取请求进行分类，告诉我哪些需要评审、哪些被阻塞、哪些可合并。
• 查找此仓库中过期的问题，为它们起草评论，并等待我的确认。
• 检查该仓库最近的20个问题，为每个问题提出合适的标签建议。

资源

• [GitHub REST API](https://docs.github.com/en/rest)
• [GitHub GraphQL API](https://docs.github.com/en/graphql)
• [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=github-triage-workflow)
• [ClawLink 文档](https://docs.claw-link.dev/openclaw)
• [ClawLink 验证页面](https://claw-link.dev/verify)

由 [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=github-triage-workflow) 提供支持 —— OpenClaw 的集成枢纽