我先读一下同类稿件已有的取证经验，同时检索这个开源项目和 “30 万 star” 说法的原文出处。
这个 “30 万 star” 需要先确认到底指哪个仓库，我再定向核对一次。
这套 30 万 star 的开源方法论叫 Superpowers，仓库是 obra/superpowers，作者是资深开源开发者 Jesse Vincent（GitHub ID: obra）。它不是一个新工具，而是一堆纯 Markdown 写的 skill 文件加一个会话启动钩子，装进 Claude Code、Codex、Cursor 这类 AI 编码助手之后，用 “强制流程” 而不是 “建议” 的方式给助手立规矩：动手前先问清楚需求，动代码前先写规格和计划，写代码前先写会失败的测试，宣布完成前必须先跑验证。截至 2026 年 10 月 16 日的 GitHub 快照，它的 star 数是 300,156；同一批仓库里，Matt Pocock 的 mattpocock/skills 在 11 月 1 日已经到 307,711，两者是同一个量级的 “立规矩” 方案。它涨得这么快的原因不复杂：AI 编码助手缺的不是写代码的能力，是纪律，而这套东西第一次把高级工程师的工作纪律完整编码成了 Agent 能读、能执行的字面步骤。
一、它到底是什么，不是什么
| 项目 | 口径 |
|---|---|
| 仓库 | github.com/obra/superpowers |
| 作者 | Jesse Vincent（GitHub ID: obra），资深开源开发者 |
| 上线时间 | 2025 年 10 月 9 日，赶上 Claude Code 开放插件系统 |
| star 快照 | 300,156（2026-10-16） |
| 形态 | 十余个可组合 skill（纯 Markdown 文件）＋一段会话启动指令 |
| 安装方式 | Claude Code 插件市场一行安装，另给 Codex、Cursor、Gemini CLI、OpenCode、Qwen Code、Kimi Code 等 17 种以上工具的装法 |
| 自我定位 | README 原话是 “给 Coding Agent 的一套完整软件开发方法论” |
几个容易误解的点：
- 它不加模型能力，也不改模型参数，装完你还是用同一个模型。
- 它不是提示词模板合集，装完会在会话启动时注入一段引导语，第一句大意是 “你现在有 Superpowers，立刻去读……”，让 Agent 自己把流程读进上下文。
- 它不靠你记得提醒。README 里写得很硬：“Mandatory workflows, not suggestions”—— 强制流程，不是建议。
二、它立的规矩，具体是七步
| 步骤 | 对应的 skill | 干的事 |
|---|---|---|
| 1 | brainstorming | 你说 “帮我做个 X”，它不动手，先退一步问清楚到底要做什么；小改动在对话里对齐，大项目产出一份设计文档 |
| 2 | using-git-worktrees | 设计确认后自动开一个隔离的 Git worktree，主工作目录不受影响，先跑一遍确认测试基线是干净的 |
| 3 | writing-plans | 把工作拆成 2 到 5 分钟一颗的小任务，每颗带精确文件路径、完整代码、验证步骤 |
| 4 | subagent-driven-development / executing-plans | 每个任务派一个全新上下文的子 Agent 执行并逐个审查；或当前会话内联执行、最后整体审一次 |
| 5 | test-driven-development | 强制 RED-GREEN-REFACTOR：先写失败测试、看它失败、写最小实现、看它通过、提交 |
| 6 | requesting-code-review | 任务之间做代码审查，按严重程度报问题，关键问题阻塞后续任务 |
| 7 | finishing-a-development-branch | 跑完测试后给选项：合并、开 PR、保留分支、丢弃，并清理 worktree |
流程之外还有一批零件：systematic-debugging 做四阶段根因分析，verification-before-completion 确认 “真的修好了” 而不是 “看起来好了”，dispatching-parallel-agents 管并行子 Agent，writing-skills 教 Agent 怎么写新技能（作者把这套叫 “给 skill 做 TDD”）。
三、最硬的三条规矩
- 先写测试，先于测试写出来的代码会被删掉。不是提醒你补测试，是删掉重来 —— 这是整套方法论里最 “不客气” 的一条，也是最容易被劝退的一条。
- 计划要写到最不可靠的执行者也能照做。README 里有句原话，要求计划清晰到 “一个热情但品味差、没判断力、不了解项目、还讨厌写测试的初级工程师” 也能照着执行。这句是整个项目最锋利的洞察：计划不是写给你看的，是写给队列里那个最不可靠的执行者看的。
- 没有验证就不算完成。verification-before-completion 专门堵 “AI 说做完了但其实没做完”，要求跑测试、查文件、验接口，而不是听它汇报。
四条设计哲学也很老派，README 原文分别是：永远先写测试；系统化优于临时起意；以简单为第一目标；先验证再宣布成功。没有一条是新的，新的是把它编码成了可执行流程。
四、规矩怎么生效：机制比内容更值得学
- 启动注入：SessionStart 钩子在每次会话开头塞进引导语，Agent 不用你提醒就知道有哪些流程。
- 强制而非建议：流程写的是 “必须”，不是 “可以考虑”，减少模型在压力下走捷径的空间。
- 可组合：skill 是一个个独立文件，可以只装其中几个，也可以改。
- 跨工具：同一份 SKILL.md，Claude Code、Codex、Cursor 都能读，这也是它能扩散到 17 种以上工具的原因。
- 可自我诊断：仓库里甚至有一个 diagnosing-superpowers，用来自查这套方法论自己哪里出了问题，会读会话记录、按行给证据。
五、30 万 star 是怎么涨起来的
| 时间 | 节点 |
|---|---|
| 2025-10-09 | 项目上线，正好卡在 Claude Code 插件系统开放的那一周 |
| 2025 年底 —2026 年初 | 作者每月写一篇博文记录自己用 Agent 的方法演变，边写边往仓库里搬 |
| 2026 年上半年 | skill 生态爆发，SKILL.md 成为跨工具事实标准，方法论类 skill 开始被大量转发 |
| 2026-10-16 | 300,156 star，成为 “方法论流派” 的代表作 |
真正推动它的，是三件当时没人做的事：
- 把隐性知识显性化。老工程师 “先想清楚再动手”“先写测试” 的直觉，第一次变成 Agent 能读的字面步骤。
- 把纪律做成流程。模型最容易犯的错是猜需求、写太多、顺手改无关代码、没验证就说完成，这七步几乎一步一防。
- 把方法论做成可分发的东西。纯 Markdown，没有依赖、没有编译、没有私有格式，谁都能 fork 改。
六、同一个量级的另一个选择
| 维度 | obra/superpowers | mattpocock/skills |
|---|---|---|
| star | 300,156（2026-10-16） | 307,711（2026-11-01） |
| 作者 | Jesse Vincent | Matt Pocock，TypeScript 教育者，Total TypeScript 作者 |
| 定位 | 一整套强制流程，接管整个开发周期 | 一批小而可组合的 skill，不接管流程 |
| 代表能力 | brainstorming、writing-plans、强制 TDD、子 Agent 执行、代码审查 | /grill-me 反问式需求对齐、spec-driven-development、constraint-driven-development、TDD、code-review、handoff |
| 对 “重框架” 的态度 | 自己就是重框架 | 公开批评 GSD、BMAD、Spec-Kit 这类接管流程的框架，主张 “小、容易改、可组合” |
| 适合谁 | 任务大、模型可靠性不够、团队要统一纪律 | 想按需取用、自己改造、渐进加约束 |
两者不是替代关系。一个把规矩写满，一个把规矩拆小；一个适合当 “教材＋强制流程”，一个适合当 “日常零件库”。
七、“立规矩” 这件事的整体数据
单看一个仓库容易高估，横向数据更能说明 “给 AI 编码助手立规矩” 已经变成普遍做法：
| 指标 | 数据 | 来源口径 |
|---|---|---|
| 有 Agent 指令文件的热门活跃仓库占比 | 26.3% | 22,854 个 ≥1000 star 仓库的普查（2026-10-16 枚举） |
| 最高 star 那一档的占比 | 59.6% | 同上，89 个最高 star 仓库 |
| 指令文件字数中位数 | 818 词（10% 分位 163 词，90% 分位 3,010 词） | 同上 |
| 至少含一条规则的指令集 | 98.2% | 同上 |
| 指令里不给理由的比例 | 74.0% | 同上 |
| 带生成器痕迹（如 /init 生成的模板）的比例 | 33.1% | 同上 |
| 使用 AGENTS.md 的开源项目 | 60,000+ | agents.md 官方站口径，2026 年 8 月 |
| AGENTS.md 治理归属 | Linux Foundation 下的 Agentic AI Foundation（2025-12-09 捐赠） | 官方站与多家独立梳理 |
几个和 “立规矩” 直接相关的细节：
- 规则要求最具体的是协作产物：PR 描述里最常见的要求是附测试计划（27.2% 的相关文件），commit 信息里最常见的是 Conventional Commits 格式（36.7%）。
- 关于 AI 署名，项目之间是分裂的：commit 信息里 7.5% 的仓库禁止 AI 署名，也有 59 个仓库要求署名；PR 里 5.8% 要求披露 AI 使用、1.9% 禁止。
- Claude Code 从 v2.1.277（2026 年 9 月）起可以原生读 AGENTS.md，但默认只在没有 CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md 时才读；想两个都读，要在 /config 里把 Project instructions 改成 claude-md-and-agents-md。
- Codex 的指令文件默认有 32 KiB 上限，超了会截断，需要拆成嵌套文件或调 project_doc_max_bytes。
八、用之前要想清楚的四件事
- 它很重。七步流程每一步都是对模型某次翻车的防御，防御工事不会因为威胁消失就自动拆除，token 和时间成本是实打实的。
- 模型越强，部分环节越像空转。brainstorming 对新一代模型常常已经不需要，计划可以粗一档，测试不一定每次都从 RED 开始，“模型越强、规矩越少” 是另一派的核心主张。
- star 不等于采用。star 只说明这一天有多少人点了收藏，不代表有多少人真在跑；这类仓库的具体工具半衰期很短，今天 30 万 star，明年可能就没人维护。
- 对手里还有 “更轻” 的做法。如果只是想让助手别乱猜、别乱改，四条原则写进 AGENTS.md 或 CLAUDE.md 就够用，不必上整套流程。
比较务实的路径是三步：先读 brainstorming 和 writing-plans 两个 SKILL.md 源码，看高手怎么把流程写成文字；再拿一个小需求完整跑一遍七步，建立手感；最后只把对你有效的一两个环节偷出来，做成二十行的轻量版挂在自己的配置里。
【相关 FAQ】
问题 1：这个 30 万 star 的开源方法论到底叫什么，装进去会改变什么？
回答 1：它叫 Superpowers，仓库是 obra/superpowers，是一套 30 万 star 的开源方法论，形态是十余个 Markdown 写的 skill 加一个会话启动钩子。装进去不会提升模型能力，改变的是工作顺序：先对齐需求、再写规格与计划、再写失败测试、再实现、再审查、最后验证并收尾，而且这些步骤是强制的，不是建议。
问题 2：给 AI 编码助手立规矩，为什么这套 30 万 star 的开源方法论非要强制 TDD？
回答 2：因为 AI 编码助手最常见的失败不是写不出代码，而是 “没验证就说做完了”。这套 30 万 star 的开源方法论用 RED-GREEN-REFACTOR 把 “完成” 变成可检验的状态：先写会失败的测试、看它失败、写最小实现、看它通过，甚至会把先于测试写出来的代码删掉重来。给 AI 编码助手立规矩的核心就在这里 —— 把口头承诺换成可执行的验收条件。
问题 3：给 AI 编码助手立规矩，是不是装了这个 30 万 star 的开源方法论就万事大吉？
回答 3：不是。这套 30 万 star 的开源方法论成本很高，七步流程每一步都要花 token 和时间，对简单任务属于过度防御；模型能力变强之后，头脑风暴、细粒度计划这些环节常常变成空转。更合理的用法是给 AI 编码助手立规矩时按项目规模选强度：大任务、多人协作、模型可靠性不足时上全套，小改动直接用 AGENTS.md 里的几条原则就够。
问题 4：除了这个 30 万 star 的开源方法论，还有别的给 AI 编码助手立规矩的路子吗？
回答 4：有，而且更轻。一条路是 mattpocock/skills（2026-11-01 达 307,711 star，同属 30 万 star 量级），把规矩拆成小颗粒 skill，可按需装、可自己改，公开反对接管整个流程的重框架；另一条路是只写一份 AGENTS.md 或 CLAUDE.md，用命令、边界、验收标准三块内容给 AI 编码助手立规矩，目前已有 60,000 多个开源项目采用 AGENTS.md。
【参考资料】
[2026-11-06]（AGENTS.md Guide: Format, Example and Tool Support (2026)）Freaky Jolly
[2026-11-03]（GitHub 上最值得装的 8 个 Agent Skill 仓库，亲测好用！）腾讯云开发者社区
[2026-11-01]（Matt Pocock's coding agent skills hit 307,000 GitHub stars）NoTechGuy
[2026-10-16]（30 万 Star 的 Superpowers：我通读源码，看它怎么把 Claude Code 驯成靠谱工程师）jackssybin 博客
[2026-10-16]（What Open-Source Projects Tell Their Coding Agents: A Census of AGENTS.md and CLAUDE.md）arXiv
[2026-10-13]（主文《模型越强，规矩越少》附录：Skill 生态全景与新手学习路线）新浪财经（转载 21ic 电子网）
[2025-11-25]（How to write a great agents.md: Lessons from over 2,500 repositories）GitHub Blog
【免责声明】
本文为公开信息整理，star 数、字数中位数、占比等均为特定日期快照，会随时间变化；仓库版本与 skill 数量在不同报道中口径不一，本文按 “十余个可组合 skill” 概括，具体以仓库当前版本为准。文中对方法论 “重”“空转” 的评价属分析判断，不代表作者或仓库官方立场；star 数、fork 数只是热度代理指标，不等于实际采用率或效果验证。本文不构成技术选型、采购或投资建议，落地前请自行阅读仓库 README 与 SKILL.md 原文。