用途
stop-me-check 用于对已经存在的代码仓库进行回溯扫描,找出那些如果当初运行 stop-me 就会被拦截的不可逆决策。它把 stop-me 的检查门反向应用到现有代码上,只报告会同时触发全部三道门的问题。
主要能力
该工具会读取仓库中的 .stop-me.yml 配置文件;如果不存在,则根据部署目标、租户列、贡献者数量等信息推断时间范围,并明确说明所采用的假设。它还会读取 DECISIONS.md,其中已记录的事项视为已定案,不再报告。
检查覆盖 stop-me 技能中定义的不可逆面,包括:
- migrations/:删除、重命名、类型收窄、缺少回滚路径
- 资金路径:扣费、退款、配额,以及是否存在幂等键和测试
- 密钥:受跟踪文件中的字面量,以及通过 git log -S 查找引入它们的提交
- 认证:密码哈希、令牌过期、写路径上的权限检查
- 多租户:缺少同级表所拥有的租户列的表
- 已发布形态:未版本化的端点、导出类型上的 any、CLI 标志
- 删除操作:没有恢复路径的 DELETE/drop/rm -rf
- 未采集数据:没有操作者或时间戳的事件和审计行
发现结果按影响范围排序,而非按数量排序。
使用方式
该技能通过 "/stop-me-check" 等指令触发,对指定仓库执行扫描。输出格式为:
stop-me check · <repo> · horizon: <h> (<inferred|from .stop-me.yml>)
<n> findings on irreversible surfaces
🛑 <file:line> — <one line>
[evidence] <what you actually read>
[cost] <what undoing this now requires>
...
Clean: <surfaces you checked and found nothing on>
每次输出都以 Clean 行结尾,列出已检查且未发现问题的面,以增强上方发现结果的可信度。
适用场景
适合在接手遗留项目、进行代码审计、上线前复核或评估技术债务时使用,帮助团队识别那些难以回滚的决策,并了解撤销它们所需的成本。
限制
每条发现都必须引用 file:line,没有引用就不算发现。只报告代码实际做了什么,不推测作者意图。可逆问题不算发现,例如慢查询、命名不佳、内部函数缺少类型等都不会报告。零发现是有效结果,此时打印 Clean 行并停止,不做填充。