跳转到内容
关系图谱

pstack 概览

1,115 字 4 分钟

属性 2
repo
pstack
type
overview
一句话

poteto(React core team,Cursor)开源的 Cursor 技能库:一个 /poteto-mode 主路由器加 23 个剧本、34 个技能、24 条原则,目标是用严谨换质量而不是堆代码量。

定位与安装 ​

  • 作者立场:AI 写的 slop 太多,pstack 让 agent「go deep first」,写得少但质量高,并靠可验证性支撑并行。
  • Cursor 安装:chat 里 /add-plugin pstack。Claude Code:/plugin marketplace add cursor/plugins 再 /plugin install pstack@cursor-plugins,命令加 pstack: 前缀,模型规则写到 ~/.claude/rules/pstack-models.md,Cursor 独有功能(Bugbot、Automations、cloud agents)逐步跳过并留一行说明。
  • 依赖 Cursor 的 Task 子代理、Custom Mode、/loop、Automations;在 Devin CLI 中主要借鉴方法:剧本路由、原则词汇、验证纪律、TSV 决策日志。

入口与用法 ​

  • 顺序:先 /setup-pstack 配角色模型和推理预算,再 /poteto-mode 接任务;Enter 只对单条消息生效,Option/Alt+Enter 设为 Custom Mode 才每轮保持。
  • 提示词五要素:目标、可判成败的 done check、想看的证据、你已知的线索、真约束;别列技能清单、别先给病因猜测。
  • 人格(agents):poteto-agent 是 poteto-mode 的委派子代理,干活前必读 poteto-mode 全文;comment-sicko 是只读注释杀手,经 pstack-no-comments 调用。
  • 原则:24 条见 pstack-原则集,用名字纠偏,agent 回复须点名用了哪条、改变了哪个决定。
  • 自动化:pstack-benny 是 Cursor-only 的 Slack 分诊加复现包,不注册为技能。

23 个剧本(/poteto-mode 按任务匹配,无 slash 命令):

剧本一句话
Investigation只读问题,给带引用的结论或取舍表
Bug fix复现、追根因、带运行时证据地修
Perf issue对基线追踪已测出的慢并改进
Hillclimb循环假设加前后测量,持续爬一个指标
Runtime forensics从活进程仪表化诊断运行时症状,只诊断
Trace forensics诊断已抓取的 cpuprofile/trace/spindump,只诊断
Feature从命名数据形状出发做新行为
Refactoring保行为的结构改动
Prototype用一次就扔的草图回答开放问题
Visual parity像素级对齐两个 UI 实现
Authoring a skill写或改 SKILL.md
Eval盲测技能或提示词改动的效果
Babysit把 PR 或 stack 推到 merge-ready 停住,不合并
Shipping独立验证后从底部落地连续已验证的 PR
Autonomous run把一个长任务跑到完成判据
Orchestrate一个协调者 chat 管多日多 PR 的常驻项目
Autopilot-full一 owner 一 PR,swarm 验证后自动合并整个队列
Autopilot-stack自动建一条线性 stack 交人审落地
Session pickup接手 transcript、cloud agent 或分支上的在飞工作
Pause safely把在飞工作安全挂起以便恢复
Multi-phase plan跨阶段或叠 PR 的活先写计划不实现
Worktree cleanup安全清理已合并 worktree 和旧 iOS simulator
Opening a PR小步有序 commit 开 PR,其他剧本的收尾

技能索引 ​

入口与元:pstack-poteto-mode(总入口)· pstack-setup-pstack(配模型)· pstack-poteto-help(问答导航)· pstack-原则集(24 条原则)

理解:pstack-how(机制讲解)· pstack-why(动因考古)· pstack-teach(讲明白)· pstack-recall(上下文重建)

设计:pstack-architect(草图先行)· pstack-arena(多候选合成)· pstack-sharpen(提示词加深)· pstack-in-your-own-words(复述需求)

构建与清理:pstack-tdd(测试先行修 bug)· pstack-typescript-best-practices(TS 规则表)· pstack-unslop(去 AI 腔)· pstack-technical-writing(写作标准)· pstack-no-comments(注释清理)· pstack-make-bot-ui(bot 控制台)

验证与评审:pstack-interrogate(多模型评审)· pstack-swarm(并行蜂群)· pstack-blast-radius(爆炸半径)· pstack-benchmark-checklist(核数字)· pstack-statechart(TLA+ 状态图)· pstack-create-verification-skill(生成驱动技能)· pstack-maintain-verification-skill(巡检)· pstack-create-formal-verification-skill(形式化)· pstack-maintain-formal-verification-skill(形式化维护)

长跑与改进:pstack-figure-it-out(自设计流程)· pstack-show-me-your-work(决策日志)· pstack-correct(纠错固化)· pstack-reflect(经验沉淀)· pstack-automate-me(个人 mode)

汇报:pstack-ketchup(补课)· pstack-ketchup-video(视频补课)· pstack-bro(大白话)

自动化:pstack-benny(Slack 分诊加复现,dormant)

本机状态 ​

manifest 统计:same 0、outdated 0、missing 36。pstack 全部技能本机均未安装,且强依赖 Cursor;本笔记中可借鉴方法的有 pstack-benchmark-checklist、pstack-tdd、pstack-unslop、pstack-technical-writing、pstack-原则集、pstack-show-me-your-work 等。

使用建议 ​

  • token 开销高:钱花在子代理和评审面板上。作者建议 /poteto-mode 只留给需要严谨的活;小改动直接做。
  • 省钱旋钮:重跑 /setup-pstack 选更小预算、角色设 auto/inherit-parent 继承主模型、缩短面板列表;/loop 必须配可判成败的完成条件。
  • Devin CLI:没有 Task 子代理、Custom Mode、/loop、Automations。可照搬的是五要素提示词、原则纠偏、验证纪律(prove it works、benchmark 七问)、多模型评审与 TSV 决策日志的写法。

关联 ​