SuperAPI AI 工具集

qodo-get-rules

编程与开发

查看项目

更新于 10-16 04:54

技能介绍

用途:在编码、规划、重构或代码审查中,检索工作区内与当前任务最相关的 Qodo 编码规则并加以应用。规则检索为语义检索,返回质量取决于查询写法。

前提条件:需安装并显式加载可选的 Qodo Standards 包;需有已连接的 QAR managed-tools MCP 服务器,或已认证的 Qodo CLI 暴露规则搜索;任务需足够具体以形成语义查询。该技能要求 Qodo CLI 1.6.0 或更新版本。

主要能力:通过 MCP 的 rules-search 工具或 CLI 的 qodo read rules search 检索规则,按 top_k 与可选 scopes 返回,再按规则 id 合并去重。查询须为三行结构(Name、Category、Content),并生成主题查询与横切查询各一条;Category 取 Security、Correctness、Quality、Reliability、Performance、Testability、Compliance、Accessibility、Observability、Architecture 之一。

使用方式:先运行版本探针 qodo --version;随后可用 qodo read whoami 确认身份、qodo read rules search 检索规则。示例命令:qodo read rules search --query "Name: JWT Authentication Endpoint Validation\nCategory: Security\nContent: ..." --top-k 20 --scopes "/owner/repo/" --json。仓库范围可从 origin remote 解析路径并包裹为 /<path>/;无法解析则省略 --scopes(不得传空值)。Windows 需参考其 shell 指引,Git Bash 有作用域参数重写问题。

适用场景:编码前载入团队标准、重构、代码审查等需要组织规则约束的任务。

限制:rules search 只读,不改工作区状态;无结果属正常,不得视为错误;速率受限时等待重置或跳过并说明;禁止编造规则、标识或严重级别;MCP 与 CLI 路径不可静默混用或切换账号/租户;版本过旧或更新失败时停止,保持用户文件不变。缺失事实:具体价格、平台支持范围与效果数据暂未提供。