namewta/pstack
想快,先深。pstack 帮助你写更少、质量更高的代码,提供可放心并行的严谨智能体工作流。
先勾勒类型、签名和模块结构,再在实现填充过程中持续参与。用于 /architect、‘为它做架构设计’、‘设计这个’,或直接写代码会锁定错误形态的非平凡工作。
针对同一任务并行生成 N 个候选,选出一个基础方案,再把其他候选最强的部分融入其中。用于 /arena、‘为这个做方案竞技’、‘把它放进竞技场’,或只尝试一次就可能让复杂产物定型错误的情形。
用于‘把我的工作方式自动化’、‘创建/更新/刷新我的 -mode 技能’、‘把我的偏好或工作风格变成技能’,或希望智能体按用户的方式工作。通过 create-skill + unslop 起草或修订个人 -mode 技能,并可从近期对话记录补充新证据。
报告性能测量或依据它行动前,核验限制因素、调优、物理上限、错误、可复现性、实际相关性和工作是否真的执行。运行基准或报告亲自测得的加速与回退时使用。
在交付前找出改动在差异之外、其他位置可能破坏什么;通过运行真实代码而非写说明,证实它之所以安全所依赖的关键事实。用于‘X 的影响范围’、‘这可能破坏什么’,或审查一个你不放心的小差异。
用朴素的人类语言重述上一条消息,不使用行话。
找出智能体在仓库里反复犯的错误,让每类错误无法再发生。先尝试架构,其次类型,再使用错误信息明确指出修法的lint,接着测试,最后写文档。证明每项检查会在真实历史错误上失败。操作人每次纠正你时重复此流程。用于 /correct。
为项目生成本地技能,使用适合的验证工具,对任意语言中缺陷代价最高而测试最难触及的代码进行形式化验证。用于 /create-formal-verification-skill、“对这个竞态做模型检查”、“证明这个不变量”,或并发、重试、状态机、解析器、不安全代码需要超越普通测试的验证时。
生成一个按用户方式驱动应用的项目本地验证技能,适用于任何语言、框架或平台。用于 /create-verification-skill、‘为这个仓库做一个控制技能’,或项目尚无脚本化方式证明 UI、CLI、服务行为时。
没有更窄手册适用时,设计可审计的执行手册,例如大型迁移、复杂多部分改动,或人离开后回来审查的工作。按任务调整严谨程度,运行假设循环,记录决定。用于 /figure-it-out 或‘figure it out’。
用于‘X 如何工作’、修改前的代码走读,以及放置位置、所有权和分层问题(‘应该放哪里’、‘哪个包负责它’、‘这层对吗’)。解释子系统架构、运行时流程和入门心智模型。动机问题用 why。
用你自己的话重述你认为用户的目标是什么,以及他们正在试图解决什么问题。用于 /in-your-own-words。
用于‘质询’、‘对抗性审查’、‘多模型审查’、‘挑战这个’、‘给代码做压力测试’、‘找盲点’或‘彻底挑错’。对抗者尝试破坏改动或设计,只有运行证实的发现才保留。
用直白文字和小型图示,向用户说明自其上一条消息以来,本次聊天中发生了哪些变化。列出所有等待用户处理的事项,并提供足够信息,让用户只读回复就能决定。用于 /ketchup。
像 /ketchup 一样向用户补上进展,用带字幕的简短幻灯片视频展示发生的变化,并在视频下方用文字列出等待用户的决定。用于 /ketchup-video。
代码变更后,使项目的形式化验证重新与代码一致:找出触及被验证代码的提交,更新模型、验证框架或属性以描述当前代码,重新运行,并说明每次失败属于验证漂移还是代码缺陷。用于 /maintain-formal-verification-skill、“模型还忠于代码吗”,或合并与重构触及被验证代码却未重新检查之后。
定期检查项目验证技能和功能图是否真实:按功能并行读源码,一次实际会话驱动所有功能,最多一个 PR 交付已证明的修正。用于 /maintain-verification-skill 或‘审计验证技能’。
在构建通过 webhook 唤醒 Grok Bot 的自定义界面(页面、仪表盘、按钮)、 用户必须提供 webhook 发送者密钥,或需要通过 Tailscale 暴露该界面时使用。
派出 Comment Sicko,修复接受的发现,并为注释声称的约束提供可编码方案。
引导用户完成 pstack 配置、使用 /poteto-mode,并为任务选择技能、操作流程或原则。输入 /poteto-help 和你的问题。
poteto 的智能体工作方式:简洁而详细的回复、审慎使用子智能体、清理机械行文、简单代码和经过验证的工作。用于 poteto、/poteto-mode 或要求按这种方式工作。
两个或更多共享同一前提的修复,都未通过同一个门禁时使用。写下前提,直接检验,再编写依赖该前提的下一次修复。
接入验证、错误处理或框架适配器时使用。把保护措施集中在系统边界(CLI、配置、网络、外部 API),信任内部类型,并把业务逻辑保留在纯函数中。
用于任何非平凡工作,不只批量工作,包括编辑、迁移、分析与检查。构建完成或证明工作的工具,如代码迁移脚本、脚本、生成器或供子智能体遵循的技能,而不是手工处理。工具是审查者可以重跑的产物。
当你发现自己第二次编写相同指令,或注意到重复出现的纠正时使用。把规则编码为 lint、元数据标志、运行时检查或脚本,而不是增加更多文字。
面对代码库中没有先例的新 UI 交互或架构决定时使用。先构建 2 至 3 个竞争原型,并排比较,再作出决定。
涉及产品、UX 或功能范围取舍时使用。优先用户愉悦,而不是实现方便;交付少而精的功能,而不是更多粗糙功能。
测量前,以及信任、报告或依据所测数字行动之前使用,包括加速、回退、吞吐、延迟或评测结果。找出限制因素,排除它测到的不是你以为的工作。
调试时使用。将每个症状追溯到系统最早出错的位置,并在那里修复。只有所处理的状态合法时,防护才算修复。
写逻辑前使用:选择核心类型与数据结构,安排基础设施和功能的顺序,考虑并发参与者共享什么。把数据结构选对,让后续代码变得自然清楚。
大输出、长文件、重复读取、扇出规划使上下文逐渐填满时使用。把大块内容交给子智能体;主线程保留摘要,不保留原始大段内容。
重构、评估差异规模,或想增加抽象、层级、信号传递时使用。倾向删除,以及能解决问题的最小改动。
设计会经历崩溃、重启与重试的命令、生命周期步骤或处理循环时使用。不论先前部分运行停在哪里,都收敛到相同最终状态。
引入新内部 API 而仍有旧调用者时使用。在同一轮中迁移调用者并删除旧 API,不保留兼容层。
审查或塑造难以追踪的代码时使用。计算问题与答案之间的层级,以及读者必须记住的隐藏状态;折叠只有一个调用者的包装,缩小可变状态范围。
编写有状态逻辑,或代码出现大量分支、在多个文件中重复假定同一种数据形状时使用。
当你想针对可逆工作询问‘我应该做 X 吗?’时使用。
在具有明确阶段边界的计划性重写或迁移中使用。收敛到目标架构,不用会被丢弃的兼容代码维持平滑的中间状态。
任务完成后、宣布结束前使用。针对真实产物验证(运行功能、读取实际值、检查 diff),不要依赖替代指标、自我汇报或‘能够编译’。
将新需求融入现有设计时使用。
并发执行者可能写同一个文件、分支、键或状态对象时使用。先消除共享;只有单个共享写入者是真实不变量时,才从结构上串行化。
用于多步骤工作(全量修改、迁移、一系列相似编辑),以及提交和 PR 的排列。把工作拆成结束时可验证的小单元,进入下一项前检查当前项,并按能够向审查者自证的顺序交付。
安排新增、重构或重写顺序时使用。先移除死代码、重复验证器和占位引用,再在更简单的基础上构建。
编写、修改或保留测试时使用。断言代码使用者能观察到的内容,使测试在行为损坏时失败、仅内部结构变化时继续通过。
设计类型、审查函数签名或编写任何静态类型语言代码时使用。使非法状态无法表达,为语义基础类型加品牌,在边界解析外部数据,穷尽变体,从权威Schema派生。
从自己的聊天历史、实时状态和共享记录(用户报告、过往修复、事故)重建最近工作上下文,返回紧凑的当前状态简报。用于‘回顾我在 X 上的工作’‘帮我跟上进展’‘我最近在忙什么’‘上次做到哪了’,以及开始或恢复工作之前。
针对当前对话记录派出三位并行审查子智能体,提炼经验,并把每条经验路由为现有技能的一项具体编辑。用户说 reflect 时使用。
配置 pstack 为各角色使用的模型和推理预算。检测可用模型,并写入始终应用的规则,覆盖技能默认值。用于 /setup-pstack、“配置 pstack 模型”、“pstack 预算”,或改变 pstack 的模型选择。
把任务挖深,而非扩大,再改写提示词。用于 /sharpen。
为长时间或无人值守工作保留可审查的决策轨迹:TSV日志,每项决定一行,写做什么、为什么、证据和结果。默认本地;审查者需要轨迹才能信任结果时提交。用于 /show-me-your-work、自主或多阶段执行,或人离开后回来审查的工作。
检查在不同状态之间迁移的系统的 TLA+ 模型,例如产品流程、协议或服务,并把它画成 Mermaid 状态图。报告给出到达每个违反规则的状态的最短路径。用于 /statechart,或把缺陷展示为经过各个状态的路径。
扇出 N 个并行执行者,收齐结果并返回一份报告。用于 /swarm、‘并行群体执行’、并行覆盖、竞赛、连续检验和探索。
仅在用户明确要求 TDD、失败测试或回归测试,或者缺陷具有明显、低成本的本地测试目标时使用。测试路径不清楚、成本高、严重依赖集成环境或未被要求时跳过。
用朴素语言解释一项工作,让人真正理解它。运行 how 与 why 技能,把它们的发现编织成一份清晰说明。用于‘教我这个’、‘帮我真正理解 X’、‘给我讲清这次改动或这个子系统’。
分层技术写作标准:Diátaxis 结构、Google 开发者风格句子、STE 指令规则和全球英语句法。用于 /technical-writing,或编写、审查文档、RFC、README、PR 描述与提交信息时。
TypeScript 最佳实践。读取或编辑任何 .ts 或 .tsx 文件时使用。
去除任何文字中的 AI 痕迹。
用于‘X 为什么这样工作’、‘为什么选 Y’、设计理由、回归、事后分析或有数据依据的阈值。发现可用 MCP,并行查询各证据类别(源码历史、工单、长文档、即时聊天、基础设施观测、错误追踪、产品分析仓库),再给出带引用的决策与权衡解释。运行行为用 how。