# @drawbridge/drawbridge-agents 中文文档

规范地址：https://npmcn.com/package/%40drawbridge/drawbridge-agents/

版本：0\.1\.105
npm 元数据更新时间：2026-11-09T22:47:49.903Z
中文译文更新时间：2026-11-12T19:40:34.429Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：2.6 MB，130 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-05-26T06:27:56.907Z
- 最新版本发布：2026-11-09T22:47:49.729Z
- 近 30 天下载量：6032（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：90（近 12 个月 90 个）

## 中文简介

共享的代理指令内容(规则、代码样式、惯例),用于抽取桥-\*单列.

## 安装

```sh
npm install @drawbridge/drawbridge-agents
```

也可以使用：`pnpm add @drawbridge/drawbridge-agents`、`yarn add @drawbridge/drawbridge-agents`、`bun add @drawbridge/drawbridge-agents`

## README

# @ drawbridge/ drawbridge- 代理服务器

抽取桥- \* 单列的共享代理指令内容. 每一个取出桥\* repo所消耗的公约(规则、代码样式、图案)的一个词源 `CLAUDE.md` (和今后其他代理配置文件).

## 为什么会这样

在这个包裹之前,每个取出桥\* repo 都携带着同一个164行的字节-同文副本 `CLAUDE.md`更新规则意味着编辑13个地方,漂移是不可避免的。 现在,峡谷内容 住在这里;每个repo's `CLAUDE.md` 是一个很薄的文件 `@` 进口.

## 版式

```
conventions/                ← canonical, agent-neutral content (@-imported into CLAUDE.md)
  rules.md, javascript-formatting.md, ...
  ecosystem.md              ← always-loaded architecture map of the 16 repos
  cross-repo-contracts.md   ← load-bearing invariants that break across repos
  docs-linkage.md           ← consult the spec + @story/@doc code anchors
  graphify.md               ← query the family knowledge graph before grepping

claude/
  CLAUDE.md                 ← aggregator — @-imports every conventions/*.md

.claude-template/           ← the complete shared .claude/, mirrored into each consumer repo
  settings.json             ← permissions, additionalDirectories, drift-check Stop hook,
                              family-wide plugin marketplaces + enabledPlugins
  skills/                   ← shared skills (drawbridge-ship-feature, -asana-ship-handoff, ...)
  hooks/  agents/  commands/

.root-template/             ← mirrored to each consumer repo's root; files are stored DOTLESS
                              and the mirror restores the leading dot (one rule; also required
                              for npmrc since npm strips a literal .npmrc from tarballs)
  mcp.json                  → .mcp.json    project-level MCP servers (Sentry, Asana)
  editorconfig              → .editorconfig family-wide editor defaults (tabs, lf, utf-8)
  npmrc                     → .npmrc        save-exact=true (exact-pin convention)
  nvmrc                     → .nvmrc        family-standard node version (v22.23.4)

bin/
  sync-claude.js            ← drawbridge-agents-sync — mirrors templates + graphify preflight
  graph.js                  ← drawbridge-agents-graph — builds the merged family knowledge graph
  preflight-graphify.js     ← ensures the graphify runtime is installed (called by sync)

scripts/
  check-doc-links.js        ← drawbridge-agents-check-docs — validates @story/@doc tags resolve

hooks/
  drift-check.js            ← Stop hook (wired via .claude-template/settings.json)
  consult-docs-record.js    ← PostToolUse hook: remembers a docs page read / graph query per session
  consult-docs-gate.js      ← PreToolUse hook: refuses the first source edit until both happened
  qa-gate.js                ← PreToolUse hook on the Asana comment tool: every "quoted label" must have been walked or exist in source; a session that changed code needs a clean QA report
  guard-superpowers-docs.js ← PreToolUse hook: plans/specs go to drawbridge-docs
```

## 从吊桥取出\*

1.  作为安装 **依赖性** (这个软件包只是代理工具——没有应用运行时间进口) 因此,它不能运送生产/数字海洋:
    
    ```bash
    npm install --save-exact --save-dev @drawbridge/drawbridge-agents
    ```
    
    确保应用程序的安装步骤省略 devdependency(`npm ci --omit=dev`) (中文(简体) ).
    
