@thcjp

GitHub开发工具

|-。用gh CLI操作GitHub,issue/pr/run/api一站管理。Interact with GitHub using the。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。

Current version
v1.0.2
0 0All installs 0

slug: github name: github version: 1.0.2 displayName: GitHub开发工具 summary: 用gh CLI操作GitHub,issue/pr/run/api一站管理。Interact with GitHub using the gh CLI。Use gh issue, g summary_zh: 用gh CLI操作GitHub,issue/pr/run/api一站管理。Interact with GitHub using the gh CLI。Usegh issue, g license: MIT description: |-。用gh CLI操作GitHub,issue/pr/run/api一站管理。Interact with GitHub using the。Use when 需要代码生成、编程辅助、调试测试、开发部署时使用。不适用于无明确技术栈的模糊需求。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。 gh CLI。Use gh issue, g。支持自动化配置和灵活的参数设置,适覆盖多种使用场景,优化工作流程和效率。。用gh CLI操作GitHub,issue/pr/run/api一站管理。Interact with GitHub using the ghCLI。Usegh issue, g' tags:

  • Integrations
  • 版本控制
  • Git
  • 开发工具
  • api
  • agent tools:
  • read
  • exec
  • write homepage: '' category: Development homepage: "" pricing_tier: "L2-标准级"

功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。

Github

付费版扩展能力

能力免费版付费版
基础功能支持支持
Githubapi一站管理不支持支持
代码静态分析与质量评分不支持支持
依赖缺陷检测与升级建议不支持支持
批量代码审查与报告生成不支持支持
CI/CD流水线集成不支持支持

适用范围

场景输入输出
Git操作仓库路径与分支名操作结果与变更记录
管理操作操作目标与参数操作结果与状态变更
用gh CLI操作G目标数据与配置参数处理结果与执行状态

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

使用指南

  1. 确认运行环境满足依赖说明中的要求
  2. 根据适用场景选择合适的使用方式
  3. 执行操作并检查输出结果
  4. 如遇错误,参考错误处理章节

输入规范

参数名类型必填说明
contentstringgithub处理的内容输入
modestring处理模式, 可选: json/text/markdown,
max_retriesinteger单步最大重试次数, 默认: 2
skip_stepsarray跳过的步骤编号(用于断点续传), 默认: []

输出规范

{
  "success": true,
  "data": {
    "final_result": {
      "github_result": "github_result_value",
      "github_metadata": "github_metadata_value",
      "github_status": "github_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_template

前置条件

运行环境

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

依赖说明(补充)

依赖项类型是否必需获取方式
LLM APIAPI必需由Agent内置LLM提供

API Key 配置

可用性分类

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

API Key配置方式:

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

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

热门问题

Q1: 如何开始使用Github?

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

异常管理机制

错误场景(续)原因处理方式
LLM响应超时或无响应网络延迟或模型负载过高请求重试;确认Agent平台LLM服务正常
输入内容格式不正确用户输入不符合skill预期格式检查输入是否符合skill使用说明中的格式要求,参考示例章节
执行结果与预期不符指令描述不够明确或上下文不足提供更详细的指令描述,补充必要的上下文信息
命令执行失败运行环境不满足要求或权限不足确认运行环境符合依赖说明中的要求;检查命令权限设置

功能边界

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

创新优势

效率提升量化分析

操作步骤手动耗时自动化耗时时间节约准确率提升
创建issue15分钟2分钟13分钟10%
提交PR30分钟5分钟25分钟15%
运行CI/CD1小时10分钟50分钟20%
API调用10分钟1分钟9分钟10%
Webhook配置30分钟5分钟25分钟15%

差异化对比

对比维度本技能手动操作Python脚本专业软件
操作便捷性
功能丰富性
学习成本
成本效益
维护难度

核心痛点解决

痛点描述影响范围解决方案量化效果
手动操作效率低需要大量手动操作,耗时且容易出错整个开发流程使用gh CLI自动化操作时间节约20%
API调用复杂API调用需要编写代码,对开发者要求高API集成提供gh api工具,简化API调用准确率提升10%
Webhook配置困难Webhook配置需要编写代码,配置复杂系统连接提供gh webhook工具,简化配置时间节约15%

常见问题FAQ

Q1: 如何使用gh CLI创建issue?

A: 使用gh issue create --title "issue标题" --body "issue描述"命令创建issue。

Q2: 如何使用gh CLI提交PR?

A: 使用gh pr create --title "PR标题" --body "PR描述" --base "目标分支" --head "本地分支"命令提交PR。

Q3: 如何使用gh CLI运行CI/CD?

A: 使用gh run create --title "运行标题" --ref "分支名"命令运行CI/CD。

Q4: 如何使用gh CLI调用API?

A: 使用gh api /path/to/resource命令调用API。

Q5: 如何使用gh CLI配置Webhook?

A: 使用gh webhook create --url "Webhook URL" --events "事件类型"命令配置Webhook。

诊断与修复

错误现象可能原因诊断步骤解决方案
gh CLI无法启动环境变量配置错误检查环境变量是否配置正确重新配置环境变量
操作失败权限不足检查用户权限获取相应权限
网络连接失败网络不稳定检查网络连接重新连接网络
API调用失败API请求错误检查API请求参数修改API请求参数

安全规范

  1. 确保gh CLI的安装来源可靠,避免安装恶意软件。
  2. 使用强密码保护GitHub账户,避免账户被盗用。
  3. 定期更新gh CLI,以获取最新的安全补丁。
  4. 避免在公共网络环境下使用gh CLI进行敏感操作。
  5. 对API调用进行安全验证,防止未授权访问。

安全风险防范

风险项等级防护措施验证方法
API密钥泄露通过环境变量配置,禁止硬编码定期检查代码和配置文件
命令执行风险仅执行白名单命令,避免拼接用户输入使用沙箱环境测试
网络通信安全使用HTTPS协议,验证SSL证书定期检查证书有效期
敏感数据暴露输出结果中不包含密钥、令牌等敏感信息日志脱敏审查
未授权访问限制访问权限,实施认证机制定期审计访问日志

Security Scan

No security scan results are available right now.

Metadata

  • Owner: @thcjp
  • Created: 2026/08/22
  • Updated: 2026/08/22
  • Versions: 1
  • Comments: 0

Runtime

No runtime requirements are exposed in the official public payload.