用途:为特定编码任务从 Qodo 拉取最相关的编码规则,只加载与任务匹配的规则,而非全部规则。适用于已有明确编码任务、希望获得定向且按相关度排序规则的场景;若上下文已出现“Qodo Rules Loaded”则跳过。
主要能力与用法:先确认未加载规则,再校验当前目录位于 git 仓库内,并检查 Qodo 配置(默认 ~/.qodo/config.json,API_KEY 字段,环境变量 QODO_API_KEY 优先;ENVIRONMENT_NAME 决定环境,环境变量 QODO_ENVIRONMENT_NAME 优先,缺省为 production;可选 QODO_API_URL 覆盖,存在时以 {QODO_API_URL}/rules/v1 为基址并忽略 ENVIRONMENT_NAME)。随后生成两条结构化查询,格式固定为三行:Name、Category(Security、Correctness、Quality、Reliability、Performance、Testability、Compliance、Accessibility、Observability、Architecture)、Content。Query 1 聚焦任务主要关注点,Query 2 覆盖跨领域质量与标准模式。不要用关键词列表或平铺句子形式。每条查询调用一次 POST /rules/search,top_k=20,合并去重,主题查询结果优先,最终上限 15-20 条(超过 20 截断为 20)。支持并行执行时并行调用两条查询。最后输出“📋 Qodo Rules Loaded”标题、搜索查询与规则总数,按返回顺序列出每条规则名称、严重级别与内容,并以 --- 结尾;无结果时输出“No relevant rules found for this task. Proceeding without rule constraints.”属正常,不应报错。
适用场景:有具体编码任务、需要按相关度排序的定向规则时。
限制:需 git 仓库与 Qodo API 密钥,缺失时应提示用户并优雅退出;需避免重复加载、查询过于宽泛或单查询,以及空结果时崩溃。配置与完整策略见 README.md。