核心功能: 本技能提供时使用等能力。

GitHub

付费版扩展能力

主要能力

• Work with GitHub repositories, issues, pull requests, commits, branches, releases, and workflows

场景说明

不适用于：需要人工判断的复杂决策场景

使用指南

clawlink_call_tool --tool "github_list_repositories_for_the_authenticated_user" --params '{}'
# ...
clawlink_call_tool --tool "github_get_a_repository" --params '{"owner": "owner", "repo": "repo-name"}'
# ...
clawlink_call_tool --tool "github_list_issues_for_a_repository" --params '{"owner": "owner", "repo": "repo-name", "state": "open"}'

请求格式

输出规范

{
  "success": true,
  "data": {
    "final_result": {
      "repos_result": "repos_result_value",
      "repos_metadata": "repos_metadata_value",
      "repos_status": "repos_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/github-repos_template

故障处理方案

错误恢复步骤

1. Check that the ClawLink plugin is installed:

   bash

   skill-platform plugins list
   

2. If the plugin is installed but tools are missing, tell the user to send /new as a standalone message to reload the catalog.

3. If a fresh chat does not help, run:

   bash

   skill-platform config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
   skill-platform gateway restart
   

4. After restart, tell the user to send /new again and retry.

Troubleshooting: Invalid Tool Call

1. Ensure the integration slug is exactly github.
2. Use clawlink_describe_tool to verify parameter names and types before calling.
3. For write operations, always call clawlink_preview_tool first.

处理方式: 参考上表中的错误场景说明,按照对应建议进行处理和恢复.

依赖与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

案例展示

List open issues in a repository

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

Create a new issue

clawlink_call_tool --tool "github_create_an_issue" \
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "title": "Bug: Login fails on mobile",
    "body": "Steps to reproduce: 1. Go to login 2. Enter credentials 3. Error shown",
    "labels": ["bug", "high-priority"]
  }'

Add labels to an issue

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

Create a pull request

clawlink_call_tool --tool "github_create_a_pull_request" \
  --params '{
    "owner": "owner",
    "repo": "repo-name",
    "title": "Fix login bug",
    "head": "fix/login-bug",
    "base": "main",
    "body": "Fixes #123 - Login fails on mobile devices"
  }'

问题汇总

Q1: 如何开始使用GitHub？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

限制条件

• 需要API Key，无Key环境无法使用

常见问题FAQ

Q1: 如何为GitHub仓库添加新的分支？

A: 使用 github_create_a_branch 工具，提供仓库所有者、仓库名、分支名和基于的分支作为参数。

Q2: 如何查看某个特定提交的历史？

A: 使用 github_list_commits 工具，指定仓库所有者、仓库名和提交哈希或SHA。

Q3: 如何批量关闭仓库中的所有issue？

A: 使用 github_close_issues 工具，提供仓库所有者、仓库名和状态为关闭的issue列表。

Q4: 如何创建一个用于合并请求的标签？

A: 使用 github_create_a_tag 工具，提供仓库所有者、仓库名、标签名和可选的标签消息。

Q5: 如何在GitHub上搜索特定的文件？

A: 使用 github_search_files 工具，提供仓库所有者、仓库名、文件路径和搜索关键词。

安全保证

差异化分析

功能优势

• 自动化执行: 管GitHub仓库/issue/PR/提交/分支/发布/工作流。Work with GitHub repositorie
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

量化评估

差异分析

GitHub仓库管理工具通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块