SuperAPI AI 工具集

any-percent

编程与开发

查看项目

更新于 10-15 09:29

技能介绍

Any% 是 speed-run 技能集中的一种并行探索模式,核心原则是:当不确定最佳架构时,通过托管 LLM 快速实现多种方案,让真实代码和测试决定胜者。

用途

Any% 用于在架构方向不明确时进行快速并行探索。典型触发场景包括:不确定哪种架构方案最好、想快速比较 2-5 种不同设计、出现“两种都试试”“都探索一下”“不确定走哪条路”这类需求,以及希望以 token 高效的方式进行并行探索。

主要能力

该技能会围绕一个主要架构轴(影响最大的决策)生成 2-5 种方案,例如存储引擎(SQL、NoSQL、文件型)、框架(Express、Fastify、Hono)、架构模式(单体、微服务、无服务器)、状态管理方式或认证策略。每个变体在独立的 git worktree 中运行,使用托管 LLM 进行代码生成,并配有各自的实现计划。变体数量上限为 5-6 个,避免组合爆炸。

工作流程

流程分为六个阶段:

  1. 上下文:最多用 1-2 个问题快速收集信息,不做大量头脑风暴。
  2. 方案:沿主要架构轴生成 2-5 种方案,并列出各自的优缺点。
  3. 计划:为每个变体创建实现计划。
  4. 实现:在单条消息中派发所有智能体,每个智能体使用托管 LLM。
  5. 评估:先做门禁检查(所有测试通过),再对所有变体运行相同的场景测试,对存活方案进行 fresh-eyes 审查,最后调用 speed-run:judge 进行评分。
  6. 完成:完成胜者,清理失败者。

目录结构

docs/plans/<feature>/ 下包含 design.md(共享上下文)和 speed-run/any-percent/ 目录,后者包含各变体的 plan.md 以及最终报告 result.md。变体 worktree 位于 .worktrees/speed-run-variant-<slug>/。

使用方式

使用时会宣告:“I'm using speed-run:any% for parallel exploration via hosted LLM.” 然后按阶段执行。关键操作包括:为每个变体创建 worktree 和分支(如 <feature>/speed-run/variant-sqlite),在单条消息中并行派发所有 Task(run_in_background: true),评估时对所有变体运行相同场景测试,最后调用 judge 技能评分。胜者使用 finish-branch 处理,失败者通过 git worktree remove 和 git branch -D 清理,并写入 result.md 报告,其中包含方案对比表、胜者选择理由和 token 节省估算。

适用场景

适合需要快速比较多种架构实现、希望以较低 token 成本获得真实代码与测试验证、且对最佳方案尚不确定的开发任务。

限制与常见错误

变体过多会导致组合爆炸和计算浪费,应限制在 5-6 个并只选主要轴。探索前进行大量头脑风暴会违背 any% 快速探索的目的,应最多问 1-2 个问题。所有代码生成必须使用托管 LLM 才能节省 token。变体必须在单条消息中派发以实现并行,否则会变成串行。跳过场景测试会导致无法公平比较。忘记清理会产生孤立的 worktree。

依赖

该技能依赖多个其他技能:superpowers:writing-plans 生成实现计划、superpowers:using-git-worktrees 创建隔离 worktree、superpowers:dispatching-parallel-agents 并行派发、scenario-testing:scenario-testing 运行场景测试、fresh-eyes-review:fresh-eyes-review 质量审查、speed-run:judge 评分框架(内置)、superpowers:finishing-a-development-branch 处理胜者与清理。

关于托管 LLM 的具体服务、收费、价格等信息,资料中暂未提供。