claudeers.
// Claude Skills

xxd-pstack

Your AI says “fixed” and it's still broken. pstack makes it try its own work first. A plain-language guide to pstack for Claude Code, Cursor and Codex: start…

// Claude Skills[ cli ][ web ][ claude ]#claude#agent-skills#ai-coding#astro#beginners#claude-code#codex#cursor#skills◷ NOASSERTION$open-sourceupdated 10 days ago

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up xxd-pstack (git-clone project) into my current project.
Found on https://claudeers.com/xxd-pstack
Repo: https://github.com/nevertoday/xxd-pstack
Homepage/docs: https://pstack.xiaoxiaodong.ai
Detected install method: git-clone → git clone https://github.com/nevertoday/xxd-pstack
Category: skills. Platforms: cli, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
unknown; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/nevertoday/xxd-pstack

// compatibility

Platformscli, web
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguageMDX

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

pstack 新手教程

English · 中文 · 日本語 · 한국어 · Español · Português · Français · Deutsch · Русский · العربية

AI 说「修好了」,你一打开,还是坏的。

pstack 让它改完先自己试一遍,再来跟你说。
这份教程用大白话把 pstack 讲清楚,不会写代码也能学会。

开始学习: 免费 · 20 分钟上手 · 10 种语言

演示:输入一句 /poteto-mode 提示词,AI 列出修 bug 的步骤并逐项打勾,最后给出修前修后的证据

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

😵 为什么需要它

用 AI 写代码,你多半经历过这些:

  • 它说「已修复,应该没问题了」。你一跑,还是坏的。
  • 你说「还是不行」,它说「抱歉」,又改一处。来回五轮,一个下午没了。
  • 你只想改一个按钮,它顺手动了十几个文件。
  • 新开一个对话,它把昨天踩过的坑又踩一遍。

对比:不用 pstack 时 AI 直接改代码、跳过复现和验证;用 pstack 时五步都做,并给出修前修后的证据

不是模型不够聪明,是它做事没章法:没看懂就改,没试过就说做完。pstack 是 poteto(React 核心团队成员,在 Cursor 工作)每天自己写代码用的一套 Agent Skills。模型还是那个模型,变的是做事的顺序和标准:

平常的 AI装了 pstack
动手之前直接改先用自己的话复述目标,先用 /how 读懂代码
修 bug在表面加个判断先让问题再出现一次,找到第一个出错的地方再修
说「做完了」「应该没问题了」贴出真实的命令输出、存下来的值、前后对比
代码量越改越多能删就删,用最小的改动解决问题
同一个错下次还犯用 /correct 改仓库本身,让下一个 AI 犯不了
并行几个 AI 抢同一个目录各用各的 worktree,放心同时开好几个

[!NOTE] pstack 会多派帮手 AI、让几个模型互相挑刺,所以更慢、更费 token。小改动不用它,怎么省见 控制花费。

🧗 pstack 好用,但自己学很难

pstack 是 poteto 写给自己用的。官方文档默认你已经是资深工程师:

  • 一上来就是一堆名字:34 个技能、23 套剧本、24 条原则,全是英文术语,不知道哪些必须学。
  • 不知道第一步做什么:装哪个版本?装完要不要配置?该打哪个命令?
  • 会打命令也不会说:提示词没写清「怎么算做完」,它照样跑偏,只是跑得更认真。
  • 看不懂它的回复:回复又长又专业,你不知道哪句要紧、哪句能跳过。

很多人装上试了一次,觉得「好像没什么不同」,就放下了。

✨ 这份教程怎么帮你

  • 20 分钟从零到用上:新手入门 3 课,一条路走到底。每一步都写了「你应该看到什么」,不对也有办法。
  • 只学要用的:平时只记一个命令 /poteto-mode,加一句三段式的话:我想要什么 · 做好是什么样子 · 做完给我看什么。其他内容都标明「遇到了再查」。
  • 每种情况都有能照抄的提示词:修 bug、加功能、重构、接手陌生项目、睡前交代……换掉尖括号里的内容就能发。
  • 教你看懂回复:它的复述、待办清单、检查结果在哪,怎么判断它做得对不对,跑偏时回哪一句。
  • 从高手的提示词里学写法:34 个技能都能读原文,每个还挑了几句拆开讲:这句让 AI 做了什么、为什么这样写、你写提示词时怎么借用。
  • 说人话:每页标题下有一句话,告诉你这页能帮你做成什么;生词悬停就有解释。
  • 全球都能读:首页和新手入门有 10 种语言,母语读者从第一课就能学。
  • 跟着 pstack 更新:内容核对到 pstack 当前版本,每个命令都对照过官方仓库。

