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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/gh-cli-search/raw/index.md(查看排版版本)