whaojie797-design/change-proof

README 摘要

change-proof 让 Agent 在提交代码前，自动回答“改了什么、为什么安全、怎么验证、哪里仍有风险”。 Make any AI coding agent answer four questions before it commits: what changed, why it is safe, how to verify, and what risks remain. 一个跨平台、框架无关的 Agent Skill。把任意功能改动变成一份可审计的 变更证据包 （ CHANGE PROOF.md ），解决“代码看起来能跑，但无法证明可上线”的问题。 A cross-platform, framework-agnostic Agent Skill that turns any code change into an auditable change-proof package , solving the problem of “the code looks like it runs, but you can’t prove it’s ready to ship.” 适用宿主 / Works with: Codex · Claude Code · Cursor · Gemini CLI . 演示 / Demo 上图是动画占位 SVG，发布前请替换为真实的 30 秒 GIF。 The image above is an animated placeholder SVG. Replace it with a real 30-second GIF before publishing. 为什么需要 / Why 普通 AI 交付只给代码， 带证据交付 给的是“代码 + 证据 + 风险 + 回滚”。 普通 AI 交付 vs 带证据交付 / Plain delivery vs Evidence delivery 维度 普通 AI 交付 / Plain delivery 带证据交付（change-proof）/ Evidence delivery 改了什么 一段代码 + “已修改 xxx” 文件/接口/数据/配置/依赖 全量清单 为什么安全 “应该没问题” 五维风险评级（兼容/安全/性能/迁移/回滚） 怎么验证 “测试通过了” 验证矩阵：每项标注 通过/失败/未执行 + 命令证据 风险在哪 不提或藏起来 显式列出未验证项 + 人工复核清单 出事怎么办 没有 回滚命令 + 数据回滚步骤 可审计 ❌ ✅ 一份 CHANGE PROOF.md 留痕 红线 / Red line ：没有真正运行过的测试，状态必须写 未执行 ， 禁止伪造通过 。 Tests that were never actually run must be marked 未执行 (not executed…

分类