GitHub仓库侦察优化技能Skill github-ops

---

名称: GitHub操作技能 描述: 使用GitHub CLI (gh)进行仓库侦察和操作的工作流程。通过使用结构化API查询而非盲目获取文件来优化令牌使用。 版本: 1.0.0 模型: sonnet 调用方式: 两者 用户可调用: 真 工具: [Bash, Read] 最佳实践:

• 在获取特定文件之前列出目录内容
• 使用–jq过滤JSON输出并减少令牌噪音
• 尽可能将多个检查合并为单个API调用 错误处理: 优雅 流式: 支持 验证: 假 上次验证时间: 2026-02-19T05:29:09.098Z

---

GitHub操作技能

提供使用gh api和gh search进行仓库侦察的结构化指导。

概述

仓库侦察经常失败，因为代理猜测文件路径或尝试盲目获取大文件。此技能通过使用GitHub CLI执行结构化的映射 -> 识别 -> 获取序列来最小化令牌浪费并提高可靠性。

⚡ 基本侦察命令

使用这些命令在获取内容之前了解仓库结构。

1. 列出仓库根目录

gh api repos/{owner}/{repo}/contents --jq '.[].name'

2. 列出特定目录

gh api repos/{owner}/{repo}/contents/{path} --jq '.[].name'

3. 获取文件内容（Base64解码）

gh api repos/{owner}/{repo}/contents/{path} --jq '.content' | base64 -d

4. 在仓库中搜索模式

gh search code "{pattern}" --repo {owner}/{repo}

5. 获取仓库元数据

gh repo view {owner}/{repo} --json description,stargazerCount,updatedAt

🔄 令牌高效工作流程

1. 映射树: 列出根目录和核心目录（commands, src, docs）。
2. 识别入口点: 查找README.md, gemini-extension.json, package.json, 或SKILL.md。
3. 针对性获取: 首先只下载入口点。
4. 深入探索: 使用gh search code查找逻辑模式而非阅读每个文件。

🛡️ 平台安全（Windows）

• 当使用base64 -d时，如果输出很大，确保使用Write工具重定向到文件。
• 在复杂管道中避免使用Linux风格的/dev/stdin模式。
• 对任何本地存储使用原生路径。

分配的代理

• artifact-integrator: 仓库入职的领头代理。
• developer: PR管理和探索。

记忆协议（强制性）

开始前: 读取.claude/context/memory/learnings.md

完成后:

• 新模式 -> .claude/context/memory/learnings.md
• 发现的问题 -> .claude/context/memory/issues.md
• 做出的决策 -> .claude/context/memory/decisions.md

假设中断：如果不在记忆中，就没发生过。