2.  替换还款 `CLAUDE.md` 带有稀疏导入文件 :
    
    ```markdown
    @./node_modules/@drawbridge/drawbridge-agents/claude/CLAUDE.md
    ```
    
    添加任何 Repo 特定规则 **上文** 进口线.
    
3.  (可选) 导入本包中新增的狭义公约 :
    
    ```markdown
    @./node_modules/@drawbridge/drawbridge-agents/claude/CLAUDE.md
    @./node_modules/@drawbridge/drawbridge-agents/conventions/sync-side-effects.md
    ```
    
4.  扩大消费者范围 `npm run sync` 以映射共享 `.claude/` 模板 :
    
    ```json
    "sync": ". \"$HOME/.nvm/nvm.sh\" && nvm use && npm prune && npm install && npx drawbridge-agents-sync"
    ```
    
    在每一个 `npm run sync`,这个包将真实的单一来源映射到消费者身上:
    
    -   `.claude-template/` • 消费者 `.claude/` - 那个 **完整** 共享设置 : `settings.json` (许可, `additionalDirectories`,漂移检查停止钩),加 `skills/`, (中文(简体) ), `agents/`, (中文(简体) ), `commands/`, (中文(简体) ), `hooks/`。 。 。 .
    -   `.root-template/` − 消费者的回波根(`.mcp.json`, (中文(简体) ), `.editorconfig`(中文(简体) )
    
    模板中存在的路径是 **管理** (每个同步上覆盖)——每回波结束 上加一个相同的 `.claude/`。仅限 `settings.local.json` (每个 dev 的个人覆盖)和 任何仅限消费者使用的文件都无动于衷.
    

克劳德代码 `@` 进口级联——一条进口线解决下方的整棵树 `claude/CLAUDE.md`。 。 。 .

## 生态系统知识、图表和漂移检查

除了公约外,这个软件包还赋予了特工们交叉检索的能见度,并保持代码,docs, 和流出而来的知识图表。 此软件包是单个源; 每个 repo 得到一个 通过同步镜像获得相同的副本(见"交付模型").

-   **家庭知识图 (Graphify).** `npx drawbridge-agents-graph` 运行只有代码的 AST 逐一提取 `drawbridge-*` 将合并的图写到承诺的、共享的 地点 `drawbridge-docs/knowledge/graphs/global.json`代理查询到 `graphify` 国 际 (例如:. `graphify query "…" --graph ../drawbridge-docs/knowledge/graphs/global.json`改为 greping; 刷新是重建 + 承诺在文件 + `git pull` (无 npm/publish 循环). 这个 运行时间是一个每台机器 Python 工具—— `npm run sync` 安装它 (单位:千美元)`bin/preflight-graphify.js`页:1 `DRAWBRIDGE_SKIP_GRAPHIFY=1` 跳过 CI/无头。 我们 故意这样做 **没有** 运行 `graphify install` (将重写) `CLAUDE.md`);可选 `graphify-mcp` 如果您喜欢MCP,则服务器是可用的.
-   **Docs链接 + 校验器.** 特性代码携带 `@story <domain>/<slug>` 编号 : `@doc reference/<file>#<anchor>` 锚( 见 `conventions/docs-linkage.md`) (中文(简体) ). `npx drawbridge-agents-check-docs` 扫描每次重播, 如果主播不再解决则失败 反对 `drawbridge-docs`。 。 。 .
-   **漂泊检查停止钩.** `hooks/drift-check.js` 运行于每个任务收尾端,通过 漂移检查 `Stop` 钩入镜中 `.claude/settings.json`。 **块** 关于未解决的 医生锚和上 `@story`\-anchored 代码更改后没有绘制桥-文件更改(每名 转身;第二次尝试通过,所以特工必须回答),并且 **摇摆** (无阻塞)何时 图表看起来很僵硬。 它跳过计划模式,转动时没有源变化.
-   **秘密守护.** `hooks/guard-secrets.js` (PreTools Use on Read/Bash)拒绝读取任何 `.env*` 文件和一个显示一个、打印环境或打印环境的 Bash 命令 `op` 不重定向的值。 见 `conventions/secrets.md`。 。 。 .
-   **读取前作钩.** `hooks/consult-docs-record.js` (后工具在读取/ Bash 上使用) 在本会话中读取了绘图-文件页并运行了图表查询; `hooks/consult-docs-gate.js` (PreTools Use on Write/Edit) 拒绝第一个源编辑直到 都发生了 见 `conventions/docs-linkage.md`"强迫,不只是问".
-   **共享技能.** 镜像到每个回波 `.claude/skills/` (从) `.claude-template/skills/`: `drawbridge-ship-feature` (核实文件 ), `drawbridge-asana-ship-handoff`, (中文(简体) ), `drawbridge-explore-ecosystem`, (中文(简体) ), `drawbridge-record-contract`,以及卖方第三方 `impeccable` 设计技能 `impeccable-*` 代理人(参见 `conventions/design.md`) (中文(简体) ).

### 交付模式

每笔押金都有 **相同、正常化** 代理设置, 所有来源于此软件包 :

-   **`CLAUDE.md`** □ 单行 `@import` (从 `node_modules`) (中文(简体) ).
-   **`.claude/`** (设置.json + 权限+ 钩子,技能,代理/命令/呼克) → **镜像** 从 `.claude-template/` 和每笔押金.
-   **`.mcp.json`, (中文(简体) ), `.editorconfig`** ~ 照出从 `.root-template/` 和每笔押金.
-   配置文件( E)`.claude/`, (中文(简体) ), `.mcp.json`) 被复制而不是导入,因为只减少标记 (单位:千美元)`CLAUDE.md`() 支持 `@import`;镜像从一个来源保留了相同的拷贝.
-   包是一个 **依赖性** \* 从未安装在数字海洋上.
-   知识图被承诺一次 `drawbridge-docs/knowledge/graphs/`; 图表化 运行时间 + 构建缓存为每台机器 `~/.graphify/` (恶作剧). `graphify install` (编辑) `CLAUDE.md`从不运行.

