1. 从“superpowers”这个热词说起它到底是什么最近一段时间“superpowers”这个词在技术社区和效率工具圈子里被反复提及。很多人第一次看到它会以为是某个新出的超级英雄游戏或者某种硬件外设的代号。但如果你稍微深入了解一下就会发现它其实是一个围绕“技能skills”组织起来的工具集合概念——你可以把它理解成一套给日常工作流加装的“能力插件包”。它的核心思路很朴素把那些你反复要做、每次都要查文档、每次都要重新拼命令的事情封装成一个个可复用、可组合的“技能单元”然后在需要的时候按需引入。这个思路并不新鲜脚本、别名、代码片段、自动化工具本质上都在做类似的事。但 superpowers 之所以能成为一个热词是因为它在“怎么组织这些技能”和“怎么引入这些技能”这两个问题上给出了一套相对轻量、门槛不高的方案。它不要求你先把整个工程重构一遍也不要求你掌握某种复杂的配置语言。你可以在现有工作流的基础上一个一个地加技能加一个用一个用顺了再考虑要不要继续加。这种“渐进式增强”的节奏对大多数普通用户来说比那种“要么全盘接受、要么完全不用”的重型框架要友好得多。我最初接触这个概念的时候也是抱着怀疑态度的。毕竟“技能包”这种东西听起来很容易变成又一个吃灰的收藏夹。但实际用下来我发现它真正有价值的地方不在于技能数量多而在于它把“引入技能”这件事的摩擦降得很低。你不需要写一堆胶水代码也不需要维护复杂的依赖关系很多时候就是一条命令、一个配置项的事。这篇文章我就把自己从零开始了解 superpowers、搞清楚它有哪些 skills、以及怎么把这些技能引入到自己环境里的完整过程原原本本地写出来。不管你是刚听说这个词的新手还是已经装过但没搞明白怎么用的人应该都能从中找到能直接抄作业的部分。2. superpowers 的技能体系它到底提供了哪些 skills2.1 技能的分类逻辑按“动作”还是按“场景”要搞清楚 superpowers 有哪些 skills首先得理解它组织技能的方式。我翻了不少资料也自己装了一遍来看发现它的技能分类并不是按“这个技能属于哪个软件”来切的而是更偏向按“你要完成什么动作”来组织。这个区别很关键。按软件分类的话你会得到“编辑器技能”“终端技能”“浏览器技能”这种目录看起来很整齐但实际用的时候你会发现完成一个任务往往要跨好几个软件你得在几个目录之间来回跳。按动作分类就不一样了它直接对应你脑子里正在想的那件事比如“我要格式化一段文本”“我要批量重命名文件”“我要把这段输出转成表格”你不需要先想“这属于哪个软件”直接找对应的动作就行。具体来说我观察到的技能大致可以归成几个大类。第一类是文本处理类包括格式转换、编码解码、大小写调整、行排序去重这些。第二类是文件与目录操作类比如批量重命名、按规则整理文件、快速查找特定类型的文件。第三类是数据转换类典型的就是 JSON、YAML、CSV 之间的互转以及从非结构化文本里提取结构化信息。第四类是开发辅助类比如生成某种语言的样板代码、快速搭建一个最小可运行的项目骨架、把一段命令的输出整理成可读的报告。第五类是信息整理类比如把一堆零散链接去重、把一段长文本按标题切分、把表格数据转成 Markdown 格式。这个分类不是官方文档里写死的而是我在实际使用中慢慢归纳出来的。你完全可以根据自己的需求重新归类甚至把几个技能组合成一个新的“复合技能”。superpowers 的设计似乎并不强求你把技能放在某个固定的格子里它更像是一个工具箱怎么摆放、怎么组合取决于你手头正在做的活。2.2 几个我高频使用的技能实例光说分类可能还是有点抽象我挑几个自己用得最多的技能具体讲讲它们能干什么、什么时候用。第一个是文本行处理技能。这个技能做的事情很简单把输入文本按行拆开然后你可以指定一个操作比如去重、排序、反转、加行号、过滤掉空行。听起来很基础但实际工作中遇到“把这份名单里的重复项去掉”“把这堆日志按时间排一下”“给这段代码加上行号方便讨论”这类需求时它比打开编辑器手动操作要快得多。我通常是在终端里直接调用把结果重定向到新文件整个过程几秒钟。第二个是JSON 格式化与查询技能。这个技能解决的是“拿到一坨压缩过的 JSON想快速看清楚结构或者提取某个字段”的问题。它支持格式化输出、按路径提取值、统计数组长度、列出所有键名。我经常在调试接口返回数据的时候用它比把 JSON 复制到在线格式化网站再手动找要安全得多也快得多。第三个是批量重命名技能。这个技能允许你用一个模式匹配规则把一批文件按统一规则改名。比如把所有.jpeg后缀改成.jpg或者在文件名前面统一加上日期前缀或者把文件名里的空格替换成下划线。它支持预览模式先告诉你哪些文件会被改成什么名字确认没问题再实际执行。这个预览功能非常重要我后面讲避坑的时候还会提到。第四个是Markdown 表格生成技能。你给它一组用分隔符隔开的数据它直接输出一个对齐好的 Markdown 表格。写技术文档的时候特别有用不用再手动敲一堆竖线和横线也不用担心列宽对不齐。第五个是项目骨架生成技能。这个技能会根据你指定的语言和项目类型生成一个最小可运行的项目目录结构包括必要的配置文件和入口文件。比如你要快速验证一个想法不想从空目录开始一个个建文件这个技能就能省下不少时间。它生成的骨架通常很干净没有多余的依赖你可以直接在上面改。这些技能单独看都不复杂但组合起来用效率提升是实实在在的。比如你可以先用文本行处理技能把一份原始数据清洗一下再用数据转换技能把它转成 JSON最后用 Markdown 表格生成技能输出成文档里的表格。整个链条下来可能比手动操作快五到十倍。2.3 技能之间的组合与嵌套superpowers 比较有意思的一点是技能之间可以组合。你可以在一个技能的输出上直接接另一个技能形成一条处理链。这个机制让它的表达能力比单个技能要强不少。举个例子我经常需要把一份 CSV 文件转成 Markdown 表格但 CSV 里有些字段包含逗号直接按逗号切分会出错。我的做法是先用一个“CSV 解析技能”把数据正确解析成行和列再用“Markdown 表格生成技能”输出。这两个技能串起来就完成了一个稍微复杂一点的任务。组合的方式通常有两种。一种是在命令行里用管道把上一个技能的输出传给下一个技能这种方式适合在终端里快速操作。另一种是在配置文件里定义一个“技能链”把多个技能按顺序列出来然后给这个链起个名字以后直接调用这个名字就行。第二种方式更适合那些你反复要做的固定流程。我自己的习惯是如果一个组合我用了超过三次我就会把它固化成一个技能链省得每次重新敲一遍。需要注意的是技能组合并不是没有代价的。每多一层组合出错的概率就会增加一点排查问题的难度也会上升。所以我的建议是组合的层数不要太多一般三到四层就够了。如果发现一个技能链特别长那可能说明你应该把它拆成几个独立的中间步骤分别验证每一步的输出是否正确而不是一口气跑完再看结果。3. 怎么把 superpowers 引入到自己的工作流里3.1 引入前的环境确认别急着装很多人一听到“安装 superpowers”就马上开始找安装命令结果装完了发现跑不起来又回头去查原因。我的经验是在动手之前先花几分钟确认一下环境能省掉后面很多麻烦。首先要确认的是你的操作系统和 shell 类型。superpowers 的技能大多是通过命令行调用的所以你的 shell 环境得能正常工作。如果你用的是 Windows那要注意有些技能可能依赖 Unix 风格的命令你需要确认自己是在 WSL 里操作还是有对应的替代方案。其次要确认的是运行时依赖。superpowers 本身可能是一个轻量的调度层但它下面的很多技能会依赖一些常见的运行时比如 Python、Node.js 或者某种脚本解释器。你不需要把这些全都装一遍但至少要把你打算用的那几个技能所依赖的运行时准备好。我建议的做法是先想清楚自己最想用哪三到五个技能然后只装这几个技能需要的依赖其他的等真正需要了再说。这样环境干净出问题也容易定位。最后要确认的是权限。有些技能会涉及文件读写、目录遍历如果你的工作目录权限设置得比较严格可能会遇到“能读不能写”或者“能写不能删”的情况。提前用一个小文件测试一下读写权限比装完之后才发现问题要主动得多。3.2 安装方式的选择包管理器还是手动引入superpowers 的引入方式据我了解主要有两种。一种是通过包管理器安装比如用系统自带的包管理工具或者用某种语言生态里的包管理工具。这种方式的好处是安装、更新、卸载都比较规范依赖关系也由包管理器帮你处理。缺点是包管理器里的版本可能不是最新的而且有些技能可能没有被打包进去。另一种是手动引入也就是把技能文件直接下载下来放到一个你指定的目录里然后在配置里指向这个目录。这种方式的好处是灵活你可以只拿你需要的技能也可以随时修改技能的内容来适配自己的需求。缺点是你得自己管理版本和依赖更新的时候要手动操作。我自己的选择是混合使用。对于那些我确定会长期用、而且不太需要改动的技能我用包管理器安装省心。对于那些我想改一改、或者还在试用阶段的技能我手动引入放在一个单独的目录里方便随时调整。这样既享受了包管理器的便利又保留了灵活性。不管你选哪种方式我都建议你在引入之前先建一个独立的目录或者虚拟环境把 superpowers 相关的东西和你的其他工作文件隔离开。这样做的好处是万一某个技能出了问题或者你想彻底清理掉直接删掉那个目录就行不会影响到别的东西。3.3 配置文件的写法与常见字段说明superpowers 的配置文件通常是一个结构化的文本文件格式可能是 YAML、JSON 或者 TOML 中的一种。具体用哪种格式取决于你安装的版本和你的个人偏好。配置文件里最核心的几个字段我结合自己的使用经验解释一下。第一个是技能目录字段。这个字段告诉 superpowers 去哪里找技能文件。你可以指定一个目录也可以指定多个目录它会按顺序查找。我通常会把官方提供的技能放在一个目录把自己改过的技能放在另一个目录这样更新官方技能的时候不会覆盖掉我的修改。第二个是默认运行时字段。这个字段指定执行技能时默认使用哪个运行时。比如你可以设置默认用 Python 3那么所有用 Python 写的技能都会用这个运行时来执行。如果你有多个运行时版本这个字段可以帮你避免版本混乱的问题。第三个是技能启用与禁用字段。你可以在这里列出你希望启用的技能或者列出你希望禁用的技能。我建议只启用你真正会用到的技能因为技能太多的话查找和调用都会变慢而且容易误用。禁用不用的技能能让你的技能列表保持清爽。第四个是日志与输出字段。这个字段控制技能执行时的日志级别和输出格式。调试的时候可以把日志级别调高看清楚每一步发生了什么日常使用的时候调低避免输出太多干扰信息。配置文件的写法没有唯一标准你可以根据自己的习惯来调整。但有一点要注意配置文件里的路径最好用绝对路径或者用环境变量来引用避免因为工作目录变化导致找不到技能文件。这个坑我踩过当时在项目根目录下配置的是相对路径换了个目录执行就报错了排查了好一会儿才反应过来。3.4 验证引入是否成功一个最小测试配置写完之后别急着上复杂任务先跑一个最小测试确认整个链路是通的。我的做法是找一个最简单的技能比如“输出当前时间”或者“把输入文本转成大写”然后调用它看输出是否符合预期。如果这个最简单的技能能跑通说明技能目录、运行时、配置文件这几个环节基本没问题。如果跑不通就按这几个环节逐个排查。排查的顺序我一般是这样的先确认技能文件确实存在于配置的目录里再确认运行时能正常执行一个最简单的脚本然后确认配置文件里的路径和字段没有拼写错误最后确认调用命令的语法是对的。这个顺序是从底层往上层走能比较快地定位到问题出在哪一层。很多人一上来就怀疑配置文件写错了结果查了半天发现是运行时根本没装好白白浪费时间。最小测试通过之后我建议再跑一个稍微复杂一点的技能比如带参数的那种确认参数传递也是正常的。参数传递出问题的情况其实不少见尤其是当参数里包含空格或者特殊字符的时候。提前测一下后面用起来才放心。4. 实际使用中容易踩的坑与排查思路4.1 技能找不到路径与命名的问题“技能找不到”是我遇到最多的一类问题。表现就是调用某个技能时系统提示找不到对应的技能文件或者命令。这个问题看起来简单但原因可能有好几种。第一种原因是技能目录配置错了比如路径拼写错误、用了相对路径但工作目录不对、或者目录权限不够导致无法读取。第二种原因是技能文件的命名不符合规范比如大小写不一致、扩展名不对、或者文件名里包含了特殊字符。第三种原因是技能没有在配置里启用有些版本的 superpowers 需要你显式启用一个技能才能调用它。排查这个问题的时候我习惯先用一个列出所有可用技能的命令看看目标技能到底在不在列表里。如果不在那就是路径或者启用状态的问题如果在列表里但调用还是失败那可能是命名或者参数的问题。这个“先看列表再调用”的习惯帮我省了很多瞎猜的时间。还有一个容易被忽略的点是有些技能的名字和它实际做的事情并不完全对应。比如一个叫“format”的技能可能只负责格式化 JSON不负责格式化其他类型的数据。如果你拿它去格式化一段 XML它可能不报错但也不干活或者报一个让人摸不着头脑的错误。遇到这种情况最好的办法是看一下技能自带的说明文档或者直接读一下技能文件的头部注释搞清楚它到底支持什么、不支持什么。4.2 运行时版本冲突一个隐蔽的坑运行时版本冲突是一个比较隐蔽的坑因为它的表现不一定是报错有时候是“结果不对但也不报错”。比如你有一个技能是用 Python 写的它依赖某个库的特定版本而你系统里装的是另一个版本技能可能还能跑但输出结果和预期有细微差别。这种问题最难查因为你不确定是技能本身的问题还是环境的问题。我的应对策略是给 superpowers 相关的技能单独准备一个运行时环境不要和系统全局的环境混在一起。具体做法可以用虚拟环境也可以用容器取决于你的熟悉程度。这样即使某个技能需要特定版本的依赖也不会影响到其他技能或者你的其他工作。这个做法一开始会多花一点时间配置但长期来看省下的排查时间远远超过这点投入。另外如果你发现某个技能在别人的机器上跑得好好的在你这里就是不行那大概率是运行时版本的问题。这时候可以对比一下两边的运行时版本和已安装的依赖列表通常能很快找到差异。4.3 批量操作前的预览习惯批量操作类的技能比如批量重命名、批量删除、批量替换是我觉得最需要小心的。这类技能一旦执行下去影响面可能很大而且有些操作是不可逆的。我的习惯是不管这个技能有没有预览功能我都会先在一个小样本上测试。具体做法是复制几个文件到一个临时目录在那里跑一遍确认输出符合预期再回到正式目录执行。如果技能本身支持预览模式也就是只显示会做什么、不实际执行那一定要用。预览模式能让你看到每一个文件会被改成什么名字有没有冲突有没有遗漏。我见过有人跳过预览直接执行结果把一批文件的扩展名全改错了又没有备份只能一个个手动改回来非常痛苦。还有一个细节是批量操作之前最好确认一下当前工作目录。有些技能是默认对当前目录下的文件进行操作如果你在错误的目录下执行可能会影响到你不打算动的文件。我通常会在执行前用pwd确认一下当前位置或者直接在命令里指定绝对路径避免歧义。4.4 输出格式不符合预期时的调整方法有时候技能能跑通但输出的格式不是你想要的。比如你希望输出是 JSON但它给的是纯文本你希望表格是对齐的但它给的是用制表符隔开的。这种情况通常不是技能坏了而是你没有指定输出格式或者指定的格式和技能支持的格式不匹配。调整的方法一般有几种。第一种是查看技能支持的输出格式选项在调用的时候显式指定。很多技能都支持多种输出格式只是默认值可能不是你想要的。第二种是用另一个技能对输出进行二次处理比如把纯文本转成 JSON或者把制表符分隔转成 Markdown 表格。第三种是直接修改技能文件把默认输出格式改成你常用的那种。如果你确定某个技能你会长期用而且它的默认输出格式你每次都要改那直接改技能文件是最省事的。我自己的做法是对于高频使用的技能我会在配置文件里给它单独设置一个输出格式的默认值这样每次调用都不用再指定。对于低频使用的技能我就在调用的时候临时指定不改默认值。这样既保持了灵活性又减少了重复劳动。5. 把 superpowers 用出效果的几个关键习惯5.1 从“一个技能”开始不要贪多我见过不少人一上来就想把 superpowers 里所有的技能都装一遍、试一遍结果装了几十个技能真正用到的没几个反而因为技能太多导致调用变慢、查找困难。我的建议是从你当前最痛的一个点开始只引入那一个技能把它用熟、用透确认它确实能帮你省时间再考虑引入下一个。这个“一次一个”的节奏好处是你对每个技能的理解会比较深知道它的边界在哪里、什么情况下好用、什么情况下不好用。而且技能少的时候排查问题也容易不会出现“不知道是哪个技能影响了哪个技能”的情况。等你对几个核心技能都熟悉了再考虑把它们组合起来形成更复杂的流程。5.2 给常用技能起短名字技能的名字有时候会比较长每次调用都要敲一长串很影响效率。我的做法是给常用的技能起一个短名字或者设置一个别名。比如一个叫“format-json-pretty”的技能我可以给它设个别名叫“fj”以后直接敲“fj”就行。这个别名可以设在 shell 的配置文件里也可以设在 superpowers 自己的配置里看哪种方式对你更方便。起短名字的时候要注意避免和系统里已有的命令冲突。我一般会在起完名字之后先用which或者type确认一下这个名字没有被占用。如果已经被占用了就换一个或者用稍微长一点但不会冲突的名字。这个检查花不了几秒钟但能避免很多莫名其妙的错误。5.3 定期清理不再使用的技能技能装多了之后总有一些是你试过一次就再也没用过的。这些技能留在那里不仅占用空间还会让你的技能列表变长查找起来更费劲。我大概每隔一两个月会花几分钟过一遍自己的技能列表把那些超过一个月没用过的技能标记出来考虑是禁用还是直接删掉。清理的时候我会问自己三个问题这个技能我上次用是什么时候如果现在删掉我下次需要它的时候能不能很快重新装上它有没有被其他技能或者技能链依赖如果答案是“很久没用”“能很快重装”“没有被依赖”那我就直接删掉。如果有一点犹豫我就先禁用它观察一段时间确认真的不需要了再删。这个习惯让我的技能列表一直保持在一个比较精简的状态用起来很顺手。5.4 记录自己的技能链和踩坑经验最后这个习惯可能听起来有点老套但确实很有用把你常用的技能链和踩过的坑记下来。不用写得很正式一个简单的文本文件就行记下你常用的组合、每个组合解决什么问题、以及你在这个组合上踩过什么坑。下次遇到类似问题的时候翻一下这个记录能省下不少重新摸索的时间。我自己的记录里有一部分是“技能链配方”比如“清洗 CSV 并转 Markdown 表格”的完整命令另一部分是“坑列表”比如“批量重命名之前一定要先预览”“JSON 技能在遇到非法字符时会静默失败要先验证输入”。这些记录看起来零散但积累下来之后就变成了我自己的 superpowers 使用手册比任何官方文档都更贴合我的实际需求。说到底superpowers 也好其他效率工具也好真正决定效果的并不是工具本身有多强大而是你有没有把它融入到自己的日常工作流里有没有形成一套适合自己的使用习惯。工具是死的习惯是活的。把习惯养好了哪怕只用三五个技能也能产生实实在在的复利效应。