用途:该技能在代码生成或修改任务开始前,从 Qodo 平台 API 拉取仓库相关的编码规则,涵盖安全要求、编码标准、质量准则和团队约定,供后续代码任务遵循。用户要求编写、编辑、重构或审查代码,或开始实现规划时调用;若对话上下文中已出现“Qodo Rules Loaded”则跳过。
主要能力:按 git 远程地址与工作目录确定作用范围,范围层级包括 Universal、Org 级、Repo 级和 Path 级;支持分页抓取(每页 50 条,最多 100 页),累积全部规则;按严重程度分组输出(ERROR、WARNING、RECOMMENDATION);生成后用同一 request-id 关联同一次规则加载的所有请求。
使用方式:先检查规则是否已加载;验证当前目录位于 git 仓库内并解析远程 URL,若在 modules/* 子目录则使用模块级范围,否则用仓库范围;检查 ~/.qodo/config.json 中的 API_KEY 和 ENVIRONMENT_NAME(环境变量 QODO_ENVIRONMENT_NAME 优先),可用 uuidgen 或 python3 -c "import uuid; print(uuid.uuid4())" 生成 request-id;分页抓取规则,输出带“📋 Qodo Rules Loaded”标题及仓库范围、范围上下文和规则总数;ERROR 规则必须遵守并在代码中添加合规注释,WARNING 默认遵守,RECOMMENDATION 视情况采纳;结束后报告规则应用情况。
适用场景:需要团队统一规范约束的代码生成、编辑、重构、审查,以及实现规划启动阶段。
限制:必须在 git 仓库内运行,否则需告知用户并优雅退出,不进行代码生成;需要 API 密钥,缺失时提供配置指引并以 QODO_API_KEY 或 ~/.qodo/config.json 设置;无远程地址时静默退出;URL 无法解析时告知用户;无规则时告知用户可在 app.qodo.ai 配置。其余价格、平台支持等细节暂未提供。