Madness 是整套技能工具包的“前门”,定位为一个可靠的单一入口:用户只需说明想做什么,它负责判断应使用哪个起始技能,在即将启动重任务时先确认,然后把工作交接给该技能。
用途:解决工具包中技能过多、描述模糊、模型常常直接回答而不调用更合适技能的问题。与仅命名的 skill-explorer 不同,madness 是主动版本:命名并启动。其核心原则是“路由,然后交接”——选择正确的起始技能、启动它、随即退出,不写代码、不制定计划、不亲自运行循环。
主要能力:
- 接收 /madness <task> 形式参数作为意图;无参数或意图模糊时展示入口菜单并只问一个问题再路由。
- 按入口映射将意图分类到前门技能,例如多智能体/并行构建对应 orchestrator,先出构建计划对应 plan-builder,循环直到条件满足对应 loop-controller,单功能开发对应 feature-dev,UI 设计对应 ui-brief,代码/安全/部署审查对应相应审查技能,技能自身管理对应 skill-writer 等,长尾意图参考 skill-explorer 的路由表。
- 区分低成本与高成本路由:高成本(生成多个智能体、自主循环、完整多组件构建、推送提交或开 PR 等)先以“继续吗”确认;低成本(单技能、偏读取、快速且易回退)直接启动。不确定时按高成本处理。
- 在确认高成本路由时,附带询问是否为本轮启用令牌节省代理;仅建议一次,用户拒绝后不再重复询问;不自动设置环境变量,用户同意后启动 use-pxpipe 完成接线。
- 每次只路由一个技能;仅当请求确实包含两个不同未决问题时才增加第二个技能。若没有需要技能解决的未决决策,明确说明并停止。
使用方式:输入 /madness 加任务描述,或直接问“这件事该从哪开始”。路由确认后,它用一行说明所选技能,对高成本路由以问句结尾并等待,对低成本路由直接调用目标技能,然后让目标技能自行驱动。
适用场景:冷启动、不确定该用哪个技能的场合;需要将模糊意图落到正确入口时;希望在启动重任务前获得一次确认时。不适用场景:用户已明确指定技能、正在某个技能任务中途提问、或请求已能干净匹配某个技能自身触发词时,不应再经过 madness 增加一跳。
限制:madness 不是元编排器,不能代替目标技能执行工作;不得把所有意图都路由到 orchestrator;不得未经确认启动高成本路由;不得命名而不调用。在非 Claude Code 宿主上,仅可路由到实际存在的可移植技能子集,缺失的 Claude Code 专属技能应说明而非路由到死路。