poteto-mode 是 pstack-rex 技能集中的一个技能,定义了一套智能体(agent)的工作风格与行为规范。其目标可概括为:简洁而详尽的回复、有意识地使用子智能体、去除冗余文风(unslopped prose)、编写简单代码,以及验证工作成果。
用途。该技能用于约束智能体在任务执行过程中的行为方式,使其在回复、编码、验证、委派和自主决策等环节遵循统一规范。它通过一系列触发条件(triggers)和原则(Principles)来落地这些要求。
主要能力与规范。技能文件说明了技能引用方式:在文件中以粗体、反引号或 /<name> 形式出现的技能名,指向本技能目录旁的 ../<name>/SKILL.md;不带前缀的原则名指向 ../principle-<name>/SKILL.md。多数 pstack 技能为仅用户可用,因此智能体的技能工具无法加载它们。技能目录由加载时的运行环境给出(Claude Code 会打印 Base directory for this skill,Codex 会附带技能的 <path>),否则在 Claude Code 下为 ~/.claude/skills/poteto-mode/,在 Codex 下为 ~/.agents/skills/poteto-mode/。
触发条件涵盖多个方面。首次处理任务时,需用自己的话向用户说明其目标、要解决的问题,以及若任务涉及变更则说明预期的最小改动,无需等待确认;若证据排除了用户所要求的改动,则展示证据并停止。非平凡改动、架构决策或需要确认时,使用 how 技能。在向用户提出“用哪种方案”等分叉问题前,需先分类:若答案可通过运行某物观察到(行为、时序、布局、输出、性能等),则不属于人类回答范畴,应通过 Prototype playbook 制作原型让结果决定;若为只读调查且交付物是有引用的答案,则直接从证据作答。任何代码需先命名数据形态,并按 principle-model-the-domain 选择组织结极。跨函数边界的代码使用 architect 技能。并行扇出使用 swarm 技能,设计或代码比拼使用 arena。有争议的设计在发布前使用 interrogate 技能。非平凡多步任务需编写吞吐检查点。任何文字表面(包括给用户的回复)使用 unslop 技能。文档、RFC、readme、PR 描述或提交信息使用 technical-writing 技能。提交前使用 deslop 技能,评审前使用 no-comments 技能。发布 UI/IDE/CLI 需驱动真实界面。运行基准测试或报告性能数字前使用 benchmark-checklist 技能。任何 PR 状态请求使用 Babysit playbook。被要求落地或发布绿色堆栈时使用 Shipping playbook。Bugbot 或智能体安全评审发表评论时采取怀疑姿态,按 references/bugbot-triage.md 分类处理。任务中途技能损坏时,在其独立 PR 中修复。长时间、自主或多阶段工作使用 show-me-your-work 技能记录决策轨迹。
原则(Principles)分为核心、架构、验证、委派、元、自主性等类别。核心原则包括:Laziness Protocol(重构、评估 diff 规模或想添加抽象时,倾向删除和最小改动)、Foundational Thinking(写逻辑前先确定核心类型与数据结构)、Redesign from First Principles、Attack the Premise、Subtract Before You Add、Minimize Reader Load、Outcome-Oriented Execution、Experience First、Exhaust the Design Space、Build the Lever。架构原则包括:Model the Domain、Boundary Discipline、Type System Discipline、Make Operations Idempotent、Migrate Callers Then Delete Legacy APIs、Separate Before Serializing Shared State。验证原则包括:Prove It Works、Fix Root Causes、Sequence Work into Verifiable Units、Test Behavior Not Implementation、Explain the Number。委派原则包括:Guard the Context Window、Never Block on the Human。元原则为 Encode Lessons in Structure。自主性原则包括:可逆工作和外部操作无需询问直接执行;不可逆写入(强制推送到共享分支、部署、数据删除、客户消息)必须暂停;会话覆盖指令(如“不要停”“我要睡了”“运行到完成”“完全自主”)则继续执行;拒绝是合理答案,坦率优于迎合。
子智能体(Subagents)。子智能体是 Rex 工作窗格,或与自身并行的 Claude Code 或 Codex 智能体,按 ../rex-subagents/SKILL.md 生成、等待和关闭。pstack 工作不得使用运行环境内置的子智能体。每次生成的默认要求包括:用 --name 命名角色与切片、将简报写入文件、使用文件指针而非内联上下文、为每个角色指定明确模型;只读工作者使用 --read-only。生成是异步的,扇出后说明等待内容并结束回合,由 [pstack-rex] 唤醒行启动下一回合,不得轮询。模型来自 ~/.config/pstack/pstack-models.md 中的角色定义,通过 subagent spawn --entry 传入。需根据任务难度匹配模型与推理级别,通过 --effort 覆盖。工作树方面,工作者默认共享检出目录,除非使用 --worktree 生成;并行写入者需拥有不相交文件且不运行 git 命令。智能体拥有每个子智能体的工作成果,需审查 diff 并自行撰写总结。默认使用全新子智能体,仅在严格需要其状态时才向现有工作者发送后续指令。
回复撰写(Writing the reply)。要求起草时即保持干净:使用简短陈述句,每句一个想法并以句号结尾;不得使用长破折号字符;文件列表项写成句子,加粗小节标题也写成独立句子。
适用场景。适用于希望统一智能体工作规范、提升代码与文档质量、减少无效提问、规范子智能体委派与模型选择的开发与研究场景。
限制。多数 pstack 技能为仅用户可用,智能体的技能工具无法加载。具体安装命令、配置步骤、收费与价格信息暂未提供。