xxd-pstack
Health Gecti
- License — License: NOASSERTION
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 30 GitHub stars
Code Uyari
- process.env — Environment variable access in astro.config.mjs
- network request — Outbound network request in public/xxd/extension.js
- process.env — Environment variable access in scripts/base-links.mjs
- process.env — Environment variable access in scripts/sync-xxd.mjs
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
🧭 pstack 中文新手教程：让 AI 写代码先搞懂、再动手、拿出证据 · A plain-language Chinese guide to pstack (poteto's agent skills) for Claude Code, Cursor and Codex.
pstack 新手教程
中文 · English · 한국어 · 日本語 · العربية · Español · Français · Русский · Deutsch · Português
让 AI 写代码像个靠谱的资深工程师：先搞懂，再动手，拿出证据。
pstack 的中文入门教程。说人话，从装上第一行命令，讲到在真实项目里放手让它跑一夜。
👉 在线阅读：pstack.xiaoxiaodong.ai
不会写代码？ 先看 新手入门三课，20 分钟就能用起来。
为什么 · 怎么干活 · 上手 · 技能地图 · 真实项目 · 跑一夜 · 本地运行 · 在线阅读
😵 为什么需要它
用 AI 写过代码的人，大概都见过这一幕：它一上来就改，改在看起来合理的地方，然后告诉你「已修复，应该没问题了」。你一跑，还是坏的。
pstack 是 poteto（React 核心团队成员，在 Cursor 工作）每天自己写代码用的一包 Agent Skills。模型还是那个模型，变的是做事的顺序和标准：
| 平常的 AI | 装了 pstack | |
|---|---|---|
| 动手之前 | 直接改 | 先用自己的话复述目标，先用 /how 读懂代码 |
| 修 bug | 在表面加个判断 | 先复现，找到第一个出错的地方再修 |
| 说「做完了」 | 「应该没问题了」 | 贴出真实的命令输出、存下来的值、前后对比 |
| 代码量 | 越改越多 | 第一条原则：能删就删，用最小的改动解决问题 |
| 并行 | 几个 AI 抢同一个目录 | 各用各的 worktree，放心同时开好几个 |
[!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 会员站这类真实场景。
| 你手上的活 | 看这篇 | 一句话要点 |
|---|---|---|
| 修一个 bug | 先复现，再修，再证明 | 「先复现」是约束，不是客气话 |
| 加一个功能 | 不碰坏旧的 | 说清楚哪些旧行为一个字节都不能变 |
| 重构 | 结构变，行为不变 | 先录下现在的输出，改完证明没变 |
| 嫌它慢 | 拿数字说话 | 给一个测量值，不是一个感觉 |
| 接手陌生项目 | 先看懂再动手 | 「先别改代码」让它只调查 |
| 提交前心里没底 | 让几个模型挑刺 | 只留下能跑出失败的问题 |
| 写文档 | README、PR 说明 | 给别人用的代码，先写 README |
| 一个大迁移 | 睡前交给它 | 「做 4 小时」不是完成条件 |
还有 照抄就能用的提示词、跑偏了一句话拉回来、不知道该用哪个技能。
🌙 放手让它跑一夜
前面所有步骤的回报都在这里：一个能自己验证的 AI，才是你能放心留下来独自干活的 AI。睡前给它一份「合同」：目标、能判断过或不过的完成条件、一个新的 worktree、决策日志、一个卡住时的逃生口。早上先读 /show-me-your-work 回复里的「需要注意」，审决定，不重读整夜。详见 第 7 步。
📚 站里有什么
| 栏目 | 内容 |
|---|---|
| 新手入门 | 3 课 20 分钟，不会写代码也能看懂：它能帮你什么 → 装上它 → 第一次用 |
| 完整教程 | 9 步，给会写代码的人：是什么 → 安装 → 选模型 → 第一个任务 → 先看懂 → 设计动手收拾 → 验证交付 → 跑一夜 → 用熟以后 |
| 技能速查 | 34 个技能，一个一块 |
| How-to | 17 篇，一篇只讲一件事 |
| Wiki | 20 个概念：一句话 → 打个比方 → 在 pstack 里 → 常见误区；含 24 条原则和 23 套剧本对照表 |
| 常见问题 | 要钱吗？必须用 Cursor 吗？会不会乱改我的代码？ |
页面右上角 ⌘ 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
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi