From ff25e98cad3c4cac1a60d650737cd67fd71a5169 Mon Sep 17 00:00:00 2001 From: NightStar Date: Thu, 10 Sep 2026 16:50:58 +0800 Subject: [PATCH] [teamai] Push 1 resource(s) from root --- .../CONTRIBUTORS | 1 + .../verification-before-completion/SKILL.md | 144 ++++++++++++++++++ 2 files changed, 145 insertions(+) create mode 100644 skills/verification-before-completion/CONTRIBUTORS create mode 100644 skills/verification-before-completion/SKILL.md diff --git a/skills/verification-before-completion/CONTRIBUTORS b/skills/verification-before-completion/CONTRIBUTORS new file mode 100644 index 0000000..d8649da --- /dev/null +++ b/skills/verification-before-completion/CONTRIBUTORS @@ -0,0 +1 @@ +root diff --git a/skills/verification-before-completion/SKILL.md b/skills/verification-before-completion/SKILL.md new file mode 100644 index 0000000..4fa4153 --- /dev/null +++ b/skills/verification-before-completion/SKILL.md @@ -0,0 +1,144 @@ +--- +name: verification-before-completion +description: 在宣称工作完成、已修复或测试通过之前使用,在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功;始终用证据支撑断言 +version: "1.0.0" +license: MIT +metadata: + hermes: + tags: [quality, verification] +--- + +# 完成前验证 + +## 概述 + +在没有验证的情况下宣称工作完成,这不是高效,而是不诚实。 + +**核心原则:** 始终用证据支撑结论。 + +**对这条规则敷衍了事,就等于违背了它的精神。** + +## 铁律 + +``` +没有新鲜的验证证据,不许宣称完成 +``` + +如果你在这条消息中没有运行验证命令,就不能声称测试通过。 + +## 门控函数 + +``` +在宣称任何状态或表达满意之前: + +1. 确定:什么命令能证明这个结论? +2. 运行:执行完整命令(重新运行,完整执行) +3. 阅读:完整输出,检查退出码,统计失败数 +4. 验证:输出是否支持这个结论? + - 如果否:用证据说明实际状态 + - 如果是:带证据陈述结论 +5. 只有这时:才能做出结论 + +跳过任何一步 = 说谎,不是验证 +``` + +## 常见失败模式 + +| 结论 | 需要 | 不够格 | +|------|------|--------| +| 测试通过 | 测试命令输出:0 failures | 之前的运行结果、"应该会通过" | +| Linter 无报错 | Linter 输出:0 errors | 部分检查、推断 | +| 构建成功 | 构建命令:exit 0 | linter 通过、日志看起来没问题 | +| Bug 已修复 | 测试原始症状:通过 | 代码改了,假设已修复 | +| 回归测试有效 | 红-绿循环已验证 | 测试只通过了一次 | +| 代理已完成 | VCS diff 显示变更 | 代理报告"成功" | +| 需求已满足 | 逐项核对清单 | 测试通过 | + +## 红线——停下来 + +- 使用"应该"、"大概"、"似乎" +- 验证前就表达满意("太好了!"、"完美!"、"搞定!"等) +- 即将提交/推送/创建 PR 却没有验证 +- 信任代理的成功报告 +- 依赖部分验证 +- 想着"就这一次" +- 累了想赶紧收工 +- **任何暗示成功但实际未运行验证的措辞** + +## 防止合理化 + +| 借口 | 现实 | +|------|------| +| "应该能行了" | 运行验证命令 | +| "我有信心" | 信心 ≠ 证据 | +| "就这一次" | 没有例外 | +| "Linter 通过了" | Linter ≠ 编译器 | +| "代理说成功了" | 独立验证 | +| "我累了" | 疲劳 ≠ 借口 | +| "部分检查就够了" | 部分检查什么也证明不了 | +| "换个说法这条规则就不适用了" | 精神大于字面 | + +## 关键模式 + +**测试:** +``` +✅ [运行测试命令] [看到:34/34 pass] "全部测试通过" +❌ "应该能通过了" / "看起来对了" +``` + +**回归测试(TDD 红-绿):** +``` +✅ 编写 → 运行(通过)→ 回退修复 → 运行(必须失败)→ 恢复 → 运行(通过) +❌ "我写了回归测试"(没有经过红-绿验证) +``` + +**构建:** +``` +✅ [运行构建] [看到:exit 0] "构建通过" +❌ "Linter 通过了"(linter 不检查编译) +``` + +**需求:** +``` +✅ 重读计划 → 创建核对清单 → 逐项验证 → 报告缺口或完成 +❌ "测试通过了,阶段完成" +``` + +**代理委派:** +``` +✅ 代理报告成功 → 检查 VCS diff → 验证变更 → 报告实际状态 +❌ 信任代理报告 +``` + +## 为什么这很重要 + +来自 24 次失败记录: +- 搭档说"我不信你"——信任被破坏 +- 未定义的函数被交付——会直接崩溃 +- 遗漏需求被交付——功能不完整 +- 虚假完成浪费的时间 → 返工 → 重做 +- 违反原则:"诚实是核心价值。如果你说谎,就会被替换。" + +## 何时使用 + +**以下情况之前必须使用:** +- 任何形式的成功/完成声明 +- 任何满意的表达 +- 任何关于工作状态的正面陈述 +- 提交、创建 PR、标记任务完成 +- 进入下一个任务 +- 委派给代理 + +**本规则适用于:** +- 准确措辞 +- 同义词和换一种说法 +- 暗示成功 +- 任何传达完成/正确性的沟通 + +## 底线 + +**验证没有捷径。** + +运行命令。阅读输出。然后才能宣称结果。 + +这没有商量余地。