跳至主要内容

Superpowers 一個 AI Agent 的控制論操作系統

· 閱讀時間約 8 分鐘
w0x7ce
w0x7ce
MySelf

发布于 2026-01-25 00:25:09（微信公众号导出记录）。

本文来自公众号后台的“导出文章内容”功能。博客正文由导出长图进行本地 OCR 转写，并保留原始排版图用于逐段核对。

原文链接：查看原文

OCR 转写有效文字约 4494 字；代码、流程图和版式以文末原始排版图为准。

正文（本地 OCR 转写）​

本文是G1tHub熟用源琪目obra/superpowers 的源碼分析董己。 在上文對cvcrything-cloudc-codc的宏架横爽 Hooks 機制分析中,我們探封了其 事件驱勤的設计理念。本文将造一步深入其内核照」,聚焦於14個核心技能 (Skills)的具體實现,如果Hooks是系統的骨架,那磨些技能就是它的盈魂

一套將AIAgent概率性生成器鞋為確定性工程颌的控制输操作系统。本文將基於源​

碼逐一拆解这些墨勤程式,精建一份完整的技術百科全善。

架精華:OS喻 在深入每個技能之前,必须理解它們是如何组装在一起的。Superpowers探用了分怖式操作 系的架设計: User Space (Agent Runtime) 5ystem Calls (Skill Invocations via Senantic Interrupts) Kernel 5pace (lib/skills-core,js) Init

  • SkillResoLver(解决级/覆)

  • Update Checker (OTA 更新]

Process |·Interrupt Handler (Cs0 括美中断分骤) 12 Process & Menory Management | Hardware | SDD Scheduler]|Git Worktrees| 1Abstract 5cripts 6 Tools Layer ](Process Mgmt)]|(Virtual Men)| [0rivers/uti1s]

核心技能全譜系(The14FundamentalDrivers) 以下是基於/skiL15目的完整遍雁分析。按功能通龍分為四组。

第一組:内核與引導(Kernel&Boot)​

1. using-superpowers​

  • 0S 角色:Init Process (PID 1)

  • 定位:系统敲动的第一进程,班立「惠法!。

  • 楼心機制:遵通hooks/scssion-start.sh將System Prompt 强制注入上下文。

  • 第—原Bl: “IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE.

YOU MUST USE IT. *

  • 解析:这解決了AI的自由我量;同题。它是一個強制性的路由表,将自然细言意图路

由到標单化流程。

2. using-git-worktrees​

  • 0S 角色:Virtual Memory Manager (虚凝内存)

  • 定位:為每因任猜提供隔魁的物理填境。

  • 核心機制:封装aitworktrccadd命令,自動检测n目期型(package.json/Carg

o.tomL)亚通行初始化安装。

  • 解析:傅统Agent在同一目媒下修改代码容易生街突(Race Condition)。

Worktree制保證了環境纯净性:,是亚狼開發的基。

3. finishing-a-development-branch​

  • 0S 角色:Garbage Collector (GC)

  • 定位:任鸦结束後的清理與合供。

  • 核心機制:提供 4棵遥填(Merge,PR,Keep,Discard),强制敦行git wor

ktree renove 。

  • 解析:防止“MemoryLeak”(磁盤空同估用和案分支堆)。它强制了發通期的開

填: Ver1fy -> Merge -> Clean,

第二組:設計與规删(Design&PLanning)​

4. brainstorming​

  • 0S 角色:Input/Output Processor (I/0)

  • 定位:將模的用户需求转化為明確的設計文楼。

  • 楼心機制:酵格拉底式提阀。被配置為disable-nodel-invocation:true(如果通通

Shim竭用),强迫 Agent 只思考不行助。

  • 解析:运是“Measure twice,cut once”的工程馈现。防止 garbage-in 募致

garbage-out,

5. writing-plans​

  • 0S角色:Job Scheduler(作嘴調度)

  • 定位:將投計转化為可款行的原子任聘陈列。

  • 楼心機制:强制將任移拆解為2-5分罐粒度的“B1te-s1zed Tasks".每個任必须包

含確切的文件路径和测試命令。

  • 解析:运是SDD模式的前置能件。LLM不擅侵虚理侵任務,但非常瘤長虑理微任務。这個

技能就是將长任務编為微指令集。

第三組:進程管理與執行(Process&Execution)​

6. subagent-driven-development (SDD)​

  • 0S 角色:Thread Pool Manager (螺程池)

  • 定位:系统的毅手级特性,单會話内的多继程流水線。

  • 核心機制:Fork/Join横型

  • Context Isolation:每子任派生一個全新的 Subagent,斑有空白上下文。

  • Pipeline: Implementer -> Spec Rev1ewer -> Quality Reviewer.

  • DependencyInjection:主控Agent 將任移描述「注入:子Agent,免請文件