从哪开始

  • 没写过代码:新手入门 3 课,20 分钟。学会让 AI 帮你做小网页、小工具,并看出它做得对不对。
  • 会写代码:9 步完整教程和 17 篇 How-to,从第一个任务讲到让它独自跑一整夜。
  • 想学怎么跟 AI 说话:34 个技能都有原文、译文和写法拆解,看高手怎么写提示词。

🧭 它是怎么干活的

pstack 怎么干活:你说一句话、/poteto-mode 挑剧本、按步骤调技能、带证据交回来

你只要记一个命令 /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 个技能,一张图

pstack 技能地图:34 个技能分七类,外加 24 条原则

平时只打 /poteto-mode,其他的它在需要时自己叫上。想点名用某一个、或者看到 AI 提到一个名字想查查,去 技能速查:每个技能都有一句人话、什么时候用、能照抄的例句、要和谁一起装。点进去还能读它的 SKILL.md 原文和译文(可以对照着看),以及「从它的写法里学」:挑几句原文,讲这句让 AI 做什么、为什么这样写、你写提示词时怎么借用。

🛠 在真实项目里

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

你手上的活看这篇一句话要点
修一个 bug先复现,再修,再证明先让问题再出现一次,再动手修
加一个功能不碰坏旧的说清楚哪些旧行为一点都不能变
重构结构变,行为不变先录下现在的输出,改完证明没变
嫌它慢拿数字说话给一个测量值,不是一个感觉
接手陌生项目先看懂再动手「先别改代码」让它只调查
提交前心里没底让几个模型挑刺只留下能跑出失败的问题
写文档README、PR 说明给别人用的代码,先写 README
一个大迁移睡前交给它完成条件要能判断过没过,不写「做 4 小时」

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

🌙 放手让它跑一夜

放手让 AI 跑一晚上:每一轮检查完成条件、做最小改动、验证、提交或丢弃、记一行日志;早上看决策日志

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

📚 站里有什么

栏目内容
新手入门3 课 20 分钟,不会写代码也能看懂:它能帮你什么 → 装上它 → 第一次用
完整教程9 步,给会写代码的人:是什么 → 安装 → 选模型 → 第一个任务 → 先看懂 → 设计动手收拾 → 验证交付 → 跑一夜 → 用熟以后
技能速查34 个技能,每个有原文、译文和写法拆解
How-to17 篇,一篇只讲一件事
Wiki20 个概念:一句话 → 打个比方 → 在 pstack 里 → 常见误区;含 24 条原则和 23 套剧本对照表
常见问题要钱吗?必须用 Cursor 吗?会不会乱改我的代码?
语言首页和新手入门有 10 种语言;完整教程、技能、How-to、Wiki、常见问题有中文和 English

页面右上角 ⌘ 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 生成,改了文字或颜色重跑一次。

🙌 致谢

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

📄 License

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

Copyright (c) 2026 小小东 Xiaoxiaodong

// faq

What is xxd-pstack?

Your AI says “fixed” and it's still broken. pstack makes it try its own work first. A plain-language guide to pstack for Claude Code, Cursor and Codex: start with no coding, in 10 languages.. It is open-source on GitHub.

Is xxd-pstack free to use?

xxd-pstack is open-source under the NOASSERTION license, so it is free to use.

What category does xxd-pstack belong to?

xxd-pstack is listed under skills in the Claudeers registry of Claude-compatible tools.

17 views
★ 33 stars
unclaimed
updated 10 days ago

// embed badge

xxd-pstack on Claudeers
[![Claudeers](https://claudeers.com/api/badge/xxd-pstack.svg)](https://claudeers.com/xxd-pstack)

// retro hit counter

xxd-pstack hit counter
[![Hits](https://claudeers.com/api/counter/xxd-pstack.svg)](https://claudeers.com/xxd-pstack)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how xxd-pstack connects across the ecosystem