OpenViking VikingBot 的 GitHub Skill基于 gh CLI 的 PR / CI / API 协作实战指南【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking导读本文围绕 OpenViking 机器人框架VikingBot内置的githubSkill 展开讲解如何让 Agent 通过 GitHub 官方ghCLI 完成 Issue 管理、Pull Request 状态检查、CI 工作流查看与高级 API 查询等开发协作任务。读完本文你将掌握githubSkill 的完整命令集gh pr、gh run、gh api等、其 YAML frontmatter 的依赖声明机制requires.bins、install以及 Skill 被 VikingBot 加载进 Agent 上下文的底层原理可直接在本地工作区或沙箱环境中复现全部示例。相关文件github Skill 定义 · Skills 目录说明 · Skill 加载器实现Skill 概览与定位github是 VikingBot 预置的内置 Skill 之一位于 bot/workspace/skills/github/SKILL.md。它本身不封装任何私有逻辑而是把 GitHub 官方的ghCLI 能力编排成一份可直接注入 Agent 上下文的指令集让 Agent 以自然语言任务驱动的方式完成仓库协作操作。从 bot/workspace/skills/README.md 的技能清单可以看出github与github-proxyGitHub 国内访问加速、weather、summarize、tmux、skill-creator并列共同构成 VikingBot 的开箱即用能力集Skill说明github使用ghCLI 与 GitHub 交互本文主题github-proxy通过代理加速 GitHub 仓库克隆与文件下载weather使用 wttr.in 与 Open-Meteo 获取天气summarize总结 URL、文件与 YouTube 视频tmux远程控制 tmux 会话skill-creator创建新 SkillgithubSkill 的核心设计约束只有一条始终通过ghCLI 与 GitHub 交互当 Agent 不处于某个 git 目录内时必须显式指定--repo owner/repo或直接使用仓库 URL。这条约定保证了命令在任何工作目录下都能准确命中目标仓库也是理解下文所有命令示例的前提。YAML frontmatter 与依赖声明githubSkill 的头部 YAML frontmatter 是理解其运行机制的关键完整内容如下--- name: github description: Interact with GitHub using the gh CLI. Use gh issue, gh pr, gh run, and gh api for issues, PRs, CI runs, and advanced queries. metadata: {vikingbot:{emoji:,requires:{bins:[gh]},install:[{id:brew,kind:brew,formula:gh,bins:[gh],label:Install GitHub CLI (brew)},{id:apt,kind:apt,package:gh,bins:[gh],label:Install GitHub CLI (apt)}]}} ---字段拆解nameSkill 名称同时也是其所在目录名github。description面向 Agent 的语义描述说明该 Skill 覆盖 Issue、PR、CI runs 与高级查询四类能力。Agent 会依据此描述在总结视图中判断何时需要读取完整 Skill 内容。metadata.vikingbotVikingBot 作用域的元数据包含三个子字段emoji用于在部分渠道如飞书以表情反应processing reaction形式给出交互反馈。requires.bins[gh]声明本 Skill 运行所需的可执行文件。加载器会通过shutil.which在系统PATH中检查不满足时该 Skill 会被标记为不可用。install一组安装候选方案按平台给出此处为 Homebrew 与 APT 两种供 Agent 在检测到依赖缺失时参考执行。依赖检查的源码实现requires.bins的检查逻辑在 bot/vikingbot/agent/skills.py 的_check_requirements与_get_missing_requirements中实现def _check_requirements(self, skill_meta: dict) - bool: requires skill_meta.get(requires, {}) for b in requires.get(bins, []): if not shutil.which(b): return False for env in requires.get(env, []): if not os.environ.get(env): return False return True即对bins列表逐项执行shutil.which(b)检查 PATH对env列表检查环境变量是否存在全部满足才认为 Skill 可用。_get_missing_requirements还会把缺失项格式化为CLI: gh这样的可读描述用于在技能总结中提示 Agent“哪些依赖未安装”。对应的单元测试位于 bot/tests/test_skills_metadata.pytest_skill_requirements_support_nested_yaml它验证了 frontmatter 中嵌套的metadata.requires.bins能被正确解析为{requires: {bins: [lark-cli]}}结构从而确认这套解析链路对githubSkill 同样成立。安装 gh CLI在 macOSHomebrew与 Debian/UbuntuAPT上分别执行# Homebrew brew install gh # APT sudo apt install gh安装完成后可通过gh --version验证并在首次使用前执行gh auth login完成 GitHub 账号认证。Skill 中install元数据提供的正是前两条命令的等价安装声明便于 Agent 在沙箱环境缺失gh时自主处理。Pull Requests 与 CI 检查Skill 的核心实战部分围绕 PR 与 CI 展开包含四条高频命令。检查 PR 的 CI 状态gh pr checks 55 --repo owner/repogh pr checks会列出指定 PR 关联的全部 CI 检查项及其当前状态pending / passing / failing55为 PR 编号。--repo owner/repo用于在非 git 目录中显式指定目标仓库。列出最近的工作流运行gh run list --repo owner/repo --limit 10gh run list输出仓库最近的 Actions 工作流运行记录--limit 10控制条数上限。调试 CI 的第一步通常是先定位目标 run再进一步查看详情。查看某个运行及其失败步骤gh run view run-id --repo owner/reporun-id是工作流运行的唯一 ID可从gh run list结果中获取。该命令展示整体运行概览、作业/步骤的成败状态帮助快速定位失败发生在哪一步。仅查看失败步骤的日志gh run view run-id --repo owner/repo --log-failed--log-failed只输出失败步骤的日志避免了在数百行无关日志中人工翻找是排查 CI 失败的最高效姿势。Agent 使用建议面对 CI 失败时可按“run list定位 run →run view看失败步骤 →run view --log-failed取日志”的三步走流程执行与 Skill 中命令的编排顺序完全一致。gh api高级查询对于gh子命令未覆盖的数据Skill 明确推荐使用gh api直接调用 GitHub REST API。获取 PR 的指定字段gh api repos/owner/repo/pulls/55 --jq .title, .state, .user.loginrepos/owner/repo/pulls/55是 GitHub REST API 的路径无需域名gh api自动拼接https://api.github.com。--jq使用 jq 表达式对 JSON 响应做过滤这里取出了 PR 的标题、状态与发起人登录名三个字段。JSON 结构化输出与 jq 过滤大部分gh子命令都支持--json输出结构化数据配合--jq可做到按需取字段gh issue list --repo owner/repo --json number,title --jq .[] | \(.number): \(.title)这条命令将 Issue 列表转换为编号: 标题形式的紧凑文本既减少了上下文占用也便于 Agent 直接阅读。--json还可与--jq之外的--template组合使用gh内置 Go template 渲染Skill 中给出的--jq是最通用的默认选择。小贴士gh api支持完整的 GitHub REST API 路径包括 issues、pulls、actions、repos、users 等资源当某个查询如跨仓库统计、自定义搜索在gh issue/pr/run子命令中没有对应参数时优先尝试gh api--jq组合。Skill 如何被 VikingBot 加载与使用githubSkill 能生效依赖 VikingBot 的SkillsLoaderbot/vikingbot/agent/skills.py完成加载、校验与注入。其工作流程可概括为发现list_skills遍历工作区skills/目录每个子目录视为一个 Skill要求目录内存在SKILL.md。解析get_skill_metadata用 PyYAML 解析 frontmatter_get_skill_meta进一步提取metadata.vikingbot作用域字段含requires、install、emoji、always等。校验_check_requirements依据requires.bins/requires.env判定可用性build_skills_summary生成 XML 形式的技能总结不可用的 Skill 会带上缺失依赖描述。注入load_skills_for_context剥离 frontmatter 后将 Skill 正文以### Skill: github形式拼入 Agent 上下文。在 Agent 上下文组装环节bot/vikingbot/agent/context.py实现了渐进式加载策略标记always: true的 Skill 会通过get_always_skillsload_skills_for_context全量注入# Active Skills段其余可用 Skill 仅注入 XML 总结# Skills段的 Local Skills 部分并提示 Agent“用 read_file 工具读取本地 SKILL.md 全文”。这样githubSkill 平时只占一个skill条目名称、描述、路径、可用性只有当 Agent 决定处理 GitHub 任务时才按需读取全文既控制了上下文 token 开销又保证了能力随时可取。该机制同样适用于 OpenViking 侧的远程 Skill通过openviking_multi_read按需读取见同一文件中的 OpenViking Skills 段。沙箱与 Compile 场景中的 Skill 复用同一套SkillsLoader也被 VikingBot 的编译Compile管线复用在 bot/vikingbot/compile/service.py 中编译任务会将选定 Skill 物化到独立工作区再以SkillsLoader(workspace, builtin_skills_dirworkspace / __none__)加载其内容随后调用_check_requirements校验依赖是否被沙箱能力覆盖。这说明包括github在内的 Skill 不仅能在交互对话中生效也适用于自动化编译场景依赖声明requires.bins在其中扮演了“前置条件守卫”的角色。实战演练复现 Skill 的完整命令集以下是一个端到端演练假设工作目录为任意非 git 目录目标仓库为owner/repo示例编号、run-id 请按实际替换# 1) 确认 gh 可用 gh --version # 2) 检查 PR #55 的 CI 状态 gh pr checks 55 --repo owner/repo # 3) 列出最近 10 次工作流运行找到目标 run-id gh run list --repo owner/repo --limit 10 # 4) 查看该 run 的整体与失败步骤 gh run view run-id --repo owner/repo # 5) 仅输出失败步骤日志 gh run view run-id --repo owner/repo --log-failed # 6) 通过 API 取 PR 关键字段 gh api repos/owner/repo/pulls/55 --jq .title, .state, .user.login # 7) 结构化列出 Issue 编号与标题 gh issue list --repo owner/repo --json number,title \ --jq .[] | \(.number): \(.title)各命令的参数语义汇总如下命令关键参数作用gh pr checks number--repo owner/repo查看 PR 全部 CI 检查状态gh run list--repo、--limit N列出最近 N 次工作流运行gh run view run-id--repo查看运行详情与失败步骤gh run view run-id --log-failed--repo只输出失败步骤日志gh api rest-path--jq expr调用 REST API 并过滤响应gh issue list--repo、--json f1,f2、--jq结构化输出 Issue 列表小结githubSkill 是 VikingBot 在“Agent 协作开发”方向上的轻量而完整的范式以ghCLI 为单一事实源通过--repo参数保证命令在任意目录下的可复现性通过--json/--jq保证输出的结构化与低 token 消耗而requires.bins依赖声明与SkillsLoader的渐进式加载机制则让该能力在本地对话、沙箱执行与 Compile 自动化场景中都能按需、可靠地生效。掌握本文的命令集与机制后你可以让 VikingBot Agent 自主完成“查 PR 状态 → 定位 CI 失败 → 提取失败日志 → 按需查询仓库数据”的完整开发闭环。【免费下载链接】OpenVikingSelf-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.项目地址: https://gitcode.com/GitHub_Trending/op/OpenViking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考