跳到正文
  1. How-to
  2. 在真实项目里
  3. 接手一个陌生项目

接手一个陌生项目

一句话第一句说「先别改代码」,让它带你看懂全局。细节再用 /pstack:how、/pstack:why 问。

第一天花半小时,之后随用随问适用:接手别人的项目,或者回到半年没碰的代码,想先看懂再动手完整教程第 4 步:改之前先看懂

先照抄一个

第一句
/pstack:poteto-mode 带我看懂这个项目:它是做什么的、怎么在本地跑起来、主要的代码在哪。告诉我你看了哪些文件、用了哪些资料。先不要改任何代码。
  • 「先不要改任何代码」:没看懂之前,它只看不改。它只做调查,不开 PR。
  • 「告诉我看了哪些文件」:它会把读到的和推出来的分开写。

发出去以后看哪里

交回来的是一份说明,每条都写着出处。通常分这几块:

  • 概览:项目是做什么的。
  • 关键概念和怎么工作。
  • 东西放在哪。
  • 容易踩的坑。

再问细节:四个命令

命令 问什么 例子
/pstack:how 现在怎么工作 通知怎么去重?
/pstack:why 当初为什么这样写 重试上限为什么是 5?
/pstack:teach 讲到你真懂 教我这次重试的改动
/pstack:recall 你之前做到哪了 导出功能做到哪了?
  • /pstack:why 先查 Git 历史,再查 issue、文档这些。查不到会直说。「没人写下原因」本身也是答案。
  • /pstack:teach 加一句「说服我」,讲解就变成一个你能检验的论证。
  • /pstack:recall 只翻你自己在这个项目里的记录,默认看最近 7 天。

会员站的例子

朋友交给你一个 Cloudflare Workers 会员站,数据在 D1 里。你要改会员到期的逻辑。先用上面第一句摸全局,再顺着问:

先问现在怎么工作
/pstack:how 用户登录以后,会员身份是怎么一路传到页面上的?session 存在哪?会员到期是在哪里判断的?
再问为什么
/pstack:why 为什么会员到期判断在两个地方各写了一遍?这个理由现在还成立吗?
最后讲到你真懂
/pstack:teach 我要改会员到期的逻辑。教我这一块是怎么工作的,说服我只改一个地方不会让已经付费的用户被踢出去。

三个问完再让它动手。这时你和它心里是同一张图。

接手一个做了一半的分支

上周的你,或者另一个 AI 对话,在一个分支上做到一半。发这句:

接着做
/pstack:poteto-mode 接手这个分支。读决策日志,弄清哪些已经做完,从那里接着做。已经做完的不要重做。

它会找到之前的记录(对话、分支、决策日志),说出从哪一步接着做。前一个对话说「通过了」,它会自己再查一遍。

/pstack:recall 和接手分支别搞混

接着做一个具体的对话,用上面这句。开始新活之前,想找回最近几次对话的来龙去脉,用 /pstack:recall。比如:「/pstack:recall 我昨天做虚拟列表的那些工作,然后读一下这个 bug 报告。」

卡住了?

说了先别改,它还是改了代码。

同一个对话里换新问题,开头加「new task」:「/pstack:poteto-mode new task. 弄清楚为什么退出登录后缓存还在。先不要改任何代码。」不说的话,它会把你的问题当成上一件事的下一步。

/pstack:why 说查不到当初的原因。

这是正常结果。你知道答案可能在哪,比如一个 issue 链接或一份旧文档,直接贴给它。

讲得很全,但我没看懂。

打 /pstack:bro,它会把上一条用大白话重说一遍,更短。

接手分支时,它把做过的又从头做了一遍。

回它:「之前的记录是可信的,不要从头重来。说出从哪一步接着做。」

本站是 pstack 的非官方入门教程,不是官方文档;pstack 由 poteto 开发,命令和行为以官方仓库为准。教程原始源码见 GitHub。

由 airali部署,基于小小东的 MIT 授权教程改编。