superpowers 方法论框架
superpowers 走的是和大多数项目相反的路:它不提供工具,只提供纪律——每个技能都是一段写得很硬的流程文本, 逼着 Agent 先设计、先写计划、先写失败的测试、跑完验证命令才准说做完。本专题共 30 篇, 每篇都对着仓库里的真实文件写,也如实写清这套流程的代价:更慢、更啰嗦,对小改动是过度设计。项目仍在持续迭代,文中结论以 仓库最新代码与文档 为准。
Agent 方法论框架 superpowers:只给流程,不给新工具
拆解开源项目 superpowers 的构成与生效机制:它不提供新工具,而是在会话启动时注入一份强制性的技能索引,把头脑风暴、写计划、TDD、代码评审串成一条不许跳步的流水线。读完你能判断自己的项目该不该装,以及装了之后哪些环节会明显变慢。它不解决模型能力问题,也不替你选工具。
流程与实践
七步工作流逐步拆开:怎么装、怎么谈需求、怎么切任务、怎么派活、怎么测、怎么收尾。
把 Agent 方法论框架 superpowers 装到你的工具上:多平台接入差异与不生效排查
superpowers 对 Claude Code、Cursor、Codex、Gemini CLI、Kimi Code、OpenCode、pi 等各有一套接入方式,装法差异全在会话开始那一次上下文注入上。本文按仓库源码梳理它的三个组成部分、四种接入形态、最容易装完不生效的几个位置,以及这套流程的代价。不解决模型选型与成本问题。
开工前先开隔离工作区:Agent 方法论框架 superpowers 的 worktree 流程与安全检查
拆解开源项目 superpowers 如何把 git worktree 从个人习惯变成流程里的固定动作——开工前的环境检测、征求同意、目录忽略校验、依赖安装与基线测试,收尾时按出身决定清理谁。读完你能照着搭一套自己的开工与收尾约定,也能看清它慢在哪、哪些事它明确不管。
先复现再找根因:Agent 方法论框架 superpowers 的系统调试流程拆解
拆解开源项目 superpowers 里 systematic-debugging 这套流程:它用一条铁律和四个阶段,把编码 Agent 从换个写法再试试的死循环里拽出来,配套的反向追踪、分层校验、条件等待各自解决什么。读完你能拿到可照搬的流程骨架和五条避坑经验,但它不负责替你写代码,也不会让开发变快。
Agent 方法论框架 superpowers 的 TDD 技能拆解
拆解开源项目 superpowers 里的 test-driven-development 技能:它用一条铁律和一份借口对照表把「先写失败测试」变成不可协商的流程,配套文档还规定了什么算好测试。读完你能拿到可直接搬用的验证动作和避坑点,但它不解决框架选型、覆盖率和 CI 搭建。
Agent 方法论框架 superpowers 的七步工作流拆解
逐步拆开 superpowers 这套编码 Agent 技能框架的七步流程,讲清每一步交出什么文件、下一步凭什么接得住,以及设计闸门、计划自查、任务复审这几道关卡为什么不能跳。也会写明它放弃了什么、哪些场景不适用。不讲安装步骤,不做框架优劣排名。
Agent 方法论框架 superpowers 的写计划技能拆解
拆开 superpowers 仓库里 writing-plans 这个技能的三条硬要求——步骤粒度压到 2-5 分钟、每步必须可验证、任务描述要上下文自足,逐条讲清它各自防的是哪种失败,以及配套的计划评审提示词怎么兜底。读完你能照着改自己的计划模板,但它不解决需求从哪来、也不适合小改动。
Agent 方法论框架 superpowers 完成前验证:不跑命令不许说做完
拆解 superpowers 仓库里的 verification-before-completion 技能,讲清它用铁律、五步门函数和两张对照表堵住 Agent 谎报完成的具体做法,以及它在整套技能库里的位置。读完你能照着在自己项目里立同类规则,也能看清它放弃了什么、哪些场景下不划算。
Agent 方法论框架 superpowers 怎么划并发派发的准入线
superpowers 把并发准入线定在无共享状态、无先后依赖两条上,同一仓库里却明令禁止并发派实现者。本文顺着它的决策图与技能文件,讲清这条线怎么划、为什么读代码可并发而写代码不行、并发省下的时间在哪一步还回去。不讲安装,也不给通用多 Agent 编排教程。
Agent 方法论框架 superpowers:请评审与接评审是两套技能
拆解开源项目 superpowers 里请求代码评审和接受代码评审的两份技能文件,讲清它派评审 Agent 时给什么上下文、评审模板强制哪些约束、收到一条你觉得不对的意见时该怎么核查和推回。只讲这个项目的具体做法,不解决评审规则集设计和静态检查工具选型。
Agent 方法论框架 superpowers:实现与评审为何隔离
拆解开源项目 superpowers 的 subagent-driven-development 技能:实现者与评审者的提示词为何分开写死,简报、报告、diff 三份文件如何完成交接。读完你能拿到可照搬的角色隔离与修复循环设计,以及它明确不解决的那些问题。
Agent 方法论框架 superpowers:先问再动手治哪类翻车
拆解 superpowers 仓库里的 brainstorming 技能:它用一条硬门禁把「写代码」挡在「设计被批准」之后,用「一次只问一个问题」逼出真实约束,最后落成一份带自查与人工复核的规格文档。读完你能照着这条轨道搭自己的提问流程。它不解决代码质量,也不替你做技术选型。
机制与方法论
往下一层:技能文件的契约、钩子怎么强制、方法论自己怎么被测、以及它怎么用自己开发自己。
别再 sleep 了:Agent 方法论框架 superpowers 怎么处理测试不稳定
Agent 写出来的测试时红时绿,多数卡在两处:用固定延时猜异步什么时候好,以及跑完测试仓库里多出脏文件。这篇按 superpowers 仓库里的条件式等待文档、示例实现和污染源定位脚本,逐段讲它们各自解决什么、怎么落地、代价在哪、有哪些坑会让你拿到假绿结果。不解决测试框架选型和端到端环境搭建。
从两份设计文档看 Agent 方法论框架 superpowers 怎样重做工作区与修复回路
拆开 superpowers 仓库里两份真实设计文档,看它如何把「一个计划一个工作区」和「评审不过怎么办」这两件事改到收敛:脚本签名、台账身份行、五轮断路器、定向复评的契约都能对照仓库路径核验。也写清它放弃了什么、评测没证明什么、小改动为什么不该用它。
Agent 方法论框架 superpowers 的会话钩子注入了什么
提示词写在技能文件里,模型不读就等于没写。本文拆 superpowers 的 hooks 目录:会话起点的钩子把哪份文件原样塞进上下文、派发脚本怎么同时被 cmd 和 bash 解析、三种宿主各要什么 JSON 字段,以及跨系统时钩子最容易死在哪。它不替你判断该不该用这套流程。
Agent 方法论框架 superpowers 的技能文本为何写得强硬
superpowers 仓库里有一份说服原理清单,解释为什么写给编码 Agent 的规则不能用建议式措辞。本文拆解这七条原理、对应的四种文本形态,以及项目自己划出的适用边界与代价。读完你能把这套写法搬进自己的提示词,也知道它何时属于过度设计。不解决模型选型问题。
Agent 方法论框架 superpowers 的三段独立评审怎么设计
把 superpowers 仓库里规格、计划、任务三份评审提示词摆在一起读,拆清楚它们各自拿到什么输入、怎么阻止评审方沾到作者的上下文、哪些约束只是模板而没进流程。读完你能拿到一份可直接照抄的隔离清单和七条避坑项。它不解决模型选型,也不替你判断该不该上这套流程。
Agent 方法论框架 superpowers 的视觉伴侣:克制与零依赖
拆解开源项目 superpowers 里那块「给对话式设计加的画布」——它靠哪几道规则被压在真正需要看图的时刻,服务端为什么把 express、ws、chokidar 全删掉自己实现 WebSocket,以及这套取舍放弃了什么。读完你能拿到一份组件对照表和一份避坑清单,不解决画布怎么设计得好看的问题。
Agent 方法论框架 superpowers 的压力测试:把调试技能逼到没有借口可绕
superpowers 的 systematic-debugging 技能目录里留着三份压力场景、一份纯问答测试和一份创建日志。本文顺着这五份文件讲清楚:一条流程规则是怎么先被逼着失效、再被针对性补强的,以及这套做法的代价在哪。不讲怎么装插件,也不评价它和其他框架谁更好。
Agent 方法论框架 superpowers 的支点:哪怕 1% 可能相关也必须调用技能
superpowers 用一条不留余地的硬规则加一张十二行的借口对照表,把「技能库」变成了真会被触发的流程。本文拆开这条规则的原文、那张表的来历、会话启动时的注入机制,以及它放弃了什么、什么场景不适用。读完你能判断自己的 Agent 规则为什么总被绕过。
Agent 方法论框架 superpowers 多平台装配对照:一套技能如何适配不同扩展模型
把 superpowers 仓库里 Claude Code、Cursor、Codex、pi 四个平台目录摆在一起读,逐字段对照清单声明、技能发现、会话开始注入和工具映射的差异,说清各家扩展模型的真实边界。你能拿到一份可复用的适配判断框架和一份避坑清单;不解决技能内容本身怎么写,也不评判平台优劣。
Agent 方法论框架 superpowers 如何用自己的流程开发自己
superpowers 仓库里留着完整的规格、实施计划和评测结果三件套,记录了一次改动从提出假设到假设被证伪的全过程。这篇带你按文件读懂它怎么把方法论落到实处、评测怎么诚实地报告负面结果、以及这套流程的代价在哪。不讲怎么安装,也不讲通用的规格驱动开发理论。
Agent 方法论框架 superpowers 移植:难点不在复制文件
从 superpowers 官方的移植文档出发,拆解把一套技能体系搬到新编码工具上到底要做哪些事:会话开始时的自动注入才是集成本体,工具名映射和触发时机才是真正的难点。你会拿到一份能力体检清单、三种集成形态的差异,以及这套设计明确不管的部分。
Agent 方法论框架 superpowers:分支收尾技能防的是什么
拆解开源项目 superpowers 的 finishing-a-development-branch 技能:它把「合并、开 PR、保留」做成一次必须由人回答的显式选择,把丢弃从菜单里拿掉,并按工作区来源决定敢不敢删。读完你能拿到一套可照抄的收尾判定顺序和避坑清单;它不解决怎么写代码、怎么评审,也不替你选分支策略。
Agent 方法论框架 superpowers:技能文件的跨平台契约
拆开 superpowers 仓库看一个技能文件到底受哪些约定管:目录怎么摆、frontmatter 只有哪两个必填字段、工具名为什么必须挪出正文放进按平台切分的映射文件。读完你能照着这套契约写出能在多个编码工具里被触发的技能,也知道它为此放弃了什么。不涉及技能内容本身该写什么。
Agent 方法论框架 superpowers:技能怎么写才会被照做
拆解开源项目 superpowers 里的 writing-skills 元技能,讲清技能文件该长什么样、触发描述该怎么写、按失败类型该选禁止句还是配方,以及它靠子代理压力场景做验证的完整流程。读完你能照着改自己团队的技能库,也能知道这套流程在什么场景下属于过度设计。
Agent 方法论框架 superpowers:怎么给一套方法论写测试
拆解开源项目 superpowers 如何用压力场景和真实 LLM 会话反过来压测自己的技能文档,包括 RED-GREEN-REFACTOR 三阶段怎么跑、仓库里两层测试各放在哪、这套做法放弃了什么。读完你能拿到一份可照做的技能自测流程和避坑清单,但它不解决模型能力和业务准确率问题。
与其它开源 Agent 项目的对照
同一个词在不同项目里指的常常不是一回事。这三篇只讲设计取向差异与各自适合的场景,不排座次。
pi、ECC、superpowers 三个 Agent 项目的分层对照
把 pi、ECC、superpowers 三个开源项目摆在一起看,会发现它们不在同一层:一个是能自己跑起来的编码 Agent 本体,一个是装进别人 harness 的工程增强套件,一个是只给流程不带运行时的方法论。这篇按仓库文件讲清三层分工、各自的设计取向和边界代价,不解决谁更好的排序问题。
同名不同物:pi、ECC、superpowers 三个项目对技能机制的三种设计取向
同一个「技能」的名字,pi 把它做成运行时按需加载的扩展,ECC 把它做成两百多个按上下文命中的工作流库,superpowers 把它做成十几篇经过压力测试的纪律文本。本文对照三者的目录约定、加载时机、frontmatter 字段与各自放弃的东西,帮你判断自己的仓库该抄哪一套。不讲安装步骤,也不排优劣。
三个开源 Agent 项目的跨工具复用对照:运行时扩展、配置资产、插件包
把调好的 Agent 能力搬到另一个工具上,有三种做法:写成运行时扩展、写成可适配的共享资产、写成每个平台各自的插件包。本文用 pi、ECC、superpowers 三个开源仓库的架构文档做对照,讲清各自的机制、放弃了什么、以及上手时最容易踩的坑。不解决模型选型和账单问题。
想把 Agent 真正搭起来,而不只是会用?
从 Agent 工程实践到数字员工落地,站内有成体系的教程与课程。