开銷。

  • 解析:底解决了ContextPolLution(上下文污染)填致的降智周题。虽然消耗大量

Token,但换束了極高的代碼質量。

7.executing-plans​

  • 0S 角色:Batch Processor(批滤理)

  • 定位:半行款行任務的替代方案。

  • 核心機制:分批执行(Default:3tasks per batch),然後起等待人類

Checkpoint.

  • 解析:相比SDD的全自動显登,这是一種更健、人類介入感更强的模式,適合跨會结的

侵任務。

8.dispatching-parallel-agents​

  • 0S 角色:Parallel Computing Unit(亚行計算)

  • 定位:處理無状感、無依辑的亚發任務。

  • 核心機制:蝶别指立的故障域(如3個不相觸的潮试失胶),同時派發多個Agent追行

修復。 多1e

  • 解析:將線性時間離度(O(n))垦縮為常数级(O(1)).適用於Shared-Nothing

聚標的任称。 架横的任務。

第四組:質量保證協(QAProtocols)​

9. test-driven-development​

  • OS角色:ValidityChecker(有效性检查)

  • 定位:開發的對鐵律。

  • 核心機制:Red-Green-Refactor。

  • Iron LaW:"NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST"。

  • Anti-Rationalization:预判了Agent的所有籍口("太簡单不用測"、“以後再

補")亚定義為非法操作。

  • 解析:这是防止回歸(Regression)的最强防火。

10.systematic-debugging​

  • OS角色:Debugger(調試器)

  • 定位:根因分析與修復。

  • 核心機制:四段協(Investigate->Pattern->Hypothesis->Fix)。

  • Tooling:配套find-polluter.sh即本,用於二分查找測試污染。

  • Constraints:禁止“ShotgunDebugging"(盲目答試)。

  • 解析:將調試過程科學化,强制AI復現問題後再修復,拒運氣编程。

11.verification-before-completion​

  • OS角色:AssertionLibrary(断言庫)

  • 定位:退出前的最後一道防線。

  • 核心機制:Exit Code Check。

  • Protocol:只有當cmd返回exitθ且输出被讀取後,Agent才能説“I'm

done"。

  • 解析:對抗LLM的“Sycophancy"(好人類)倾向。强制用事實(運行结果)話。

12. requesting-code-review​

  • OS角色:StaticAnalysisTrigger(静分析觸發)

  • 定位:主動發起代碼塞查的標弹模板。

  • 核心機制:提供標化格式(Implemented vs PLan,Base SHA,Head SHA),供

SDD流程調用。

13. receiving-code-review​

  • OS角色:PatchManager(補丁管理)

  • 定位:處理人類或Agent的反。

  • 核心機制:NoPerformativeAgreement(禁止表演性同意)。

  • Protocol:必先验證反的技術正確性。如果Reviewer錯了,必须Push

back,

  • 解析:强調技術真理高於社交禮儀。

第五組:元技能(Meta-Skills)​

14.writing-skills​

  • OS角色:Compiler(编器)

  • 定位:用於编寫和测試其他技能。

  • 核心機制:Meta-TDD.

  • Testing:通過「壓力測試本攻墅Agent,看它是否遵守规则。

  • CSo:ClaudeSearchOptimization,教你如何寫description以便被語義检

索命中。

  • 解析:系统的自我進化機制。它證明了PromptEngineering不是玄學,而是可以被测

試、被度量的工程學科。 總結:工程化的勝利 Superpowers的這14個技能,没有一個是關於「如何寫出更優美的詩歌或「如何進行哲 学思考:的。它們全部聚焦於件工程(SoftwareEngineering)的核心難題: L.離度管理(writing-plans,brainstorming)

2.状態管理(using-git-worktrees,finishing-a-development-branch)​

3.質量控制(SDD,TDD,verification)​

1.機制(systematic-debugging)​

這就是一套完整的AI工程師培餐方案。它通過代碼和文檔,將人類高級工程師的性知識 (Tacit Knowledge)顯性化爲Agent 必须遵守的性協(ExplicitProtocols)。 填目檔案(RepositoryProfile)

  • Repository: obra/superpowers

  • Description:A complete software development workflow for your

coding agents.

  • Stars: 35.1k+ | License: MIT

  • Author: Jesse Vincent (@obra)

  • Core Components: Skills, Hooks (Claude Code), Agents, Rules

Unmarco dehabilidades paraagentes yuna metodologiade desarrollo de software que funciona. Un marco de habilidades para agentes y una metodologia de desarrollo de software que funciona.

原始排版图​

Superpowers 一個 AI Agent 的控制論操作系統：微信公众号导出原始排版图