gh-cli-search

让Claude正确使用GitHub CLI进行高效搜索的插件

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:gh-cli-search。
它的用途是:让Claude正确使用GitHub CLI进行高效搜索的插件
完整的 Skill 内容见:https://321skill.com/skills/gh-cli-search/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我找一下我们组织里所有包含TODO注释的JavaScript文件。',它会调用`/gh-search-code`技能,引导你输入组织名和语言,最终生成如`gh search code "TODO" --owner myorg --language javascript`的正确命令。或者,你可以直接说:'有哪些等待我评审的PR?',它会使用`/gh-search-prs`生成`gh search prs --review-requested @me --state open`命令来查找。

介绍

这个Skill解决了开发者在Claude中直接使用GitHub CLI(gh)进行搜索时,容易因语法错误、平台差异或参数格式问题导致命令失败或结果不准确的痛点。它通过提供一系列预定义的搜索技能和Slash命令,将复杂的搜索语法封装成易于调用的指令,并自动处理跨平台(如Unix/Linux/macOS与PowerShell)的语法差异。

使用时,开发者只需在Claude会话中调用对应的Slash命令(如/gh-search-code),并按照提示输入关键词、语言、仓库等条件,Skill便会生成语法正确、可直接执行的gh命令。它还包含一个Session-Start Hook,在会话开始时自动加载,确保Claude从一开始就具备构造正确命令的能力。

该Skill非常适合需要频繁在GitHub上查找代码、问题、PR、提交记录或仓库的开发者、技术文档工程师和项目管理者。它降低了使用高级搜索功能的门槛,让用户能更专注于搜索意图而非命令细节。

建议在使用前确保已安装并认证GitHub CLI。对于复杂的多条件查询,注意使用--标志来分隔选项和查询词(在Unix/Linux/macOS上),或在PowerShell中使用--%。查询包含空格的关键词时务必使用引号。

核心特点

与仅提供简单命令示例的Skill不同,它深度集成了GitHub CLI搜索的全部高级语法,并专门处理了跨平台命令行参数解析的棘手问题(如Unix的`--`与PowerShell的`--%`),确保生成的命令在任何终端都能正确执行。

注意事项

不适合未安装或未认证GitHub CLI的用户,也无法替代需要复杂图形化交互或深度代码分析的场景。

常见问题

如何在PowerShell里使用这个Skill?

在PowerShell中运行生成的命令时,需要在`gh`后添加`--%`以正确传递参数,例如:`gh --% search issues -- "is:open author:@me"`。

搜索时如何排除某个标签?

在Unix/Linux/macOS上,使用`--`标志将查询词与命令选项分隔,例如:`gh search issues -- "-label:bug"`。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/gh-cli-search/raw/index.md 读取 gh-cli-search 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。