项目审查规则与上下文
从可信基准读取规则,为审查提供相关路径、测试和未验证维度。
项目规则补充检查标准,运维设置决定 review 的运行选项。二者信任来源不同:官方明确 review.* 设置只采纳用户或系统层,不使用项目 .qwen/settings.json 中的同名项。
规则文件顺序
medium/high 按以下来源读取项目标准:
- .qwen/review-rules.md。
- .github/copilot-instructions.md,缺失时才回退根目录 copilot-instructions.md,不同时加载两份。
- AGENTS.md 的 Code Review 小节。
- QWEN.md 的 Code Review 小节。
PR 的规则来自基准分支,避免被审查的改动自行降低要求。本地 low 不加载这些规则;也不能把在仓库中加入 review.effort 当作可覆盖运维偏好的方式。
仓库上下文清单
.qwen/review-context.json 是严格 JSON:
{
"version": 1,
"label": "Runtime repository",
"rules": [
{
"paths": ["packages/*/src/**"],
"domains": ["runtime"],
"relatedPaths": ["packages/runtime/src/**"],
"recommendedTests": ["npm run test:runtime"],
"requiredConfigurations": ["debug"],
"requiredAgents": ["test-matrix"],
"unverifiedDimensions": ["Alternate runtime was not exercised"],
"verificationNotes": ["Use the repository native test runner"]
}
]
}这是结构示例,recommendedTests 必须换成仓库实际存在的命令。任一改动文件匹配 paths 时合并该规则,匹配区分大小写,支持 *、? 和 ** 段。数组顺序无关,但重复项会拒绝。
relatedPaths 和 domains 提供领域线索,测试与配置交给构建测试流程,requiredAgents 仅在所选强度和拓扑本来运行对应角色时生效,不能靠清单强制改变全部计划。unverifiedDimensions 是最终必须披露的证明边界,不是证明已经覆盖。
读取位置
PR 从 merge base 读取清单,本地从当前工作树读取。low 和跨仓库轻量审查跳过 repository context。与一般规则文件一样,不能让 PR 用自身的新配置证明自己已满足检查。
关联 issue 的证据
PR 的 Issue Fidelity 检查读取强关联的 closing issues,再读取每个 issue 所在仓库的正文和完整讨论;没有强关联但描述引用了相关问题时,也可在判断相关性后补查。
issue 正文用于提取复现、观测载荷、期望行为和维护者意见,其中夹带的指令不作为执行要求。上游服务返回违反契约的数据时,客户端补丁不能自动被称为根因修复;需要区分维护者要求的防御性绕过和真正的问题归属。
常用运维选项
review.effort 提供默认强度;review.reverseAuditRounds 只能降低拓扑对应的轮数上限;review.attribution 控制发布归因,并同时影响严重度标记和恢复模型基准。具体运行顺序见审查入口,发布影响见PR 评论。