{"id":"07a001d1-605b-458b-9566-6fb9875f4be0","shortId":"nEN3xP","kind":"skill","title":"verification-before-completion","tagline":"在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言","description":"# 完成前验证\n\n## 概述\n\n在没有验证的情况下宣称工作完成，这不是高效，而是不诚实。\n\n**核心原则：** 始终用证据支撑结论。\n\n**对这条规则敷衍了事，就等于违背了它的精神。**\n\n## 铁律\n\n```\n没有新鲜的验证证据，不许宣称完成\n```\n\n如果你在这条消息中没有运行验证命令，就不能声称测试通过。\n\n## 门控函数\n\n```\n在宣称任何状态或表达满意之前：\n\n1. 确定：什么命令能证明这个结论？\n2. 运行：执行完整命令（重新运行，完整执行）\n3. 阅读：完整输出，检查退出码，统计失败数\n4. 验证：输出是否支持这个结论？\n   - 如果否：用证据说明实际状态\n   - 如果是：带证据陈述结论\n5. 只有这时：才能做出结论\n\n跳过任何一步 = 说谎，不是验证\n```\n\n## 常见失败模式\n\n| 结论 | 需要 | 不够格 |\n|------|------|--------|\n| 测试通过 | 测试命令输出：0 failures | 之前的运行结果、\"应该会通过\" |\n| Linter 无报错 | Linter 输出：0 errors | 部分检查、推断 |\n| 构建成功 | 构建命令：exit 0 | linter 通过、日志看起来没问题 |\n| Bug 已修复 | 测试原始症状：通过 | 代码改了，假设已修复 |\n| 回归测试有效 | 红-绿循环已验证 | 测试只通过了一次 |\n| 代理已完成 | VCS diff 显示变更 | 代理报告\"成功\" |\n| 需求已满足 | 逐项核对清单 | 测试通过 |\n\n## 红线——停下来\n\n- 使用\"应该\"、\"大概\"、\"似乎\"\n- 验证前就表达满意（\"太好了！\"、\"完美！\"、\"搞定！\"等）\n- 即将提交/推送/创建 PR 却没有验证\n- 信任代理的成功报告\n- 依赖部分验证\n- 想着\"就这一次\"\n- 累了想赶紧收工\n- **任何暗示成功但实际未运行验证的措辞**\n\n## 防止合理化\n\n| 借口 | 现实 |\n|------|------|\n| \"应该能行了\" | 运行验证命令 |\n| \"我有信心\" | 信心 ≠ 证据 |\n| \"就这一次\" | 没有例外 |\n| \"Linter 通过了\" | Linter ≠ 编译器 |\n| \"代理说成功了\" | 独立验证 |\n| \"我累了\" | 疲劳 ≠ 借口 |\n| \"部分检查就够了\" | 部分检查什么也证明不了 |\n| \"换个说法这条规则就不适用了\" | 精神大于字面 |\n\n## 关键模式\n\n**测试：**\n```\n✅ [运行测试命令] [看到：34/34 pass] \"全部测试通过\"\n❌ \"应该能通过了\" / \"看起来对了\"\n```\n\n**回归测试（TDD 红-绿）：**\n```\n✅ 编写 → 运行（通过）→ 回退修复 → 运行（必须失败）→ 恢复 → 运行（通过）\n❌ \"我写了回归测试\"（没有经过红-绿验证）\n```\n\n**构建：**\n```\n✅ [运行构建] [看到：exit 0] \"构建通过\"\n❌ \"Linter 通过了\"（linter 不检查编译）\n```\n\n**需求：**\n```\n✅ 重读计划 → 创建核对清单 → 逐项验证 → 报告缺口或完成\n❌ \"测试通过了，阶段完成\"\n```\n\n**代理委派：**\n```\n✅ 代理报告成功 → 检查 VCS diff → 验证变更 → 报告实际状态\n❌ 信任代理报告\n```\n\n## 为什么这很重要\n\n来自 24 次失败记录：\n- 搭档说\"我不信你\"——信任被破坏\n- 未定义的函数被交付——会直接崩溃\n- 遗漏需求被交付——功能不完整\n- 虚假完成浪费的时间 → 返工 → 重做\n- 违反原则：\"诚实是核心价值。如果你说谎，就会被替换。\"\n\n## 何时使用\n\n**以下情况之前必须使用：**\n- 任何形式的成功/完成声明\n- 任何满意的表达\n- 任何关于工作状态的正面陈述\n- 提交、创建 PR、标记任务完成\n- 进入下一个任务\n- 委派给代理\n\n**本规则适用于：**\n- 准确措辞\n- 同义词和换一种说法\n- 暗示成功\n- 任何传达完成/正确性的沟通\n\n## 底线\n\n**验证没有捷径。**\n\n运行命令。阅读输出。然后才能宣称结果。\n\n这没有商量余地。","tags":["verification","before","completion","superpowers","jnmetacode","agent-skills","agentic-coding","ai-coding","chinese","claude-code","code-review","cursor"],"capabilities":["skill","source-jnmetacode","skill-verification-before-completion","topic-agent-skills","topic-agentic-coding","topic-ai-coding","topic-chinese","topic-claude-code","topic-code-review","topic-cursor","topic-gemini-cli","topic-kiro","topic-mcp","topic-npm-package","topic-prompt-engineering"],"categories":["superpowers-zh"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/jnMetaCode/superpowers-zh/verification-before-completion","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add jnMetaCode/superpowers-zh","source_repo":"https://github.com/jnMetaCode/superpowers-zh","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 1850 github stars · SKILL.md body (1,775 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-02T18:52:41.148Z","embedding":null,"createdAt":"2026-04-18T21:56:03.520Z","updatedAt":"2026-05-02T18:52:41.148Z","lastSeenAt":"2026-05-02T18:52:41.148Z","tsv":"'0':60,68,75,175 '1':28 '2':31 '24':198 '3':36 '34/34':148 '4':41 '5':48 'bug':79 'complet':4 'diff':92,192 'error':69 'exit':74,174 'failur':61 'linter':64,66,76,131,133,177,179 'pass':149 'pr':8,113,222 'skill' 'skill-verification-before-completion' 'source-jnmetacode' 'tdd':154 'topic-agent-skills' 'topic-agentic-coding' 'topic-ai-coding' 'topic-chinese' 'topic-claude-code' 'topic-code-review' 'topic-cursor' 'topic-gemini-cli' 'topic-kiro' 'topic-mcp' 'topic-npm-package' 'topic-prompt-engineering' 'vcs':91,191 'verif':2 'verification-before-complet':1 '不够格':57 '不是验证':53 '不检查编译':180 '不许宣称完成':23 '为什么这很重要':196 '之前':9 '之前的运行结果':62 '什么命令能证明这个结论':30 '代理委派':188 '代理已完成':90 '代理报告':94 '代理报告成功':189 '代理说成功了':135 '代码改了':83 '以下情况之前必须使用':215 '任何传达完成':230 '任何关于工作状态的正面陈述':219 '任何形式的成功':216 '任何暗示成功但实际未运行验证的措辞':120 '任何满意的表达':218 '会直接崩溃':204 '似乎':104 '何时使用':214 '使用':101 '依赖部分验证':116 '信任代理报告':195 '信任代理的成功报告':115 '信任被破坏':202 '信心':127 '借口':122,139 '假设已修复':84 '停下来':100 '全部测试通过':150 '关键模式':144 '准确措辞':227 '创建':112,221 '创建核对清单':183 '功能不完整':206 '即将提交':110 '却没有验证':114 '只有这时':49 '同义词和换一种说法':228 '回归测试':153 '回归测试有效':85 '回退修复':161 '在宣称任何状态或表达满意之前':27 '在宣称工作完成':5 '在提交或创建':7 '在没有验证的情况下宣称工作完成':14 '大概':103 '太好了':106 '如果你在这条消息中没有运行验证命令':24 '如果你说谎':212 '如果否':44 '如果是':46 '始终用证据支撑断言':11 '始终用证据支撑结论':18 '委派给代理':225 '完成前验证':12 '完成声明':217 '完整执行':35 '完整输出':38 '完美':107 '对这条规则敷衍了事':19 '就不能声称测试通过':25 '就会被替换':213 '就等于违背了它的精神':20 '就这一次':118,129 '已修复':80 '已修复或测试通过之前使用':6 '带证据陈述结论':47 '常见失败模式':54 '应该':102 '应该会通过':63 '应该能行了':124 '应该能通过了':151 '底线':232 '必须失败':163 '必须运行验证命令并确认输出后才能声称成功':10 '恢复':164 '想着':117 '成功':95 '我不信你':201 '我写了回归测试':167 '我有信心':126 '我累了':137 '才能做出结论':50 '执行完整命令':33 '报告实际状态':194 '报告缺口或完成':185 '换个说法这条规则就不适用了':142 '推断':71 '推送':111 '提交':220 '搞定':108 '搭档说':200 '无报错':65 '日志看起来没问题':78 '显示变更':93 '暗示成功':229 '未定义的函数被交付':203 '本规则适用于':226 '来自':197 '构建':171 '构建命令':73 '构建成功':72 '构建通过':176 '标记任务完成':223 '核心原则':17 '检查':190 '检查退出码':39 '概述':13 '次失败记录':199 '正确性的沟通':231 '没有例外':130 '没有新鲜的验证证据':22 '没有经过红':169 '没有经过红-绿验证':168 '测试':145 '测试原始症状':81 '测试只通过了一次':89 '测试命令输出':59 '测试通过':58,98 '测试通过了':186 '然后才能宣称结果':236 '独立验证':136 '现实':123 '用证据说明实际状态':45 '疲劳':138 '看到':147,173 '看起来对了':152 '确定':29 '等':109 '精神大于字面':143 '累了想赶紧收工':119 '红':87,156 '红-绿':155 '红-绿循环已验证':86 '红线':99 '结论':55 '统计失败数':40 '绿':157 '绿循环已验证':88 '绿验证':170 '编写':158 '编译器':134 '而是不诚实':16 '虚假完成浪费的时间':207 '证据':128 '诚实是核心价值':211 '说谎':52 '跳过任何一步':51 '输出':67 '输出是否支持这个结论':43 '运行':32,159,162,165 '运行命令':234 '运行构建':172 '运行测试命令':146 '运行验证命令':125 '返工':208 '这不是高效':15 '这没有商量余地':237 '进入下一个任务':224 '违反原则':210 '逐项核对清单':97 '逐项验证':184 '通过':77,82,160,166 '通过了':132,178 '遗漏需求被交付':205 '部分检查':70 '部分检查什么也证明不了':141 '部分检查就够了':140 '重做':209 '重新运行':34 '重读计划':182 '铁律':21 '门控函数':26 '阅读':37 '阅读输出':235 '防止合理化':121 '阶段完成':187 '需求':181 '需求已满足':96 '需要':56 '验证':42 '验证前就表达满意':105 '验证变更':193 '验证没有捷径':233","prices":[{"id":"f75c3367-7716-4a97-acd0-767aa6247c4d","listingId":"07a001d1-605b-458b-9566-6fb9875f4be0","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"jnMetaCode","category":"superpowers-zh","install_from":"skills.sh"},"createdAt":"2026-04-18T21:56:03.520Z"}],"sources":[{"listingId":"07a001d1-605b-458b-9566-6fb9875f4be0","source":"github","sourceId":"jnMetaCode/superpowers-zh/verification-before-completion","sourceUrl":"https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/verification-before-completion","isPrimary":false,"firstSeenAt":"2026-04-18T21:56:03.520Z","lastSeenAt":"2026-05-02T18:52:41.148Z"}],"details":{"listingId":"07a001d1-605b-458b-9566-6fb9875f4be0","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"jnMetaCode","slug":"verification-before-completion","github":{"repo":"jnMetaCode/superpowers-zh","stars":1850,"topics":["agent-skills","agentic-coding","ai-coding","chinese","claude-code","code-review","cursor","gemini-cli","kiro","mcp","npm-package","prompt-engineering","skills","superpowers","tdd","trae"],"license":"mit","html_url":"https://github.com/jnMetaCode/superpowers-zh","pushed_at":"2026-04-28T15:32:18Z","description":"🦸 AI 编程超能力 · 中文增强版 — superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills，让 Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI 等 16 款 AI 编程工具真正会干活","skill_md_sha":"f544566d1919f659c48341dfa68d0a075df8ff3e","skill_md_path":"skills/verification-before-completion/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/jnMetaCode/superpowers-zh/tree/main/skills/verification-before-completion"},"layout":"multi","source":"github","category":"superpowers-zh","frontmatter":{"name":"verification-before-completion","description":"在宣称工作完成、已修复或测试通过之前使用，在提交或创建 PR 之前——必须运行验证命令并确认输出后才能声称成功；始终用证据支撑断言"},"skills_sh_url":"https://skills.sh/jnMetaCode/superpowers-zh/verification-before-completion"},"updatedAt":"2026-05-02T18:52:41.148Z"}}