## 更新规则或共享 `.claude/` 文件

1.  编辑相关的 `conventions/<file>.md` 或者说 `.claude-template/<path>`。 。 。 .
2.  弹出 `version` 内 `package.json` (样本:用于澄清的补丁,用于添加的规则/文件的次要部分,用于突破更改的主要部分).
3.  `npm audit` (每张画桥-\*出版会).
4.  `npm run build` (运行) `npm publish`) (中文(简体) ).
5.  在每一次消费回购中跳出精确的插件 `package.json` 财务报告和审定财务报表 `npm run sync`。 。 。 .

## 内容图(原出地-目的地)

这个包是从原包取出 `CLAUDE.md` 以前住在每座桥\*回放。 绘图:

| 原章节 | 文件 |
| --- | --- |
| `# Rules` (8个编号规则) | `conventions/rules.md` |
| `# JavaScript Formatting` (空格、结号、括号、逗号、分号、缩进) | `conventions/javascript-formatting.md` |
| `## Nested objects must always be expanded across multiple lines` | `conventions/nested-objects.md` |
| `## JSX Fragments` | `conventions/jsx-fragments.md` |
| `## Database Transactions` | `conventions/transactions.md` |
| `## Property shorthand` | `conventions/property-shorthand.md` |

## 常见问题

### @drawbridge/drawbridge-agents 是什么？

共享的代理指令内容\(规则、代码样式、惯例\),用于抽取桥-\*单列\.

### 如何安装 @drawbridge/drawbridge-agents？

在项目目录运行 npm install @drawbridge/drawbridge-agents，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 drawbridge-agents-bump、drawbridge-agents-sync、drawbridge-agents-graph、drawbridge-agents-check-docs、drawbridge-agents-check-stories、drawbridge-agents-check-streams、drawbridge-agents-release-doctor，可以用 npx drawbridge-agents-bump 直接运行。

### @drawbridge/drawbridge-agents 支持 TypeScript 吗？

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

### @drawbridge/drawbridge-agents 可以商用吗？

@drawbridge/drawbridge-agents 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @drawbridge/drawbridge-agents 的下载量有多少？

根据 npm 官方下载统计，@drawbridge/drawbridge-agents 在 2026/10/13 – 2026/11/11 这 30 天内被下载 6,032 次，日均约 201 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @drawbridge/drawbridge-agents 还在维护吗？

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