@akuzmenko/rgk
带LLM自然语言过滤的ripgrep增强版
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@akuzmenko/rgk。 它的用途是：带LLM自然语言过滤的ripgrep增强版 完整的 Skill 内容见：https://321skill.com/skills/akuzmenko-rgk/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用rgk搜索项目中所有`fetch`调用，并过滤出那些没有设置超时时间的，按风险从高到低排序'，它会执行`rgk "fetch" src --keep "network calls without timeout"`，然后返回结果。或者：'在代码库中找出所有可能暴露敏感信息的TODO注释'，它会执行`rgk "TODO" --keep "security-sensitive follow-up"`。
介绍
这个Skill解决了传统grep/ripgrep搜索后结果过多、需要人工逐条筛选的问题。在实际开发中，开发者经常需要从大量匹配行中找出真正相关的代码或文本，比如搜索所有TODO注释后只保留安全敏感项，或查找网络请求代码时只过滤出缺少超时处理的调用。手动过滤既耗时又容易遗漏，而rgk通过LLM自动完成这一步骤，大幅提升效率。
使用方式很简单，你只需要在原有的rg命令后加上--keep参数，并用自然语言描述过滤条件即可。例如：rgk "TODO" --keep "security-sensitive follow-up"，它会先用ripgrep快速搜索所有TODO，然后通过Codex模型筛选出安全相关的待办项，并按相关性排序输出。如果不加--keep，则完全等同于原生rg命令。输出格式统一为path:line:column:compact matched text，便于脚本和AI代理解析。
它非常适合需要频繁进行代码搜索的开发者，尤其是那些已经熟悉ripgrep并希望进一步提效的团队或个人。也适合AI编码代理在自动探索代码库时使用，通过自然语言指令快速定位相关代码片段，减少返回给AI的上下文噪音。对于进行代码审计、安全扫描、配置审查等场景，rgk能帮助快速找出真正有风险的行。
建议在代码搜索和探索阶段统一使用rgk替代原生rg，只在需要全量匹配（如重构编辑）时回退到原生rg。需要注意的是，它主要依赖Cloud Codex API，涉及代码隐私时建议先缩小rg搜索范围再使用--keep过滤。同时需要Node.js 24+、rg和codex命令行工具已安装并认证。
常见问题
rgk和rg有什么区别？
rgk是rg的超集，增加了`--keep`参数，支持用自然语言过滤和排序匹配结果，不加`--keep`时完全等同于rg。
如何配置使用的Codex模型？
通过环境变量`RGK_MODEL`设置，默认`gpt-5.4-mini`，也可通过`RGK_REASONING_EFFORT`等变量调整推理参数。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/akuzmenko-rgk/raw/index.md 读取 @akuzmenko/rgk 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/akuzmenko-rgk/raw/index.md（查看排版版本）