mcpField
R
report-regressions

report-regressions

github.com/trailofbits测试与质量7.9k163 次安装今天更新
代码仓库

关于 report-regressions

report-regressions 是用于根据冻结范围、证据索引和封存阶段包生成已验证活动报告的技能。它区分已确认发现与未解决事项,并在验证失败时标记阻塞。

主要功能

  1. 01核对活动范围与索引
  2. 02生成 HTML、Markdown 和 JSON 报告
  3. 03保留裁定结果与评级
  4. 04封存报告产物及验证状态

适用场景

  1. 01汇总回归活动发现
  2. 02标出覆盖缺口和未解决声明

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/trailofbits/skills --skill report-regressions

安装后在 Claude Code 中输入/report-regressions确认已加载。

详细介绍

报告一项活动

适用场景

输入:冻结的 scope.json、活动索引、进度台账、已封存的阶段包 和注册表分配结果。 报告前,对每项范围内的变更,都应遵循项目指南。

不适用场景

证据裁定或记录修复;将这些需求交还给调用方。

报告

  1. 阅读标准、 标签和 文件约定。根据冻结范围、已分配的变更和发现的候选项核对索引。保留 PR/提交 ID 和已接受的重复项映射。
  2. 使用 uv run --no-project 运行 report.py,传入活动目录和 --output ASSIGNED_DIRECTORY/reports,生成 HTML、Markdown 和 JSON。退出码 1 表示证据已变更或索引无效;返回诊断信息,并将阶段记录为受阻。退出码 0 仍可能包含 UNRESOLVED 发现项;报告每项的 unresolved_reason,以及已确认发现项的 verification 级别。切勿修复裁定结果、编造证据或修改哈希以通过验证。
  3. 检查数量和链接。保留已裁定的结果/评级。将不完整的修复、潜伏/预先存在的漏洞、被驳回的主张和未解决的工作与已确认总数分开。
  4. 确保报告涵盖覆盖缺口、设置/执行证据、评级理由和待人工审核事项。报告缺失的信息;必要内容缺失时,不得声称已完成。 将 report-stage.json 与已分配的输入及生成的报告一同封存为制品; 将验证失败记录为受阻。

返回报告

详细发现保留在报告中。仅返回:

  • 状态:报告生成的 complete 或 blocked。
  • 报告:已封存的 report-stage.json 和通过验证的输出路径;注明未完成的输出。
  • 结果:用一句话说明活动覆盖范围和未解决的工作。
  • 阻塞项:受影响的记录、验证错误或调用方必须采取的操作。

完整的报告可以描述一项尚未完成的活动。

应驳回的合理化说辞

  • “所有 Agent 都已完成”:这并不能证明覆盖充分或候选项已解决。

评论

支持 Markdown