Skip to content
FunCoding

Search

Search docs, Skills and MCP

项目审查规则与上下文

从可信基准读取规则,为审查提供相关路径、测试和未验证维度。

This page has not been translated into English yet. The original Chinese version is shown below.

项目规则补充检查标准,运维设置决定 review 的运行选项。二者信任来源不同:官方明确 review.* 设置只采纳用户或系统层,不使用项目 .qwen/settings.json 中的同名项。

规则文件顺序

medium/high 按以下来源读取项目标准:

  1. .qwen/review-rules.md。
  2. .github/copilot-instructions.md,缺失时才回退根目录 copilot-instructions.md,不同时加载两份。
  3. AGENTS.md 的 Code Review 小节。
  4. 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 评论。