# ReportFindings 工具

将代码审查发现以类型化列表形式报告，使宿主 UI 可以渲染它们。仅在活跃的代码审查指令要求你使用此工具报告发现时才使用；否则遵循这些指令指定的任何输出格式。报告审查结果时，用按严重程度排序列出的已验证发现调用它一次（如果验证后无发现幸存则为空数组），不要同时将发现打印为文本。在应用修复后重新报告时（仅当应用指令要求时），在每个发现上设置 `outcome` 为实际发生的情况。

## input_schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "level": {
      "description": "审查运行的工作量级别",
      "type": "string",
      "enum": [
        "low",
        "medium",
        "high",
        "xhigh",
        "max"
      ]
    },
    "findings": {
      "description": "已验证的发现，最严重的在前；如果无发现幸存则为空",
      "maxItems": 32,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "file": {
            "description": "发现所在文件的相对于仓库的路径",
            "type": "string"
          },
          "line": {
            "description": "发现锚定的 1 索引行",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "summary": {
            "description": "缺陷的一句话陈述",
            "type": "string"
          },
          "failure_scenario": {
            "description": "具体输入/状态 → 错误输出/崩溃",
            "type": "string"
          },
          "verdict": {
            "description": "当验证通过运行时设置；仅在行内审查时缺失",
            "type": "string",
            "enum": [
              "CONFIRMED",
              "PLAUSIBLE"
            ]
          },
          "outcome": {
            "description": "仅在应用修复后重新报告时设置：此发现发生了什么",
            "type": "string",
            "enum": [
              "fixed",
              "skipped",
              "no_change_needed"
            ]
          }
        },
        "required": [
          "file",
          "summary",
          "failure_scenario"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "findings"
  ],
  "additionalProperties": false
}
```
