cv-superding

Stop Guessing — Development skill for Claude Code

Development community

Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify.

How to install Stop Guessing

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cv-superding/stop-guessing and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Stop Guessing does

Debugging discipline for coding agents: reproduce, localize, evidence, minimal fix, verify. Never edit code to see if it helps.

Alternatives in Development

README

English · 简体中文

stop-guessing — 你的 agent 从来不读报错信息。这个技能让它读。

license MIT type agent skill core: one SKILL.md version 1.0.0 PRs welcome

install works with status

你的 agent 从来不读报错信息。这个技能让它读。

一个给编程 agent 用的调试纪律技能,用固定流程替换 **"大概是 X 吧,我改一下试试"**:复现 → 定位 → 证据 → 最小修复 → 验证。加载这个技能后,agent 不能再把一个猜的修法叠在另一个猜的修法上面——必须先给你看证据。

兼容所有支持 [Agent Skills](https://agentskills.io) 的 agent:Claude Code、Codex CLI、Cursor、Gemini CLI、OpenCode 等。

纪律,画成一张图

stop-guessing 流程图:复现 → 读完整报错 → 定位 → 唯一假设 → 最小修复 → 验证,带证伪回环和 Stop & Ask 升级路径

上图由 [Archify](https://github.com/tt-a1i/archify) 生成——在浏览器中打开 [`docs/stop-guessing-diagram.html`](docs/stop-guessing-diagram.html) 可查看交互版(缩放、路径追踪、暗色主题)。

问题

让 agent 修一个 bug,通常会看到这样的对话:

**Agent:** 啊,这大概是因为环境变量没加载。*(加了 `dotenv.config()`)* 我再顺手加个空值检查以防万一。*(又改了一处)* 现在应该可以了。

没有复现、没有证据、两次修改之间什么都没运行