zheyi420/pstack
if you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence.
写代码之前先勾出类型、签名和模块结构,实现填进去时一直留在回路里。用于 /architect、「architect this」、「design this」,或那些一上来写代码就会把错误形状锁死的非平凡工作。
对同一任务拉起 N 个并行候选,选出基底,把落选者最强的部分嫁接进去。用于 /arena、「arena this」、「throw it in the arena」,或对一个非平凡产物只试一次就会把错误形状锁死的时候。
用于「automate me」、「创建/更新/刷新我的 -mode skill」、「把我的偏好或工作方式收成一份 skill」,或希望 agent 按用户的工作方式来。经 create-skill 加 unslop 起草或修订一份个人 -mode skill,可选地从最近的对话记录里拉新鲜证据。
在你报告或依据一次性能测量行动之前,先核它(限制因素、调优、上限、错误、可重复性、相关性,以及工作到底发生了没有)。跑基准,或报告你测到的加速或回退时使用。
在一次改动交付之前,找出它可能在别处弄坏什么,超出 diff 之外,并用跑真实代码来证明它安全所依靠的那一个事实,而不是写一篇说明。用于「X 的爆炸半径」、「这可能弄坏什么」,或评审一份你还不信任的小 diff。
用普通人的话重述上一条消息,不要行话。
找出 agent 在这个仓库里反复犯的错,并让每一种都变得不可能。先试架构,再试类型,再试一条错误信息点名修复方式的 lint,再试测试,文档放在最后。证明每一项检查都会在一个真实的历史错误上失败。操作者每次纠正你,都重复这一遍。用于 /correct。
生成一份项目本地 skill,对 bug 代价最高、测试最到不了的代码做形式化验证。任何语言,用合适的验证工具。用于 /create-formal-verification-skill、「model-check this race」、「prove this invariant」,或并发、重试、状态机、解析器、不安全代码需要比测试更多的时候。
生成一份项目本地的验证 skill,按用户的方式驱动你的应用。任何语言、框架或平台。用于 /create-verification-skill、「给这个仓库做一份控制 skill」,或项目没有脚本化的办法来证明 UI、CLI 或服务行为的时候。
没有更窄的 playbook 合适时,设计一份可审计的 playbook:一次大迁移、一次野心很大的多部分改动,或人走开之后才来评审的工作。按任务调节严谨程度,跑一个假设循环,并记录决定。用于 /figure-it-out 或「figure it out」。
用于「X 是怎么工作的」、改东西之前的代码走读,以及放置、所有权、分层的问题(「这个该住在哪」「哪个包拥有它」「这是不是正确的一层」)。解释子系统架构、运行时流程、上手用的心智模型。动机用 why。
用你自己的话重述你认为用户的目标是什么、他们想解决什么问题。用于 /in-your-own-words。
用于「interrogate」、「对抗式评审」、「多模型评审」、「challenge this」、「stress test this code」、「find blind spots」或「tear this apart」。对手试图打破一次改动或一个设计,只有一次运行证明了的发现才留下来。
用平白的话和小图,把用户补上这次聊天里自他们上一条消息以来变了什么。列出每一件等着他们的事,让他们只靠回复就能做决定。用于 /ketchup。
像 /ketchup 那样把用户补上,用一段短的带字幕幻灯片视频讲发生了什么,等着的决定以文字放在下面。用于 /ketchup-video。
代码变了之后,把项目的形式化验证重新对齐到代码:找出碰过已验证代码的 commit,更新模型、harness 或性质,让它们描述现在的代码,重跑,并说明每一次失败是验证的漂移还是代码里的 bug。用于 /maintain-formal-verification-skill、「模型是否仍然忠于代码」,或合并和重构碰过已验证代码却没有重跑的时候。
一轮定期维护,让项目的验证 skill 和功能地图保持诚实:每个功能一个并行的源码读者,一次现场会话驱动每一个功能,最多一个 PR 交已证明的修正。用于 /maintain-verification-skill 或「audit the verify skill」。
做自定义 UI(页面、仪表盘、按钮)时使用。它应通过 webhook 唤醒 Grok Bot。用户必须提供 webhook 的发送方密钥,或要把这个 UI 暴露到 Tailscale 上。
拉起 Comment Sicko,修掉被接受的发现,并为声称的约束提供编码。
带用户完成 pstack 的设置、/poteto-mode,以及为一项任务挑选 skill、playbook 或原则。带上一个问题输入 /poteto-help。
poteto 的 agent 风格:回复简短而具体,subagent 用得审慎,散文去掉 AI 腔,代码简单,工作经过验证。用于 poteto、/poteto-mode,或要求按这种风格干活。
两个或更多共用一个前提、又没过同一道闸的修复出现时使用。先把前提写下来并直接检验它,再写下一个假定它成立的修复。
接验证、错误处理或框架适配器时使用。把守卫集中在系统边界(CLI、配置、网络、外部 API);信任内部类型,把业务逻辑留在纯函数里。
用在任何非平凡的工作上,不只是批量工作:编辑、迁移、分析、检查。造一个做这件事或证明这件事的工具(codemod、脚本、生成器,或一份你的 subagent 会遵守的 skill),不要用手做。工具是评审者能重跑的产物。
当你发现自己在第二次写同一条指示,或注意到反复出现的纠正时使用。把规则编成 lint、元数据标记、运行时检查或脚本,而不是再写一段文字。
面对代码库里没有先例的新 UI 交互或架构决定时使用。先做 2 到 3 个互相竞争的原型,并排比较,再选定。
产品、UX 或功能范围的取舍出现时使用。选择让用户高兴,而不是实现方便;少交付打磨过的功能,而不是多交付粗糙的功能。
测量之前使用,也在你信任、报告或依据一个测到的数字行动之前使用:加速、回退、吞吐、延迟,或一次 eval 结果。找出限制它的东西,并排除它量到的不是你以为的那项工作。
调试时使用。把每个症状追回到系统第一次走错的地方,并在那里修好。守卫只有在它处理的状态是合法的时候才算修复。
写逻辑之前使用:选定核心类型和数据结构,安排脚手架与功能的顺序,问并发参与者共享什么。把数据结构定对,后面的代码就会变得显然。
上下文快满时使用:大段输出、长文件、反复读取、扇出规划。把大块内容交给 subagent;主线程里留摘要,不留原始载荷。
重构、评估 diff 大小,或想加抽象、分层、信号穿线时使用。偏向删除,以及能解决问题的最小改动。
设计会在崩溃、重启和重试中运行的命令、生命周期步骤或处理循环时使用。无论之前的运行完成了多少,都收敛到同一个终态。
引入新的内部 API、旧调用方还在时使用。在同一波里迁移调用方并删掉旧 API,不要留下兼容层。
评审或塑造难追的代码时使用。数问题和答案之间隔着几层,以及读者脑子里要记的隐藏状态。折掉只有一个调用方的包装,缩小可变状态的范围。
写有状态的逻辑时使用,或者代码分支很多、或在多个文件里重复同一个形状假设时使用。
在可逆的工作上想问「我该做 X 吗」时使用。
在有明确阶段边界的计划性重写和迁移中使用。向目标架构收敛;不要用一次性的兼容代码去保住平滑的中间状态。
完成任务之后、宣布做完之前使用。对照真实产物验证(跑这个功能、读实际的值、检查 diff),而不是替身、自我报告,或「它能编译」。
把新需求接进现有设计时使用。
并发行动者可能写同一个文件、分支、键或状态对象时使用。先消掉共享。只有一个共享写入者是真正的不变量时,才用结构去串行化。
用于多步工作(扫一遍、迁移、一串相似的编辑),以及你如何叠 commit 和 PR。把工作拆成小单元,每个单元结束于一个可验证的状态,检查完再做下一个,并把交付排成评审者能自己看懂的序列。
安排一次添加、重构或重写的顺序时使用。先去掉死代码、多余的校验器和占位引用,再在更简单的底座上建造。
编写、修改或保留一个测试时使用。断言代码的用户能观察到的东西,让行为坏掉时测试失败,只有内部实现变化时测试仍然通过。
设计类型、评审函数签名,或用任何静态类型语言写代码时使用。让非法状态无法表示,给语义上的基本类型打上品牌,在边界解析外部数据,穷尽变体,从权威 schema 派生。
从你自己的聊天历史、现场状态和共享记录(用户报告、先前的修复、事故)重建你最近的工作上下文,然后交回一份紧的现状简报。用于「recall my work on X」、「catch me up」、「what have I been working on」、「where did I leave off」,在开始或恢复工作之前。
从当前对话记录里挖出能留下来的教训,并把每条路由到对已有 skill 的一处具体编辑。用户说 reflect 时使用。
配置 pstack 每个角色用哪个模型、推理预算是多少。检测你可用的模型,并写入一条始终生效的规则,覆盖 skill 默认值。用于 /setup-pstack、「configure pstack models」、「pstack budget」,或更改 pstack 的模型选择。
把任务做深,而不是做大,然后改写 prompt。用于 /sharpen。
为长时间或无人值守的工作留下一条可评审的决定痕迹:一份 TSV 日志,每个决定一行(做了什么、为什么、证据、结果)。默认放本地。评审者需要这条痕迹才信任结果时,再 commit。用于 /show-me-your-work、自主或多阶段运行,或人走开之后才来评审的工作。
检查在状态之间迁移的系统的 TLA+ 模型,例如产品流程、协议或服务,并把它画成 Mermaid statechart。报告给出到达每个打破规则的状态的最短路径。用于 /statechart,或把 bug 显示为一条穿过状态的路径。
扇出 N 个并行 worker,把它们排空,返回一份报告。用于 /swarm、「swarm this」,或并行覆盖、竞速、闯关和探索。
仅当用户明确要求 TDD、一个失败的测试或一个回归测试时使用,或者这个 bug 有一条显然便宜的本地测试目标时使用。测试路径不清楚、很贵、集成很重,或没人要求时,跳过。
把一块工作讲明白,让一个人真的懂。运行 how 和 why skill,把它们找到的织成一份清楚的解释。用于「teach me this」「help me really understand X」「explain this change or subsystem to me」。
分层的技术写作标准:Diátaxis 结构、Google 开发者风格的句子、STE 指示规则、Global English 句法。用于 /technical-writing,或撰写、评审文档、RFC、readme、PR 描述、commit 消息时。
TypeScript 最佳实践。阅读或编辑任何 .ts 或 .tsx 文件时使用。
去掉任何文字里的 AI 腔。
用于「为什么 X 是这样工作的」「为什么我们选了 Y」、设计理由、回归、事后复盘,或有数据支撑的阈值。返回一份带引用的决策与取舍解读。运行时行为用 how。