拓冰网站定制 
pstack原则12修复根因给AI Agent的5 Whys调试法【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack是一套为 AI Agent 打造的技能栈支持 Claude Code、Codex、Pi 等工具其中修复根因Fix Root Causes是它 27 条工程原则中专门治理调试行为的一条先复现、再连环追问为什么、在根因处下刀而不是打补丁。本文带你用5 Whys的思路看懂这条原则如何让 AI Agent 修 Bug 时不再头痛医头。为什么修症状对 AI Agent 特别危险人类程序员修错地方往往是因为没耐心而 AI Agent 打补丁是因为补丁太容易了。加一个判空、塞一个try/catch、写一段 workaround 注释几秒钟就能让测试变绿——但真正的 Bug 还留在原地。pstack 在 principle-fix-root-causes/SKILL.md 中开宗明义症状式的修复会不断累积。每一个 workaround 都让系统更难推理而真正的 Bug 依然存在。根因修复前期更慢但总调试时间更短。对 AI Agent 来说这条原则的价值是双重的既约束它别糊弄也帮你少返工——因为 Agent 糊上去的补丁迟早会在下一个需求里反噬。5 Whys 实战六步把 Agent 钉在根因上经典的5 Whys调试法就是不断追问为什么直到挖到最底层的原因。pstack 把它翻译成 Agent 可直接执行的六步模式完整规则见 SKILL.md步骤做法一句话提醒1️⃣ 先复现Reproduce first复现不了的问题修了等于没修2️⃣ 连环追问Ask why until you hit the root cause别在第一层解释就收工3️⃣ 禁止加护栏Do not add guards给崩溃加判空就是症状修复4️⃣ 注释是警报一段话注释才能解释的 workaround错的是代码不是注释5️⃣ 看模式不看个案grep 同样的模式一次修完所有实例修一个漏点可能还有九个6️⃣ 卡住就插探针Instrument. Dont guess加日志、读真实报错禁止玄学猜测第 3 步值得单独展开给崩溃加一个 nil check 让程序不崩是症状修复。pstack 的判断很犀利——护栏只是把程序崩溃换成了数据静默出错而且下次换条路径它还会以别的姿势再崩一次。重启类 Bug先怀疑状态再怀疑代码这条原则里有一个非常实用的经验规则重启后失效的问题先怀疑过期的持久状态。配置文件、缓存、锁文件、序列化状态——这些隐形记忆经常是重启 Bug 的真凶。pstack 的建议是如果清掉某个状态文件后行为恢复正常那么状态校验而不是改业务代码才是修复的正解。对新手来说这招特别好用下次遇到重启就好了 / 重启就坏了让 Agent 先列出所有持久化状态文件逐个清空验证往往十分钟就比改半天代码更接近真相。在 pstack 里如何触发这套调试法你不需要死记这些原则——pstack 的设计就是你说目标它自己调用正确的工作流总入口poteto-mode 技能。把 Bug 描述给它例如修复翻页时搜索条件被重置的问题它会走 Bug fix 剧本自己复现 → 二分定位成因 → 修复 → 在同一环境验证 → 把失败的复现用例先提交、修复再提交形成可验证的证据链。考古搭档why 技能负责回答这段代码当初为什么这么写它会让多个调查子代理并行翻查 Git 历史、Issue、文档、团队聊天、错误追踪等 7 类证据源再交给综合者输出带引用的结论——这正是连环问为什么需要的历史素材。配套原则修完一个实例后no-comments 要求删掉所有被点名的 workaroundprinciple-prove-it-works 则要求拿真实产物验证而不是编译通过就算完。简单说复现归 Bug fix 剧本追问归 5 Whys考古归 why验证归 Prove It Works——四件套各司其职Agent 的调试过程就有了完整的纪律约束。上手前的 3 个提醒别被测试通过骗了。Bug fix 剧本第 4 步明确要求原始复现用例必须从失败变通过不确定或换了一个环境验证都不算数——单元测试只证明分支行为不证明 Bug 不存在。根因修复前期更慢这是特性不是缺陷。原则 12 赌的是总时间省掉的每次返工远比多花的那 10 分钟值钱。把原则交给结构而不是靠自觉。pstack 整套技能栈见 README.md的本质就是把这些人类要靠经验才做到的事写成 Agent 每次都会执行的流程。关键文件速查原则 12 原文plugins/pstack/skills/principle-fix-root-causes/SKILL.md总调度技能plugins/pstack/skills/poteto-mode/SKILL.mdBug 修复剧本plugins/pstack/skills/poteto-mode/playbooks/bug-fix.md代码考古技能plugins/pstack/skills/why/SKILL.md项目总览README.md把5 Whys装进 AI Agent得到的不是一个会问问题的助手而是一个拒绝糊弄的调试者。下一次当你看到 Agent 又想去加一个保险的时候让它先把这条原则读一遍。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 pstack原则12修复根因：给AI Agent的5 Whys调试法
pstack原则12修复根因给AI Agent的5 Whys调试法【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack是一套为 AI Agent 打造的技能栈支持 Claude Code、Codex、Pi 等工具其中修复根因Fix Root Causes是它 27 条工程原则中专门治理调试行为的一条先复现、再连环追问为什么、在根因处下刀而不是打补丁。本文带你用5 Whys的思路看懂这条原则如何让 AI Agent 修 Bug 时不再头痛医头。为什么修症状对 AI Agent 特别危险人类程序员修错地方往往是因为没耐心而 AI Agent 打补丁是因为补丁太容易了。加一个判空、塞一个try/catch、写一段 workaround 注释几秒钟就能让测试变绿——但真正的 Bug 还留在原地。pstack 在 principle-fix-root-causes/SKILL.md 中开宗明义症状式的修复会不断累积。每一个 workaround 都让系统更难推理而真正的 Bug 依然存在。根因修复前期更慢但总调试时间更短。对 AI Agent 来说这条原则的价值是双重的既约束它别糊弄也帮你少返工——因为 Agent 糊上去的补丁迟早会在下一个需求里反噬。5 Whys 实战六步把 Agent 钉在根因上经典的5 Whys调试法就是不断追问为什么直到挖到最底层的原因。pstack 把它翻译成 Agent 可直接执行的六步模式完整规则见 SKILL.md步骤做法一句话提醒1️⃣ 先复现Reproduce first复现不了的问题修了等于没修2️⃣ 连环追问Ask why until you hit the root cause别在第一层解释就收工3️⃣ 禁止加护栏Do not add guards给崩溃加判空就是症状修复4️⃣ 注释是警报一段话注释才能解释的 workaround错的是代码不是注释5️⃣ 看模式不看个案grep 同样的模式一次修完所有实例修一个漏点可能还有九个6️⃣ 卡住就插探针Instrument. Dont guess加日志、读真实报错禁止玄学猜测第 3 步值得单独展开给崩溃加一个 nil check 让程序不崩是症状修复。pstack 的判断很犀利——护栏只是把程序崩溃换成了数据静默出错而且下次换条路径它还会以别的姿势再崩一次。重启类 Bug先怀疑状态再怀疑代码这条原则里有一个非常实用的经验规则重启后失效的问题先怀疑过期的持久状态。配置文件、缓存、锁文件、序列化状态——这些隐形记忆经常是重启 Bug 的真凶。pstack 的建议是如果清掉某个状态文件后行为恢复正常那么状态校验而不是改业务代码才是修复的正解。对新手来说这招特别好用下次遇到重启就好了 / 重启就坏了让 Agent 先列出所有持久化状态文件逐个清空验证往往十分钟就比改半天代码更接近真相。在 pstack 里如何触发这套调试法你不需要死记这些原则——pstack 的设计就是你说目标它自己调用正确的工作流总入口poteto-mode 技能。把 Bug 描述给它例如修复翻页时搜索条件被重置的问题它会走 Bug fix 剧本自己复现 → 二分定位成因 → 修复 → 在同一环境验证 → 把失败的复现用例先提交、修复再提交形成可验证的证据链。考古搭档why 技能负责回答这段代码当初为什么这么写它会让多个调查子代理并行翻查 Git 历史、Issue、文档、团队聊天、错误追踪等 7 类证据源再交给综合者输出带引用的结论——这正是连环问为什么需要的历史素材。配套原则修完一个实例后no-comments 要求删掉所有被点名的 workaroundprinciple-prove-it-works 则要求拿真实产物验证而不是编译通过就算完。简单说复现归 Bug fix 剧本追问归 5 Whys考古归 why验证归 Prove It Works——四件套各司其职Agent 的调试过程就有了完整的纪律约束。上手前的 3 个提醒别被测试通过骗了。Bug fix 剧本第 4 步明确要求原始复现用例必须从失败变通过不确定或换了一个环境验证都不算数——单元测试只证明分支行为不证明 Bug 不存在。根因修复前期更慢这是特性不是缺陷。原则 12 赌的是总时间省掉的每次返工远比多花的那 10 分钟值钱。把原则交给结构而不是靠自觉。pstack 整套技能栈见 README.md的本质就是把这些人类要靠经验才做到的事写成 Agent 每次都会执行的流程。关键文件速查原则 12 原文plugins/pstack/skills/principle-fix-root-causes/SKILL.md总调度技能plugins/pstack/skills/poteto-mode/SKILL.mdBug 修复剧本plugins/pstack/skills/poteto-mode/playbooks/bug-fix.md代码考古技能plugins/pstack/skills/why/SKILL.md项目总览README.md把5 Whys装进 AI Agent得到的不是一个会问问题的助手而是一个拒绝糊弄的调试者。下一次当你看到 Agent 又想去加一个保险的时候让它先把这条原则读一遍。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考