关于 report-regressions
report-regressions 是用于根据冻结范围、证据索引和封存阶段包生成已验证活动报告的技能。它区分已确认发现与未解决事项,并在验证失败时标记阻塞。
主要功能
- 01核对活动范围与索引
- 02生成 HTML、Markdown 和 JSON 报告
- 03保留裁定结果与评级
- 04封存报告产物及验证状态
适用场景
- 01汇总回归活动发现
- 02标出覆盖缺口和未解决声明
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ trailofbits/ skills --skill report-regressions安装后在 Claude Code 中输入/report-regressions确认已加载。
详细介绍
报告一项活动
适用场景
输入:冻结的 scope.json、活动索引、进度台账、已封存的阶段包
和注册表分配结果。
报告前,对每项范围内的变更,都应遵循项目指南。
不适用场景
证据裁定或记录修复;将这些需求交还给调用方。
报告
- 阅读标准、 标签和 文件约定。根据冻结范围、已分配的变更和发现的候选项核对索引。保留 PR/提交 ID 和已接受的重复项映射。
- 使用
uv run --no-project运行 report.py,传入活动目录和--output ASSIGNED_DIRECTORY/reports,生成 HTML、Markdown 和 JSON。退出码 1 表示证据已变更或索引无效;返回诊断信息,并将阶段记录为受阻。退出码 0 仍可能包含UNRESOLVED发现项;报告每项的unresolved_reason,以及已确认发现项的verification级别。切勿修复裁定结果、编造证据或修改哈希以通过验证。 - 检查数量和链接。保留已裁定的结果/评级。将不完整的修复、潜伏/预先存在的漏洞、被驳回的主张和未解决的工作与已确认总数分开。
- 确保报告涵盖覆盖缺口、设置/执行证据、评级理由和待人工审核事项。报告缺失的信息;必要内容缺失时,不得声称已完成。
将
report-stage.json与已分配的输入及生成的报告一同封存为制品; 将验证失败记录为受阻。
返回报告
详细发现保留在报告中。仅返回:
- 状态:报告生成的
complete或blocked。 - 报告:已封存的
report-stage.json和通过验证的输出路径;注明未完成的输出。 - 结果:用一句话说明活动覆盖范围和未解决的工作。
- 阻塞项:受影响的记录、验证错误或调用方必须采取的操作。
完整的报告可以描述一项尚未完成的活动。
应驳回的合理化说辞
- “所有 Agent 都已完成”:这并不能证明覆盖充分或候选项已解决。
评论
支持 Markdown