bigpowers——一流的代理技能

代理技能综合了17年的软件工程学科——从干净的代码到人工智能原生架构——为单独的开发人员提供了一个单一的、规定性的方法。

bigpowers 为使用AI代理（Claude Code, Gemini CLI, Cursor, pi）构建软件提供了一种规定性的垂直切片方法。它弥合了原始LLM能力和专业工程标准之间的差距。

它不是一个随机的最佳实践集合。这是一个按时间顺序排列的多层思想蛋糕——每一波思想（鲍勃叔叔→奥斯特胡特→卡帕西→瓦索夫斯基→秋田）都建立在上一波思想的基础上，并解决了上一波思想的紧张关系，最终形成了6个阶段的生命周期，包括硬门、94%的质量门槛和YAML座舱(specs/state.yaml)，使人类和代理在会话中保持一致。

发表于npm： bigpowers。上面徽章上的技能计数是由 sync-skills.sh;规范目录是 SKILL-INDEX.md.

文档: Bigpowers docs网站 -可搜索，谷歌可发现的所有技能，指南和adr的参考。

这种方法发表了自己的证据 实时收据页面.

看看效果如何： bigpowers-showcase -一个真正的URL缩短器（CLI + SQLite）从头开始构建，从第一天起就提交了完整的规范。

如何阅读此README

这个自述文件是一个引导路径，而不是一个参考墙。从你所在的地方开始：

安装之后，要求代理运行 using-bigpowers 技能——这是一次性的引导，它解释了生命周期，并告诉你在你的情况下首先调用哪个技能。

🚀快速入门

npm(推荐)

# Global install (no lifecycle scripts — npm v10+ safe)
npm install -g bigpowers@latest
bigpowers setup     # runs sync + install, links skills to your tools

# Or one-shot with npx (always fetches the newest release)
npx bigpowers@latest setup

