先理解代码
改代码前先理解它
Section titled “改代码前先理解它”改自己没看懂的代码，不易察觉的回归就是这样上线的。对 agent 也一样。agent 通常败在两处：读错你要什么，或者没有把活做对所需的上下文。提示词里写什么 管第一处。这一页管第二处。
pstack 给你四种入手的办法。/how 讲清代码现在在做什么。/why 挖出它为什么长成这样。/teach 把两者合成一份讲解。/recall 帮你找回自己最近在某个话题上的上下文。每一种也会让 agent 用你能核对的话解释自己。你就是这样盯住一个可能比你更熟代码的 agent。
先做一次只读调查
Section titled “先做一次只读调查”原因还不清楚时，要的是 finding，不是修复：
/poteto-mode investigate why background jobs time out every few hours. give me what we know, what data you used, and your best hypotheses. don't change any code yet.「don’t change any code yet」会把这次交给 Investigation playbook。它会跑 /how，问动机时再加上 /why，交回一份带出处的讲解。几个选项里做选择时，它会给一条建议，并附一张取舍表。问「what data you used」，是让 agent 把自己的证据和猜测分开。finding 指向修复时，把修复当成新任务再开。
用 /how 追踪行为
Section titled “用 /how 追踪行为”/how do we dedupe notifications? is there an n+1 when we look up subscribers?直接问你真正想问的。/how 会读代码，按资深工程师带你上手这个子系统的深度来回答。它会讲运行时流程、关键类型，以及容易看漏的地方。子系统很大时，它会先派出两到四个只读的探索者分头去看。问题很窄时，它就直接读、直接讲。
用 /why 挖历史
Section titled “用 /why 挖历史”/why was the retry limit set to five? does the reason still hold?/why 干活像侦探查一桩陈年悬案。它从版本控制查起，再把你的 MCP 能接到的各类证据同时查一遍，比如工单系统、长篇文档、团队聊天、可观测性平台、错误追踪和数据分析。报告里每一条都注明出处，直接证据和推断分开写。记录不多时，它会说「appears to」（看起来是）。什么都没查到，也会写进报告，因为「没人写下原因」本身就是答案。
这两个 skill 很自然就能连着用。如果你怀疑眼前这团乱是历史原因造成的，do why first then how 就是一条很好的提示词。
用 /teach 真正理解它
Section titled “用 /teach 真正理解它”/teach me how this PR changes retries. convince me it fixes the cause and not the symptom.摘要不够用的时候，就用 /teach。它会跑 /how 和 /why，改动小的话可能只跑其中一个，再把各个 finding（查出来的结论）串成一份平实的讲解，一张图接一张图地往上搭。「convince me」（说服我）这个说法值得抄过来用。这样讲解就成了一套你能挑刺的论证，而不只是带你逛一圈。
它也能用在 agent 自己的选择上：
/teach me why you implemented it this way and not with a queue. what did you trade off, and why?讲解对 agent 的帮助，和对你一样大。agent 必须解释自己的工作，就得读代码，每条论断都带上证据，不能说得很笃定然后接着往下走。
用 /recall 重建你自己的上下文
Section titled “用 /recall 重建你自己的上下文”/recall catch me up on the export work from last week/recall 会翻你自己最近的聊天，再加上大家共享的记录（工单、以前的修复、还在报的错误），交回一份简报，说明事情进展到哪了、下一步做什么。你的旧聊天里有新开的 agent 没有的上下文。回到一个旧话题开新活时，先把这些加载进来，再交出新的输入：
/recall my work on the virtualized list from yesterday, then read this bug report.如果你想接着某一个具体的聊天往下做，该用的是下面的 Session pickup playbook，不是 /recall。
用 Session pickup 接手先前的工作
Section titled “用 Session pickup 接手先前的工作”如果另一个 agent，或者上周的你，把某个分支做到一半就停下了：
/poteto-mode take over this branch. read the decision log, figure out what's done, and continue from there. don't redo finished work.Session pickup playbook 把之前留下的 trail（决策和操作的记录）当作可信的依据。它会还原分支状态和当时的决策，指出从哪里接着做，并对照原始目标核实接手过来的那些结论，而不是一切从头推一遍。
坑： 别因为「agent 反正会读代码」就跳过这一页的 skills。agent 还没把代码怎么运行理清楚就动手改，往往会在第一个看似合理的地方修掉症状。先跑一遍 /how，代价比第二个 bug 小。
下一篇：设计这次改动。