该技能是一套操作协议，用于约束 AI 在涉及 GitHub CLI（gh）搜索时的行为，目的是避免输出错误的搜索命令。资料明确说明：这不是建议，也不是可选项。
用途与背景 资料指出，GitHub CLI 搜索语法充满陷阱，包括：排除条件前必须使用的 -- 标志、引号规则、PowerShell 转义、不同平台之间的差异。若没有这些技能约束，模型“一定会出错”，用户会复制粘贴出错的命令并浪费时间调试。
强制触发条件 当用户消息提到以下任意情形时，必须使用 gh-cli-search 技能：
- 在 GitHub 上搜索
- 查找代码、issue、PR、commit、repo
- gh search 命令
- GitHub CLI 查询
- 安装/排查 gh CLI 检测到上述情形后，应使用 Skill 工具加载对应的 gh-cli-search 技能。
可用子技能 资料列出了以下技能：
- gh-search-code：跨仓库搜索代码
- gh-search-commits：搜索提交历史
- gh-search-issues：搜索 issue（及 PR）
- gh-search-prs：专门搜索 pull request
- gh-search-repos：搜索仓库
- gh-cli-setup：安装与排查 资料要求选择正确的技能、使用 Skill 工具并严格遵循其指引。
关于 -- 标志的说明 资料给出的最常见错误示例是：在带排除条件的查询前忘记 -- 标志。错误写法（资料标注为 BROKEN）：gh search issues "is:open -label:bug"，因为 shell 会把 -label 解释为标志。正确写法（资料标注为 CORRECT）：gh search issues -- "is:open -label:bug"。
跳过技能时的后果 资料描述了跳过技能时常见的失败链路：凭记忆构造命令、忘记排除条件的 -- 标志、引号使用错误、遗漏 PowerShell 的 --% 要求，用户复制命令后执行失败，被迫调试模型造成的错误，进而降低对回答的信任。资料还称使用技能约需 30 秒，而调试错误命令约需 10 分钟。
协议流程摘要 当用户提及 GitHub CLI 搜索时：
- 识别类型：code/commits/issues/PRs/repos/setup
- 使用 Skill 工具加载相应的 gh-search-* 技能
- 声明正在使用哪个技能
- 严格遵循该技能的指引
- 提供正确且经过测试的命令 当用户询问安装/排查时：使用 gh-cli-setup 技能，并遵循其安装与排查步骤。
资料还列举了若干“合理化借口”，并逐条标注为错误，例如“这只是简单查询”“我知道 gh CLI 语法”“我自己构造命令就行”“用户没有明确说 gh search”“我能很快搞清语法”“先不用技能试试”“这不需要完整技能处理”。资料称这些想法意味着即将失败。
技能编码的内容与限制 资料称这些技能编码了：何处需要 -- 标志、各平台精确的引号规则、PowerShell 转义序列、可用标志及其语法、常见陷阱及规避方式，并强调无法凭记忆复现。
其他信息 该技能为规范/协议性质，不是可执行的独立工具。关于收费、价格、支持平台、实际效果验证等信息，资料未提供。