SuperAPI AI 工具集

poteto-help

通用与其它

查看项目

更新于 10-16 16:27

技能介绍

用途

poteto-help 是 pstack 里的帮助导航技能。它回答用户关于 pstack 的各种问题,包括:如何完成初始设置、如何用 /poteto-mode 开始一项任务、针对某个情境应该选择哪个技能、某次运行出错后如何修复、以及如何把 pstack 改造成符合自己习惯的工具。使用方式是输入 /poteto-help 并附上一个问题。

需要区分两类消息:如果消息是在请求执行工作(例如“用 pstack 修这个 bug”),那不属于帮助问题,此时应读取 poteto-mode 并在其下执行工作,同时提醒一次“用 /poteto-mode 开始每个任务可以保持该模式”。如果确实是帮助问题,则不要直接开工,因为一次 pstack 运行会消耗真实的 token,应当把提示词交给用户自己发送。

主要能力

该技能把问题映射到持有答案的技能与参考文件,由那些文件掌握细节。在引用前先读取所路由到的文件,并且当文件内容与本技能中的映射不一致时,以该文件为准。由于链接指向的是已安装的技能,用户可能无法打开,因此应给用户文件的公开副本,路径为 https://github.com/mariusflorescu/pstack-t3/blob/main/skills/ 之后接其在 skills/ 下的路径。

技能名以加粗、反引号或 /<name> 形式出现时,对应本技能目录旁的 ../<name>/SKILL.md;不带前缀的原则(principle)对应 ../principle-<name>/SKILL.md。读取该文件并遵循它。大多数 pstack 技能是仅限用户调用的,因此技能工具无法加载它们。

回答用户关于 pstack 的问题后,交给他们一条可以自行发送的提示词,并链接答案来源文件。

使用方式

先判断需求。可以从消息和对话中推断:若已指名情境(例如“哪个技能审查 PR”),直接进入对应小节;若仍不清楚,只问一个多选题,选项为:完成初始设置 / 用 /poteto-mode 开始任务 / 为某情境挑一个技能 / 修复出错的运行 / 定制专属 pstack,然后只回答其选择的小节。

回答前检查会改变答案的状态,仅当它确实影响答案时才提及:若不存在 ~/.config/pstack/pstack-models.md,说明该用户尚未运行 /setup-pstack,所有角色都使用默认模型;若项目中没有 verify-* 技能或其他应用测试工具(harness),说明智能体没有脚本化的方式来驱动应用,当问题涉及“证明某项改动有效”时,应提到 /create-verification-skill。

当模型文件缺失且此事重要时,询问用户是否现在为每个角色选择模型和推理预算。它重要的情形包括:用户是新手、问题关于设置或成本、或答案取决于运行哪些模型。每次对话最多问一次。若需求也不清楚,可把两个问题一起问。给出两个选项:现在——提供 /setup-pstack 让其输入,同时回答其问题;稍后——回答其问题,并附一行说明“在运行 /setup-pstack 之前,每个角色都保持默认模型”。

适用场景

  • 初始设置:用 npx skills add mariusflorescu/pstack-t3 -g -a claude-code -a codex 安装。Codex 线程以 $<name> 运行技能,而 pstack 写的是 /<name>。然后运行 /setup-pstack,它会询问推理预算、为每个角色映射模型,并写入 ~/.config/pstack/pstack-models.md;技能在下次委派时读取它。再用 /poteto-mode 加一个目标和一项可判定通过或失败的检查开始真实任务。
  • 用 /poteto-mode 开始任务:/poteto-mode 会把任务匹配到一份 playbook,复制其步骤到任务列表,并按步骤需要运行其他技能。被跳过的步骤会以 skip: <原因> 保留在列表中。好的提示词说明目标以及如何判断完成,不必列出技能。
  • 挑选技能:默认答案是 /poteto-mode。当用户想要比 playbook 更多或更少的某样东西时,直接指定技能。推荐前先读取该技能,并给一个示例提示词。
  • 修复出错的运行:技能内提供了症状与修复的对照,例如“模式在几轮后不再生效”“新选的模型没有效果”“运行成本超出预期”“并行智能体相互覆盖”“夜间运行有动作但没完成任何事”等。
  • 定制 pstack:/automate-me 可依据用户自己的历史起草个人模式技能,与 /poteto-mode 并用;/reflect 在会话结束后把经验转化为用户批准后的技能编辑;想为某工作流写技能可让 /poteto-mode 运行为此设计的 playbook。

限制

  • 安装本身几乎不改变任何东西,直到用户调用某个技能。只有 /setup-pstack 和 deslop 能从用户话语中加载,typescript-best-practices 在智能体处理 .ts 或 .tsx 文件时加载。
  • pstack 是为 T3 Code 构建的。其技能使用 Agent Skills 格式,其他工具也能读取,但多数工作流技能(包括 /poteto-mode、/how、/why、/teach)会以按角色配置的模型启动 delegate_task 子智能体,而 PR 监控和定时任务是 T3 Code 的工具,因此那些部分在其他工具中可能无法工作。
  • 关于收费、价格、更多平台支持等信息,资料中暂未提供。