用途
Any% 是一个并行架构探索技能,用于在不确定最佳架构方案时,快速实现多个不同方案并让真实代码与测试结果决定胜出者。其核心原则是:当不确定最佳架构时,通过托管 LLM 快速实现多个方案,让真实代码加测试来确定赢家。
主要能力
- 沿主要架构轴线生成 2-5 个方案变体(如存储引擎 SQL/NoSQL/文件、框架 Express/Fastify/Hono、架构模式单体/微服务/无服务器、状态管理、认证策略等)。
- 为每个变体创建独立 worktree 与分支,并行实现。
- 每个变体使用托管 LLM 进行首轮代码生成,以节省 token。
- 对所有变体运行相同场景测试,进行 fresh-eyes 质量审查,并通过 judge 技能评分选出胜出者。
- 完成后清理失败变体,输出 result.md 报告。
使用方式
工作流分为六个阶段:
- 上下文:最多 1-2 个问题快速收集需求(构建什么、有无硬性约束)。
- 方案:识别主要架构轴线,生成 2-5 个方案,变体上限 5-6 个,避免组合爆炸。
- 计划:为每个变体创建实现计划。
- 实现:在单条消息中派发所有变体代理(run_in_background: true),每个变体使用托管 LLM 生成首轮代码,遵循 TDD,用 Claude Edit 工具做外科手术式修复(1-4 行),反复测试直至通过。
- 评估:门禁检查(所有测试通过)→ 对所有变体运行相同场景测试 → 对幸存者做 fresh-eyes 审查 → 调用 speed-run:judge 评分。
- 完成:胜出者用 finish-branch 处理,失败者清理 worktree 与分支,写入 result.md。
目录结构:
docs/plans/<feature>/ design.md speed-run/ any-percent/ variant-<slug>/ plan.md result.md
.worktrees/ speed-run-variant-<slug>/
代码生成规则:算法代码使用 mcp__speed-run__generate_and_write_files,Claude 直接编辑仅用于外科手术式修复和多文件协调。
适用场景
- 不确定哪种架构方案最佳。
- 想快速对比 2-5 种不同设计。
- 出现“两种方案都试试”“都探索一下”“不确定走哪条路”的情况。
- 想要 token 高效的并行探索。
依赖技能
writing-plans(生成实现计划)、git-worktrees(创建隔离 worktree)、parallel-agents(并行派发代理)、scenario-testing(运行相同场景)、fresh-eyes(质量审查)、judge(评分框架,内置)、finish-branch(处理胜出者与清理)。
限制与常见错误
- 变体过多会导致组合爆炸、浪费算力,应限制在 5-6 个并只选主要轴线。
- 探索前过度头脑风暴会违背 any% 快速探索的目的,应最多 1-2 个问题后立即生成。
- 所有代码生成都用 Claude 直接编辑会失去 token 节省,变体必须使用托管 LLM 做首轮生成。
- 在分开的消息中派发变体会变成串行,所有 Task 工具必须在单条消息中。
- 跳过场景测试无法公平对比变体,应对所有变体运行相同场景。
- 忘记清理会留下孤立 worktree,应始终清理失败者并写入 result.md。
评分方面,judge 技能会为每个变体填写完整评分工作表与 Speed-Run 指标表,构建整数评分(1-5,无半分),检查硬门禁(Fitness Δ≥2、任一项得分为 1),并宣布胜出者及理由(含 token 效率)。在 any% 中,变体探索不同架构方案,Fitness 差异是预期且合理的,当方案根本不同时应更看重 Craft 与 Spark。