SuperAPI AI 工具集

Poteto Mode

编程与开发

查看项目

更新于 11-19 04:05

技能介绍

Poteto Mode 是一份写给 AI 编程智能体的行为规范,托管在 skills.sh 的 shaneholloman/cursor-plugins 插件下,页面路径为 poteto-mode,触发方式包括 poteto、/poteto-mode 等。它不是一个独立的软件工具,而是一套约定与流程,用来约束智能体在代码任务、写作任务和评审任务中的做法。

用途与定位。规范开篇给出“不可违背条款”(Non-negotiables),要求回复中必须点名每一个影响决策的原则,以及该原则改变的具体选择,并且只能引用本次会话中确实读过其叶子 SKILL.md 的原则。换句话说,它把“为什么这样做”变成回复的必填内容,而不是可选说明。

主要能力。规范用一组“剩余触发条件”把常见任务路由到对应技能或剧本。例如:非平凡改动、架构决策或“确定吗”类问题走 how 技能;涉及代码时先命名数据形状并依据 model-the-domain 原则选择组织结构;跨函数边界的代码走 architect 技能并先做并行设计探索;并行扇出走 swarm 技能,设计或代码比拼走 arena;有争议的设计在交付前走 interrogate 做多模型对抗;文档、RFC、readme、PR 描述和提交信息走 technical-writing;提交前走 deslop,评审前走 no-comments;发布 UI、IDE 或 CLI 时选用匹配的 control 技能。对于 PR 状态类请求,规范明确要求使用自带的 Babysit 剧本而非 Cursor 内置的 babysit 技能,并覆盖“babysit this”“get it green”“check on PR X”等常见说法。

原则体系。Principles 分为 Core、Architecture、Verification、Delegation、Meta 几组,每条原则都注明适用时机,并要求应用前通读对应叶子技能。Core 包括懒惰协议(倾向删除与最小改动)、基础性思考(先定核心类型与数据结构)、从第一性原理重新设计、攻击前提(多个共享同一前提的修复失败后应质疑前提)、先减后加、降低读者负担、以结果为导向的执行、体验优先、穷尽设计空间、构建杠杆(用脚本、codemod、生成器代替手工)。Architecture 包括领域建模、边界纪律(系统边界处校验、内部类型可信、业务逻辑保持纯净)、类型系统纪律(让非法状态不可表示)、操作幂等、先迁移调用方再删除旧 API、序列化共享状态前先分离。Verification 包括证明其有效(对照真实产物验证)、修复根因而非症状、把工作切成可验证单元、测试行为而非实现、解释数字(报告性能数字前先弄清限制因素)。Delegation 包括保护上下文窗口、不要因人类而阻塞。Meta 是“把教训写进结构”,用 lint、元数据、运行时检查或脚本代替重复的文字说明。

自主性与人工介入。规范默认“直接做”,允许使用任何 MCP 工具,可逆操作和外部动作(团队聊天、工单更新、启动评估)无需询问。但对不可逆写入一律暂停:强推共享分支、部署、删除数据、给客户发消息。用户说“别停”“我要睡了”“跑到完”“完全自主”等会话级覆盖可以放行。规范同时强调“不”也是可接受的回答,被征询意见时要给出真实判断,不默认附和。

子智能体约定。在剧本步骤内派生子智能体时使用 subagent_type: poteto-agent,而 how、why、interrogate、reflect、swarm 等技能会自行设定子智能体类型,不应被覆盖。每次 Task 调用的默认值包括:后台运行、agent 模式(readonly 会剥离 MCP)、传文件指针而非内联上下文、按角色指定模型(可通过 /setup-pstack 配置;资料给出的默认示例为代码用 grok-4.7-xhigh-fast,散文与判断用 claude-opus-5-5-max)。默认使用全新的子智能体并合并范围,只有在后续工作严格依赖该智能体的本地状态(本地检出、未提交改动、仍在运行的进程)时才续用。规范要求智能体对所有子智能体的工作负责,要审阅 diff 并自己写总结,不能直接转述子智能体的说法。

回复写作。回复要“边写边干净”,短句、每句一个意思,禁止长破折号,句中不用冒号作连接(列表前的冒号可以)。简洁不等于删内容,细节、权衡、选择、待定决策都要保留。要先说明工作面向谁、对他们有什么变化,再讲实现细节。不得编造链接、引用或对话记录,只链接本次会话产生或读过的产物。每个论断在同一句里带上证据或标签(实测、推断、猜测)。

注释与剧本。注释规则与回复一致,只为代码本身无法体现的“非显而易见的为什么”保留注释,验证或测试脚本不加阶段叙述式注释。开任务前先建待办清单,把匹配剧本的步骤逐字复制到最前面,跳过的步骤保留并注明原因。内置剧本包括 Investigation、Bug fix、Perf issue、Hillclimb、Runtime forensics 等;跨切面的大工程或用户离开后要信任的工作交给 figure-it-out 技能,长期项目级程序交给 Orchestrate。

适用场景与限制。它适合希望统一智能体行为、提升可审计性和代码质量约束的团队或个人,尤其适合长期、多阶段、需要子智能体协作的开发任务。限制包括:资料未提供安装命令、版本要求、支持的模型清单、收费或定价信息,也未提供实际效果或基准数据;规范中提到的部分技能(如 control-cli、control-ui、Babysit 剧本)来自 cursor-team-kit 等其他插件,可用性取决于相应插件是否安装,资料对此未作说明。