# bigpowers 中文文档

规范地址：https://npmcn.com/package/bigpowers/

版本：2\.89\.1
npm 元数据更新时间：2026-11-03T03:54:57.229Z
中文译文更新时间：2026-11-03T06:21:57.255Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/bigpowers
原文对照：https://npmcn.com/package/bigpowers/?lang=original
项目主页：https://github.com/danielvm-git/bigpowers#readme
源码仓库：https://github.com/danielvm-git/bigpowers

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：11.1 MB，2063 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=14\.0\.0
- 运行依赖：8 个
- 首次发布：2026-05-23T17:58:18.869Z
- 最新版本发布：2026-11-03T03:54:57.088Z
- 已发布版本数：241（近 12 个月 241 个）

## 中文简介

73个代理技能，将17年的软件工程规程综合为单独开发人员的规定性方法

## 安装

```sh
npm install bigpowers
```

也可以使用：`pnpm add bigpowers`、`yarn add bigpowers`、`bun add bigpowers`

## README

# bigpowers——一流的代理技能

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg) ![npm version](https://img.shields.io/npm/v/bigpowers.svg) ![Skills](https://img.shields.io/badge/skills-80-brightgreen.svg)

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

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

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

发表于npm： [bigpowers](https://www.npmjs.com/package/bigpowers)。上面徽章上的技能计数是由 `sync-skills.sh`;规范目录是 [`SKILL-INDEX.md`](https://npmcn.com/package/bigpowers/SKILL-INDEX.md).

文档: [Bigpowers docs网站](https://danielvm-git.github.io/bigpowers/) -可搜索，谷歌可发现的所有技能，指南和adr的参考。

**这种方法发表了自己的证据 [实时收据页面](https://danielvm-git.github.io/bigpowers/receipts/).**

**看看效果如何：** [bigpowers-showcase](https://github.com/danielvm-git/bigpowers-showcase) -一个真正的URL缩短器（CLI + SQLite）从头开始构建，从第一天起就提交了完整的规范。

* * *

## 如何阅读此README

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

| 你想… | 去 |
| --- | --- |
| 在30秒内试试 | [快速入门](https://npmcn.com/package/bigpowers/#readme--quick-start) |
| 理解它的实际作用 | [功能](https://npmcn.com/package/bigpowers/#readme--features) 和 [v2.0.0生命周期](https://npmcn.com/package/bigpowers/#readme--the-v200-lifecycle) |
| 学习它背后的思想 | [哲学上的堆栈](https://npmcn.com/package/bigpowers/#readme--philosophical-stack--how-these-ideas-concatenate) |
| 查资料 | [真理的层次](https://npmcn.com/package/bigpowers/#readme--hierarchy-of-truth) 和 [项目结构](https://npmcn.com/package/bigpowers/#readme--project-structure) |
| 将它连接到pi或MCP上 | [π的支持](https://npmcn.com/package/bigpowers/#readme--pi-support) 和 [MCP服务器](https://npmcn.com/package/bigpowers/#readme--mcp-server-model-context-protocol) |
| 贡献或修改它 | [开发](https://npmcn.com/package/bigpowers/#readme--development) 和 [贡献](https://npmcn.com/package/bigpowers/#readme--contributing) |

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

* * *

## 🚀快速入门

### npm(推荐)

```bash
# 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(参见 [先决条件](https://npmcn.com/package/bigpowers/#readme--prerequisites)）。

> **总销 `@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.  **确认**：检查并确认安装

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

![Interactive Installer](https://npmcn.com/package/bigpowers/docs/images/interactive-installer.png)

### 来源（贡献者）

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

* * *

## 🛠先决条件

-   **Bash**：所有脚本都需要。
-   **node . js**： v14+ （npm/npx需要）。
-   **金桥**：（强烈推荐）用于工具设置的稳健配置。
-   **AI工具**：其中一个或多个：
    -   [克劳德代码](https://claude.ai/code)
    -   [双子座CLI](https://github.com/google/gemini-cli)
    -   [光标](https://cursor.sh/)
    -   [π](https://pi.dev/) -编码剂线束

* * *

## ✨特性

-   **专门的技能**:从 `survey-context` 来 `develop-tdd`，每项技能都是特定发展阶段的目标工具。看到 [`SKILL-INDEX.md`](https://npmcn.com/package/bigpowers/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`](https://npmcn.com/package/bigpowers/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` 并不是一个简单的影响列表。这是一个 **年代分层蛋糕** -每一波思考都建立在前一波的基础上，并解决了前一波的紧张关系。没有层取代上一层；每一个都解决了前一个产生的问题。

![Philosophy Diagram](https://npmcn.com/package/bigpowers/docs/images/philosophy_diagram.jpg)

| 时代 | 来源 | 贡献 | 紧张的解决 |
| --- | --- | :-- | :-- |
| **2008** | [Bob大叔](https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882) (清洁代码) | SRP，童子军规则，F.I.R.S.T.测试，意图暴露的名字 | (基础) |
| **2018** | [Ousterhout](https://www.amazon.com/Philosophy-Software-Design-John-Ousterhout/dp/1732102201) （_软件设计哲学_） | 模块深度，信息隐藏，定义错误不存在 | 单独的小函数会创建带有臃肿接口的浅模块 |
| **2023 - 24** | [Karpathy](https://github.com/multica-ai/andrej-karpathy-skills)， [超级大国](https://github.com/obra/superpowers)， [可以排除](https://github.com/mattpocock/skills) | 思考优先的计划，动词-名词技能架构，放大策略 | 初级法学硕士没有纪律——他们需要的是编排，而不是原始的提示 |
| **2024** | [Wasowski](https://medium.com/@wasowski.jarek/sdd-writing-specifications-for-ai-bdd-as-the-missing-link-spec-driven-development-ad1b540b7f75) (SDD), [BCP](https://github.com/flow-ciandt/bcp-agent) | 规范作为人机界面；作为预构建规模单位的业务复杂性 | 代理在没有可验证规范的情况下漂移——BDD Gherkin关闭了这个循环 |
| **2026** | [秋田犬](https://akitaonrails.com/2026/04/20/clean-code-para-agentes-de-ia/) （_干净的AI代理代码_） | grep能力、结构化JSON日志、令牌经济、错误修复提示 | 鲍勃叔叔的规则是为人类编写的——代理需要不同的代码卫生 |
| **合成** | BMAD + GSD（自编） | 6阶段生命周期，硬门，94%质量阈值， `specs/state.yaml` 驾驶舱 | 以上都是原则；大国把它们变成了可执行的纪律 |

### 如何看到实际的连接

每个哲学支柱都有一个相应的小黄瓜 `.feature` 文件中 [`specs/verifications/features/`](https://npmcn.com/package/bigpowers/specs/verifications/features/) 这从经验上证明了遵从性：

| 支柱 | 验证 |
| --- | --- |
| 古典工艺 | `cleancode.feature` |
| 管理复杂性 | `pocock.feature` |
| 行为正直 | `karpathy.feature` |
| Spec-Driven发展 | 隐含在SDD工作流中 |
| Agentic标准 | `akita.feature` |
| 项目约定 | `conventions.feature` |
| 原始基线 | `superpowers.feature` |

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

* * *

## 📖真理的层次

| 水平 | 文档 | 责任 |
| --- | --- | :-- |
| **愿景** | `docs/PRINCIPLES.md` | 哲学基础与演化。 |
| **上下文** | `specs/tech-architecture/TECH_STACK_LATEST.md` | 技术堆栈、架构和领域说明。 |
| **范围** | `specs/product/SCOPE_LATEST.yaml` | 范围内/范围外和成功标准。 |
| **愿景** | `specs/product/VISION_LATEST.yaml` | 北极星和倡议成功标准。 |
| **决定** | `specs/adr/` | 架构决策记录（不可逆的选择）。 |
| **路线图** | `specs/release-plan.yaml` + `specs/epics/` | 具有BCP基线的wsjf优先级的史诗和故事。 |
| **当前的** | `specs/state.yaml` | 会话流、活动史诗、 `handoff.next_skill`时间戳。 |
| **指标** | `specs/metrics/cycle-times.yaml` | 每层BCP，周期分钟，BCP/小时（v2.0.0）。 |
| **指数** | `SKILL-INDEX.md` | 所有活动技能的规范列表（自动生成）。 |
| **风格** | `CONVENTIONS.md` | 编码、测试和命名标准。 |

* * *

## 📁项目结构

-   `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包安装

```bash
# 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`)，所以在安装完包后，运行 **一个命令 消费项目** 提供技能期望：

```bash
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工具，因此代理可以动态地发现和调用技能，而不是依赖于静态的系统提示。它是不活跃的，直到你注册它与您的代理-见下文。

### 启动服务器

```bash
node scripts/mcp-server.js
```

### 添加到Claude代码

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

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

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

### 可用的MCP工具

| 工具 | 描述 |
| --- | --- |
| `bigpowers_list_skills` | 列出所有技能的名称，描述，阶段。可选 `phase` 过滤器。 |
| `bigpowers_get_skill` | 获得全部技能。Md内容的任何技能的名称。 |
| `bigpowers_search_skills` | 关键字/语义搜索——为查询返回排序匹配。 |
| `bigpowers_get_state` | 得到当前 `specs/state.yaml` （活动流程，史诗，步骤）。 |
| `bigpowers_invoke_skill` | 获取带有可选代理调用上下文的技能说明。 |

* * *

## 🔄维护（更新和卸载）

### 更新

**npm安装:**

```bash
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克隆:**

```bash
git pull
npm run sync
bash scripts/install.sh
```

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

### 卸载

**npm安装:**

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

**git克隆:**

```bash
bash scripts/install.sh --uninstall
```

### 重新安装

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

* * *

## 🧪发展

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

### 测试

```bash
# 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](https://npmcn.com/package/bigpowers/CHANGELOG.md) 对于自动生成的提交历史记录，或 [释放](https://github.com/danielvm-git/bigpowers/releases) 查看GitHub发布说明。

要了解项目历史的执行叙述-在41天内发布了98个版本，4个阶段，交付了19个史诗-请阅读 [RELEASE-HISTORY.md](https://npmcn.com/package/bigpowers/docs/RELEASE-HISTORY.md).

### 链接

-   **存储库**： [https://github.com/danielvm-git/bigpowers](https://github.com/danielvm-git/bigpowers)
-   **问题跟踪器**： [https://github.com/danielvm-git/bigpowers/issues](https://github.com/danielvm-git/bigpowers/issues)

* * *

## 🙏确认

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

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

### 社区贡献者

大国是由贡献者塑造的，他们在自己的分支中扩展了它。 看到 [CONTRIBUTORS.md](https://npmcn.com/package/bigpowers/CONTRIBUTORS.md) 查看完整列表。

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

* * *

## 📄许可证

本项目在麻省理工学院许可下授权-参见 [许可证](https://npmcn.com/package/bigpowers/LICENSE) 文件查看详细信息。

* * *

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

## 常见问题

### bigpowers 是什么？

73个代理技能，将17年的软件工程规程综合为单独开发人员的规定性方法

### 如何安装 bigpowers？

在项目目录运行 npm install bigpowers，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 bigpowers、bigpowers-setup、bigpowers-dashboard，可以用 npx bigpowers 直接运行。

### bigpowers 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/bigpowers 是否存在。

### bigpowers 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### bigpowers 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### bigpowers 可以商用吗？

bigpowers 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### bigpowers 还在维护吗？

最新版本 2\.89\.1 发布于 2026/11/03（今天）；至今共发布 241 个版本，其中过去 12 个月发布了 241 个；首次发布于 2026/05/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。