SuperAPI AI 工具集

saltmode

智能体与模型

查看项目

更新于 11-06 22:02

技能介绍

Saltmode 是 Saltbo 的显式工程模式,改自 pstack。它的核心用途有两个:一是按任务类型选择对应的 playbook;二是协调一组彼此独立的 pstack 技能,让它们在同一个工作流中配合。

使用方式。每个会话需要先阅读一次宿主适配说明。该说明把上游面向 Cursor 的工具、模型、路径和权限指令映射到当前宿主,并设定权限边界。附带的技能位于相对本文件的 ../<name>/SKILL.md,因此在每个 poteto-agent 提示中都要写入本文件的绝对路径。

触发规则。开始一个任务时,先用自己的话向用户说明其目标、要解决的问题,以及最小改动是什么。非平凡改动、架构决策或“确定吗”式疑问触发 how 技能。代码跨函数边界时触发 architect 技能,先做并行设计探索。需要并行分发任务时使用 swarm;设计或代码对比评审使用 arena。设计有争议时,先执行 interrogate 技能的多模型对抗审查。多步骤任务要写 throughput checkpoint。任何文字输出,包括给用户的回复,都遵循 unslop 技能。文档、RFC、readme、PR 描述、提交信息走 technical-writing 技能。提交前对 diff 做 deslop 清理;评审前执行 no-comments。交付 UI、IDE 或 CLI 时使用对应的控制技能,有项目验证技能则优先使用。运行基准或报告性能数字前,先过 benchmark-checklist。PR 状态类请求使用 Babysit playbook;落地绿色栈使用 Shipping playbook。

原则体系。技能列出一组工程原则,覆盖核心方法、架构、验证、委派与元层面。例如懒散协议要求偏向删除和最小改动;第一性原理重新设计要求把新需求当作从第一天就存在;先减后加要求先清理再构建;模型领域要求用状态机、类型模型或表结构承载领域逻辑;边界纪律要求校验只在系统边界进行;让非法状态不可表示;让操作幂等;先迁移调用方再删除旧 API;验证真实产物而非代理指标;修根因而非加守卫;测试行为而非实现。

子代理与自主性。子代理默认使用 poteto-agent 类型,但由技能路由的工作流技能自行设定类型。每次 Task 调用默认后台运行、使用 agent 模式、传文件指针而非内联上下文,并按角色指定模型。自主性方面,可逆操作和外部动作可直接执行,不可逆写入如强推共享分支、部署、删数据、给客户发消息必须暂停确认。

限制。该技能面向特定宿主与模型配置,包含大量上游特定约定;参数、模型清单与 playbook 细节需查阅原文件。是否符合你的环境需自行评估。