pstack是什么？让AI少写代码却写出更高质量代码的终极指南-开发者社区

pstack是什么？让AI少写代码却写出更高质量代码的终极指南

【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Poteto's pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude

pstack 是一套面向 AI 编程代理（Agent）的工作流技能栈，把 Claude Code、Codex、Pi、OpenCode、Gemini CLI 等主流 AI 编码工具装上一套"资深工程师级别的做事规矩"：代码更简洁、变更更小、每一步都经过验证。你只需告诉它目标，它就能自动选对流程，少写代码，却写出更高质量代码。

一、pstack 是什么？一句话讲清楚

pstack 最初是 Cursor 生态里一套"有主见"的技能栈（skill stack），本项目是它移植到 Claude Code、Codex、Pi 等运行时的版本，各运行时的构建与差异记录在 CONTEXT.md。

它的核心理念浓缩在一句话里：

告诉poteto-mode你的目标，它会自动调用正确的任务流程，并让你的代码保持简洁、简单、经过验证（concise, simple and verified）。

也就是说，pstack 不改变 AI 的智力，而是改变 AI 的工作方式——像给实习生配了一位严格的 Tech Lead。

二、为什么 AI 写代码"越多越差"？

用过 AI 编程工具的朋友大概率遇到过这些问题：

代码膨胀：改一个按钮要顺手重构半个模块；
注释水词：满屏// Phase 1: 添加卡片这类没有信息量的注释；
未经验证："编译通过"就算完成，但功能其实是坏的；
风格漂移：文档和回复充满 AI 味的套话。

pstack 的答案不是"更强的提示词"，而是把工程纪律固化成技能（skills）。它在 plugins/pstack/skills/poteto-mode/SKILL.md 中定义了一批不可谈判的触发规则，例如：

场景	pstack 的做法
代码跨越函数边界	先调用`architect`敲定类型与模块结构，再动手实现
任何写码任务	先给数据形状命名，用正确的组织结构表达领域模型
任务完成前	必须"证明它能跑"，而不是"能编译"
任何文字输出	走`unslop`技能，去除 AI 味
提交前 / 评审前	走`deslop`/`no-comments`清理代码

项目还内置了 24 条principle-*原则技能（如"懒惰协议：能删代码就不加抽象"、"先减后加"、"测试行为而非实现"），完整目录见 plugins/pstack/skills/。

三、一键安装：pstack 插件最快配置方法

安装非常轻，无需服务器，无遥测，所有脚本都在本地运行。

3.1 Claude Code 安装步骤

在 Claude Code 中执行：

/plugin marketplace add michael-denyer/pstack-claude /plugin install pstack@pstack-claude

3.2 Codex 安装步骤

在终端执行：

codex plugin marketplace add michael-denyer/pstack-claude codex plugin add pstack@pstack-claude

3.3 Pi 安装步骤

pi install git:github.com/michael-denyer/pstack-claude

3.4 其他运行时（Prime Agent / OpenCode / Gemini CLI）

支持"仅技能"安装：克隆仓库后把技能目录软链到~/.agents/skills/，各运行时的支持矩阵与验证状态见 docs/reference.md。

装完后运行一次setup-pstack，即可为不同角色配置默认模型与推理强度（例如arena runners: opus @xhigh），或关闭自动路由。

四、核心机制：pstack 如何做到"少写代码"？

4.1 poteto-mode：一个入口，自动分流

poteto-mode 技能是默认入口。它内置了 20+ 套playbook（剧本），位于 plugins/pstack/skills/poteto-mode/playbooks/，覆盖真实开发的全生命周期：

🐛Bug fix：先复现 → 定位根因 → 修复 → 重跑失败用例；
✨Feature：从"命名的数据形状"出发构建新功能；
🔄Refactoring：保证行为不变的前提下改结构；
🚀Shipping / Babysit：盯 PR、修 CI、处理评审直到可合并；
🛠Investigation：只读调查"X 是怎么工作的 / 为什么当年这么设计"。

例如修复一个"翻页后搜索条件被重置"的 bug，你只需要说：

Use poteto-mode to fix the search filter resetting when I change pages.

它会复现问题、用how和why调查、委托子代理修复、再重跑失败用例；如果修复跨越函数边界，会先引入architect做设计。最终你拿到的是修复结果 + 失败/通过的证据，而不是"我已经改好了"。

4.2 多模型互审：用"三个模型"给 diff 找茬

pstack 最有特色的是interrogate 技能：让三个不同的模型并行尝试"攻破"你的代码改动，互相抬杠，达成共识后才算安全。设计类任务同理——architect会先做并行设计探索，arena则跑 N 个并行方案再择优嫁接，swarm把任务切成切片分发给并行工作者。

默认面板的模型组合记录在 plugins/pstack/models.json，这也是"少写代码"的关键：把判断力花在刀刃上——难的改动派给最强判断力的模型，机械的修改交给快速模型，全部角色都可用 setup-pstack 技能单独调整。

4.3 自动路由：不用记命令也能触发

Claude Code 和 Codex 插件会安装一个会话路由钩子（plugins/pstack/hooks/session-start-context.md），当任务满足以下任一条件时自动调用poteto-mode：

涉及多个文件，或修改了被其他文件调用的签名；
涉及设计或架构决策；
是原因未知的 bug 或性能问题。

小改动则直接放行，不被流程拖慢。想关闭可随时用setup-pstack一键关掉。

五、常用技能速查表

插件共含 57 个技能目录，33 个公开技能均可用/pstack:<name>（Claude Code）或/skill:<name>（Pi）调用，完整清单见 docs/reference.md。新手建议先掌握这 8 个：

命令	使用场景
`/poteto-mode`	任何非平凡任务的默认入口
`/how`	理解某个子系统是如何工作的
`/why`	多源证据调查"为什么当年这么设计"
`/tdd`	先写失败测试，再修 bug
`/interrogate`	三个模型并行试图击穿你的 diff
`/babysit`	盯住一个 PR，修 CI 和评审，保持可合并
`/unslop`	清除文字中的 AI 痕迹
`/bro`	把上一段话用人话重述一遍