Poteto Mode 是一套面向 AI 编程代理(如 Claude Code、Codex)的工作风格与行为规范集合,以技能形式提供。它的目标是让代理在回答和写代码时保持简洁具体、避免冗余文风、优先使用简单代码,并对所做工作做真实验证。
主要能力与触发方式。技能通过 poteto、$poteto-mode 等关键词触发。触发后,代理需要遵循一套“非可协商”的规则,并在回复中点名所依据的原则及该原则改变的具体决策。剩余触发条件覆盖:非平凡改动或架构决策时使用 how 技能;面对“选哪种方案”的分叉时先分类问题,可观测的事实不交给用户回答,应通过原型实验决定;完全自主授权下直接决定并报告;写代码前先命名数据形状;跨函数边界使用 architect 技能;并行工作使用 swarm 技能;有争议的设计使用 interrogate 技能;多步骤任务写吞吐检查点;任何文风输出使用 unsl 技能;文档、RFC、README、PR 描述和提交信息使用 technical-writing 技能;提交前读 deslop 指令;评审前使用 no-comments 技能;发布 UI/IDE/CLI 时匹配相应控制指令;报告基准或性能数据前使用 benchmark-checklist;处理 PR 状态请求时使用 Babysit 手册;落地绿色 PR 栈使用 Shipping 手册;处理 Bugbot 评论时保持审慎并按分诊规则处理;技能中途损坏则单独开 PR 修复;长时间自主工作建立决策记录。
使用方式。技能正文包含大量按场景触发的原则清单,分为核心、架构、验证、委托、元、自主性和子代理等类别。代理在实际执行时,需要阅读所用原则对应的叶子技能全文,然后依据该原则行动。子代理默认异步运行在全新子上下文,按角色选择模型和推理强度,可通过 setup-pstack 配置覆盖。主代理对子代理的工作负全责,需审阅差异并自行撰写总结。
回复写作规范。要求使用简短陈述句,一句话一个想法;禁止使用长破折号,句中使用冒号连接也不允许;用项目符号表达文件清单时写成完整句子;短句不能作为丢失内容的借口,细节、权衡、选择与未决决策必须保留;每个断言在同一句中标明证据或标注为推测;链接只能指向本次会话产生或阅读过的工件;不能编造链接、引用或转录。
适用场景。适合使用 Claude Code、Codex 等 AI 编程代理进行日常开发、代码设计、重构、调试、测试、基准测量、PR 管理与审查,以及长时间自主或多阶段工程任务的场景。
限制。该技能严重依赖配套的兄弟技能和手册(如 how、architect、swarm、unslop、technical-writing 等)以及 setup-pstack 配置,缺失这些上下文时部分条目无法完整执行。技能明确禁止对不可逆写入(强制推送共享分支、部署、删除数据、给客户发消息)自行操作,必须先暂停。部分默认模型名称与推理强度属于该技能内部设定,实际可用性取决于部署环境。