为什么 · 怎么干活 · 上手 · 技能地图 · 真实项目 · 跑一夜 · 本地运行 · 在线阅读

😵 为什么需要它

用 AI 写过代码的人，大概都见过这一幕：它一上来就改，改在看起来合理的地方，然后告诉你「已修复，应该没问题了」。你一跑，还是坏的。

pstack 是 poteto（React 核心团队成员，在 Cursor 工作）每天自己写代码用的一包 Agent Skills。模型还是那个模型，变的是做事的顺序和标准：

[!NOTE]
pstack 会多派子代理、让几个模型互相挑刺，所以更慢、更费 token。这是换来严谨的价格。小改动不用它，怎么省见 控制花费。

🧭 它是怎么干活的

你只要记一个命令 /poteto-mode，说清楚要什么和怎么算做完。它从 23 套「剧本」里挑一套（修 bug、加功能、重构、查性能……），把步骤抄进待办清单，一步步调用其他技能。决定不做的步骤不会悄悄消失，会写明 skip: 理由。

⚡ 三分钟上手

1. 装上（按你的工具选一种）

# Claude Code（命令会带 pstack: 前缀，比如 /pstack:poteto-mode）
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins

# Cursor
/add-plugin pstack

# Codex、OpenCode 等（Node.js 22.20+；加 -g 装到全局）
npx skills add backnotprop/pstack

2. 选模型：新开对话跑一次 /setup-pstack，问到要不要生成「验证技能」时选要。 用 Claude Code 的，会话模型和各角色怎么搭见 三套推荐配置。

3. 第一个任务：挑一件真实但不大的事，像跟同事交代工作一样说：

/poteto-mode 收藏列表刷新后偶尔会重复。先复现，不要先改代码。
修好的标准：连点十次收藏，列表和 chrome.storage 里都只有一条。
把修之前和修之后 storage 里的实际内容给我看。

[!TIP]
一句好提示词最多五样东西：目标、怎么算做完、想看什么证据、你已经知道的、真正的约束。最好别写的两样：具体怎么做，和你猜的原因。详见 第 3 步。

🗺️ 34 个技能，一张图

平时只打 /poteto-mode，其他的它在需要时自己叫上。想点名用某一个、或者看到 AI 提到一个名字想查查，去 技能速查：每个技能都有一句人话、什么时候用、能照抄的例句、要和谁一起装。

🛠 在真实项目里

每篇都有能直接复制的提示词，例子用的是 Chrome 插件、Astro 网站、Cloudflare 会员站这类真实场景。

还有 照抄就能用的提示词、跑偏了一句话拉回来、不知道该用哪个技能。

🌙 放手让它跑一夜

前面所有步骤的回报都在这里：一个能自己验证的 AI，才是你能放心留下来独自干活的 AI。睡前给它一份「合同」：目标、能判断过或不过的完成条件、一个新的 worktree、决策日志、一个卡住时的逃生口。早上先读 /show-me-your-work 回复里的「需要注意」，审决定，不重读整夜。详见 第 7 步。

📚 站里有什么

页面右上角 ⌘ K 全站搜索，正文里荧光笔和粗下划线标的是重点，带虚线的词悬停就有一句话解释。

🧑‍💻 本地运行

npm install
npm run dev        # http://localhost:4420
npm run build      # 输出到 dist/
npm run release    # 构建并部署到 Cloudflare

src/data/nav.js        站点结构：新手入门、完整教程、How-to 清单、术语表（唯一来源）
src/data/skills.js     技能速查的数据
src/data/wiki.js       Wiki 条目
src/data/faq.js        常见问题
src/pages/start/       新手入门三课（MDX）
src/pages/guide/       完整教程（MDX）
src/pages/howto/       How-to（MDX）
public/xxd/            小小东 UI Kit（自带一份，不走 CDN）
tools/build_assets.py  生成 README 插画、SVG 动画和分享大图（social.svg → social.png / public/og.png）

改内容、加页面、写作规矩见 docs/MAINTAINING.md。README 里的图都由 python3 tools/build_assets.py 生成，改了文字或颜色重跑一次。

🙌 致谢

• pstack 由 poteto 开发；本站用的是 backnotprop/pstack 这个通用镜像。教程内容依据它的 README 和 docs/guide 写成，命令和行为以官方仓库为准。
• 站点骨架来自 小小东 VPS 教程站，界面用 小小东 UI Kit，插画配色借自 ghostty-tint。

本站是非官方的中文入门教程。发现哪里没写清楚、照做不成功，欢迎 提 Issue。

📄 License

教程文字和站点代码采用 MIT。public/xxd/ 里的小小东 UI Kit 构建产物不在此列，适用它自己的 LICENSE（非商用免费，商用需授权）。

Copyright (c) 2026 小小东 Xiaoxiaodong