关于 evidence-gate
evidence-gate 是面向 Agent 和团队的工作流技能，要求在报告任务完成或就绪前提供针对该声明的证据。它列出验证步骤、常见状态声明的证据要求及报告格式。
主要功能
- 01针对声明的验证关卡
- 02状态声明证据矩阵
- 03检查命令输出和退出码
- 04结构化验证报告
- 05报告失败与阻碍
适用场景
- 01报告成功前验证测试或构建
- 02用原始复现检查修复
- 03提交前审查暂存改动
- 04为 PR 或交接整理证据
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/evidence-gate确认已加载。
详细介绍
证据门槛
先有证据，再报告状态。在当前轮次没有提供支持相应具体说法的证据之前，不要声称工作已完成、已修复、已通过、已就绪、已提交、已推送、已准备好创建 PR 或已准备好交接。
适用时机
- 声称任务已完成或已修复之前
- 提交或推送之前
- 创建或更新 PR 之前
- 将问题标记为可供审核或已完成之前
- 将工作交接给其他 Agent 或人员之前
- Agent、工具或 CI 任务报告成功之后
门槛
- 陈述你即将作出的说法。
- 找出能证明该说法的最小命令或检查。
- 运行完整命令，或检查所需产物。
- 阅读输出和退出码。
- 将结果与说法进行对照。
- 报告确切证据，或说明阻碍因素。
证据矩阵
| 说法 | 所需证据 |
|---|---|
| 测试通过 | 测试命令以 0 退出，且未报告任何失败 |
| Lint 检查通过 | Lint 命令以 0 退出，且未报告任何警告 |
| 类型检查／构建通过 | 类型检查／构建命令以 0 退出 |
| Bug 已修复 | 原始复现步骤或回归检查通过 |
| 满足需求 | 根据请求范围逐项检查，而不只是运行测试 |
| 已准备好提交 | 已审阅 git diff --cached，并完成相关检查 |
| 已准备好推送 | 已验证分支、提交和远程目标 |
| 已准备好创建 PR | 已验证命令、PR 标题和正文，以及差异范围 |
| 已准备好交接 | 当前状态、已更改文件和验证结果 |
报告格式
在最终回复或交接内容中使用以下结构：
Verification:
- `<command>`: passed
- `<command>`: failed — <reason>
Not run:
- `<command>` — <reason>
如果检查失败，不要淡化结果。说明失败情况和下一步操作。
反面做法
- 未运行检查就说“应该能通过”。
- 将一项检查通过视为所有检查都通过的证明。
- 不检查差异或输出，就相信工具或子 Agent 报告成功。
- 本地验证记录缺失时仍创建 PR。
- 仅因测试通过就将范围标记为已完成。
评论
支持 Markdown