这两个命令同步技能工件，并将它们链接到Claude Code、Gemini CLI和Cursor(参见 先决条件）。

总销 @latest. 随着大国在全球范围内的部署，一个赤裸的 npx bigpowers setup 重用陈旧的全局二进制和 npm update -g bigpowers 不能可靠地与最新版本交叉。 npm install -g bigpowers@latest 和 npx bigpowers@latest setup 强制每次获取注册表。

交互式安装程序

这个 npx bigpowers setup 命令启动一个交互式菜单，您可以：

1. 选择安装模式：安装/更新或卸载
2. 选择位置：全局（随处可用）或本地（仅限当前项目）
3. 选择工具：选择要安装技能的AI工具（Claude Code, Cursor, Gemini， pi等）
4. 确认：检查并确认安装

使用 箭头键 导航, 空间 选择，以及 输入 来确认。

来源（贡献者）

git clone https://github.com/danielvm-git/bigpowers.git && cd bigpowers
npm install
bash scripts/install.sh

🛠先决条件

• Bash：所有脚本都需要。
• node . js： v14+ （npm/npx需要）。
• 金桥：（强烈推荐）用于工具设置的稳健配置。
• AI工具：其中一个或多个：
  • 克劳德代码
  • 双子座CLI
  • 光标
  • π -编码剂线束

✨特性

• 专门的技能:从 survey-context 来 develop-tdd，每项技能都是特定发展阶段的目标工具。看到 SKILL-INDEX.md 获取完整的自动生成目录。
• Spec-Driven驾驶舱:使用 specs/state.yaml 和 release-plan.yaml 维护跨代理会话的状态，防止上下文漂移。
• 本机IDE支持：自动生成游标(.cursor/rules)、Gemini CLI和pi。
• 模型上下文协议（MCP）：通过包含的MCP服务器动态发现和调用工具。
• 内置质量门在任何代码合并之前执行严格的验证标准（例如，F.I.R.S.T测试，BCP会计）。

v2.0.0生命周期

每个项目都遵循 编排-项目6阶段模型 (完整的SOP: docs/WORKFLOW-SOP-v2.md):

ONE TIME    seed-conventions  (CLAUDE.md, .claude/, .gemini/, agents/, skill sync)
              ↓
ONCE/PROJECT orchestrate-project
              │
              ├─ Ph1 DISCOVER   survey-context, research-first, elaborate-spec
              ├─ Ph2 ELABORATE  model-domain, grill-me, define-language, deepen-architecture
              ├─ Ph3 PLAN       scope-work, slice-tasks, plan-work → release-plan.yaml (BCP baseline)
              ├─ Ph4 BUILD      build-epic × N stories
              │
              │  Per story — 8-step build-epic cycle:
              │   1. survey-context   ← stamps story_start in state.yaml
              │   2. plan-work        ← [BCP N] tasks + verify: commands
              │   3. kickoff-branch   ← worktree + feature branch
              │   4. develop-tdd      ← RED → GREEN → REFACTOR
              │   5. verify-work      ← UAT gate
              │   6. audit-code       ← quality gate ≥ 94%
              │   7. commit-message   ← Conventional Commits + semver
              │   8. release-branch   ← land to main; writes story_end + cycle-times.yaml
              │
              ├─ Ph5 VERIFY     run-evals, verify-work (project-level)
              └─ Ph6 RELEASE    semantic-release → v1.0.0 MVP tag

Semver: 项目于 0.0.0-β;每一个 feat: 故事→小颠簸；开发者宣布MVP 1.0.0.

BCP会计: 每个任务都标有 [BCP N];故事总数 state.yaml;BCP/hr记录到 specs/metrics/cycle-times.yaml.

next_skill信号: 每个关键路径技能都写 handoff.next_skill 来 state.yaml。呼叫 survey-context 在任何中断之后，重新回到你离开的地方。

🧠哲学堆栈-这些想法如何连接

bigpowers 并不是一个简单的影响列表。这是一个 年代分层蛋糕 -每一波思考都建立在前一波的基础上，并解决了前一波的紧张关系。没有层取代上一层；每一个都解决了前一个产生的问题。

如何看到实际的连接

每个哲学支柱都有一个相应的小黄瓜 .feature 文件中 specs/verifications/features/ 这从经验上证明了遵从性：

运行 npm run compliance 审计所有特性。评分< 94% =硬停。

📖真理的层次

📁项目结构

• skills/[skill-name]/： 80个技能的源文件。
• scripts/：安装、同步和遵从性工具。
• specs/： YAML座舱- state.yaml， release-plan.yaml， epics/， execution-status.yaml， requirements/.
• specs/metrics/：循环时间分类帐(cycle-times.yaml) -每层BCP，时间戳，BCP/小时（v2.0.0）。
• dashboard/：实时监控工具- TUI (npm run dashboard)及网页(npm run dashboard:web，端口7742)。
• docs/：指南包括 WORKFLOW-SOP-v2.md （完整的SDLC SOP）和 using-bigpowers.md.
• docs/references/理论基础（《鲍勃叔叔》、《奥斯特豪特》、《Karpathy》等）。

🔌pi支持

bigpowers生成pi特工技能和提示模板以及游标和双子神器 sync-skills.sh.

作为一个pi包安装

# Clone and sync to generate pi artifacts
cd bigpowers
bash scripts/sync-skills.sh

# Install from local path as a pi package
pi install .

# Or install as a pi npm package (once published with pi-package keyword)
pi install npm:bigpowers

提供一个消费者项目(bigpowers init）

派的包裹合同注册了 技能和提示 -没有资源 键入任意项目文件，安装时不会运行生命周期脚本。技能 引用包的 scripts/*.sh 与项目相关的工具(例如： bash scripts/run-skill-verify.sh，验证像这样的门 test -f scripts/... && test -d specs/bugs)，所以在安装完包后，运行 一个命令 消费项目 提供技能期望：

cd <your-project>
npx bigpowers init        # or: bigpowers init

这个符号链接 <project>/scripts →已安装的包 scripts/ 树和 支架 specs/bugs/ + specs/verifications/． 它拒绝（从不打击）a scripts/ 你已经拥有了； bigpowers init --remove 取消它。同样的步骤 适用于 npm i -g bigpowers / npx bigpowers setup 消费者。

你会得到什么：

• π的技能 在 .pi/skills/ (每个技能一个。-自动加载到pi的系统提示符为 <available_skills>
• PI提示模板 在 .pi/prompts/ -斜杠命令，如 /survey-context， /plan-work
• PI包舱单 在 .pi/package.json ——允许 pi install 与自动发现

技能通过渐进式披露按需加载：只有描述总是在上下文中；完整的技能。Md在代理读取时加载。在pi的编辑器中使用自动完成功能展开提示模板。

🔧MCP服务器（模型上下文协议）

bigpowers 包括 MCP服务器(scripts/mcp-server.js)，将技能目录公开为可调用的MCP工具，因此代理可以动态地发现和调用技能，而不是依赖于静态的系统提示。它是不活跃的，直到你注册它与您的代理-见下文。

启动服务器

node scripts/mcp-server.js

添加到Claude代码

claude mcp add bigpowers node /path/to/bigpowers/scripts/mcp-server.js

或者手动添加到 .claude/settings.json：

{
  "mcpServers": {
    "bigpowers": {
      "command": "node",
      "args": ["/path/to/bigpowers/scripts/mcp-server.js"]
    }
  }
}

可用的MCP工具

🔄维护（更新和卸载）

更新

npm安装:

bigpowers update   # fetches bigpowers@latest (global installs), then re-syncs + refreshes symlinks

bigpowers update 现在运行 npm install -g bigpowers@latest 对于你来说，当bigpowers在全球安装时，单独运行它就足以达到最新版本。喜欢手工做吗？ npm install -g bigpowers@latest && bigpowers update． (避免 npm update -g bigpowers -它不可靠地交叉到 @latest.）

git克隆:

git pull
npm run sync
bash scripts/install.sh

安装使用符号链接-重新运行安装程序将刷新链接而不复制文件。

卸载

npm安装:

bash "$(npm root -g)/bigpowers/scripts/install.sh" --uninstall
npm uninstall -g bigpowers

git克隆:

bash scripts/install.sh --uninstall

重新安装

npx bigpowers@latest setup
# or, if installed globally:
bigpowers update

🧪发展

git clone https://github.com/danielvm-git/bigpowers.git
cd bigpowers
npm install
# Sync artifacts from SKILL.md sources
npm run sync

测试

# Run compliance verification against Gherkin features
npm run compliance

# Validate YAML specifications and doctrine
npm run doctrine
npm run validate-specs

🤝贡献

1. 分叉回购。
2. 创建一个特性分支(git checkout -b feature/my-thing）。
3. 进行更改 bigpowers 方法。
4. 使用常规提交(git commit -am 'feat: add my thing'）。
5. 推到分支(git push origin feature/my-thing）。
6. 打开拉取请求。

更新日志

看到 CHANGELOG.md 对于自动生成的提交历史记录，或 释放 查看GitHub发布说明。

要了解项目历史的执行叙述-在41天内发布了98个版本，4个阶段，交付了19个史诗-请阅读 RELEASE-HISTORY.md.

链接

• 存储库： https://github.com/danielvm-git/bigpowers
• 问题跟踪器： https://github.com/danielvm-git/bigpowers/issues

🙏确认

这个项目是几十年来软件工程思想的综合。如果没有作者的基础工作，这是不可能的，他们写了鼓舞人心的文章和书籍，形成了这种方法：

• 罗伯特·c·马丁（鲍勃叔叔） 建立代码卫生和F.I.R.S.T原则的基线 干净代码.
• 约翰Ousterhout 以表彰他对深度模块和复杂性管理的范式转换观点 软件设计哲学.
• Andrej Karpathy 和 马特可以排除 表彰他们在代理技能和构建法学硕士环境方面的开创性工作。
• Jarek Wasowski 以确定规范驱动开发（SDD）是人工智能代理的缺失环节。
• AkitaOnRails 将经典的干净代码原则应用于人工智能代币经济的现实。

社区贡献者

大国是由贡献者塑造的，他们在自己的分支中扩展了它。 看到 CONTRIBUTORS.md 查看完整列表。

• 凯文·奥伯利斯（favilo） -柔术VCS跨生命周期技能支持+ project-runtime.sh 可配置的设置库。
• XcluEzy7 - OMP插件扩展(extensions/omp-hooks.ts)：原生技能发现，统一的技能工具，以及oh-my-pi运行时的礼物安全挂钩。

📄许可证

本项目在麻省理工学院许可下授权-参见 许可证 文件查看详细信息。

“简单是最高级的复杂，而正直是最高级的要求。”