# @cobuild/repo-tools 中文文档

规范地址：https://npmcn.com/package/%40cobuild/repo-tools/

版本：0\.1\.18
npm 元数据更新时间：2026-10-18T21:22:44.491Z
中文译文更新时间：2026-11-10T05:04:19.502Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：106 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-03-05T21:45:21.352Z
- 最新版本发布：2026-10-18T21:22:44.031Z
- 近 30 天下载量：3491（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：13（近 12 个月 13 个）

## 中文简介

Cobuilding 重置共享仓库操作工具

## 安装

```sh
npm install @cobuild/repo-tools
```

也可以使用：`pnpm add @cobuild/repo-tools`、`yarn add @cobuild/repo-tools`、`bun add @cobuild/repo-tools`

## README

# @cobuilding/repo-tools (英语)

Cobuilding repos 共享寄存器操作工具 .

## 技能

这种repo不再托管可安装的Codex技能.

`work-with-pro` 现在住在这里 `review-gpt`从公共回收中安装:

```bash
npx skills add https://github.com/cobuildwithus/review-gpt --skill work-with-pro
```

## 工具

-   `cobuild-open-exec-plan`
-   `cobuild-close-exec-plan`
-   `cobuild-doc-gardening`
-   `cobuild-check-agent-docs-drift`
-   `cobuild-committer`
-   `cobuild-package-audit-context`
-   `cobuild-sync-dependent-repos`
-   `cobuild-switch-package-source`
-   `cobuild-update-changelog`
-   `cobuild-generate-release-notes`
-   `cobuild-release-package`

`cobuild-close-exec-plan` 替换所包 `Status:` 段落通过下一个段落 空白行,元数据字段,或标题,保留计划的其余部分. 消费者 包括墨菲需要公布的包装升级才能得到这个更正.

## 配置

`cobuild-check-agent-docs-drift`, (中文(简体) ), `cobuild-doc-gardening`, (中文(简体) ), `cobuild-committer`,以及 `cobuild-package-audit-context` 从环境变量读取配置,这样每个消耗回波都只能保存薄薄的包装.

支持的 vars :

-   `COBUILD_DRIFT_REQUIRED_FILES`: 新建线- 受限的所需 doc 文物路径 .
-   `COBUILD_DRIFT_CODE_CHANGE_PATTERN`: 代码/进程敏感文件的扩展正则ex.
-   `COBUILD_DRIFT_CODE_CHANGE_LABEL`: 代码/doc耦合失败的信息前缀.
-   `COBUILD_DRIFT_LARGE_CHANGE_THRESHOLD`: 文件计数阈值,需要活动计划.
-   `COBUILD_DRIFT_CHANGED_COUNT_EXCLUDE_PATTERN`: 不包括大变动计数的文件的扩展正则x.
-   `COBUILD_DRIFT_ALLOW_RELEASE_ARTIFACTS_ONLY`: 设置为 `1` 以允许只释放艺术行为,而不更新文件.
-   `COBUILD_DOC_GARDENING_EXTRA_TRACKED_PATHS`: 外部新建线外限制的额外跟踪医生路径 `agent-docs/**`。 。 。 .
-   `COBUILD_COMMITTER_EXAMPLE`: 验证失败时显示的常规委员会实例.
-   `COBUILD_COMMITTER_ALLOWED_TYPES`: 可选逗号或新线限定的常规提交类型 `cobuild-committer`默认为 `feat,fix,refactor,build,ci,chore,docs,style,perf,test,release`。 。 。 .
-   `COBUILD_COMMITTER_DISALLOW_GLOBS`:新线- 受限制的外壳花纹, 不可执行 .
-   `COBUILD_AUDIT_CONTEXT_PREFIX`: 审计包的默认输出文件名前缀.
-   `COBUILD_AUDIT_CONTEXT_TITLE`:合并后文本捆绑中使用的标题.
-   `COBUILD_AUDIT_CONTEXT_REPO_LABEL`: 帮助文本中使用的repo标签.
-   `COBUILD_AUDIT_CONTEXT_SENSITIVE_NOTE`: 附加到帮助文本中的可选附加句.
-   `COBUILD_AUDIT_CONTEXT_INCLUDE_TESTS_DEFAULT`, (中文(简体) ), `COBUILD_AUDIT_CONTEXT_INCLUDE_DOCS_DEFAULT`, (中文(简体) ), `COBUILD_AUDIT_CONTEXT_INCLUDE_CI_DEFAULT`: 默认包括切换( n)`0` 或者说 `1`) (中文(简体) ).
-   `COBUILD_AUDIT_CONTEXT_ALWAYS_PATHS`: 新行限制总是包含文件路径 .
-   `COBUILD_AUDIT_CONTEXT_SCAN_SPECS`, (中文(简体) ), `COBUILD_AUDIT_CONTEXT_TEST_SCAN_SPECS`, (中文(简体) ), `COBUILD_AUDIT_CONTEXT_DOC_SCAN_SPECS`, (中文(简体) ), `COBUILD_AUDIT_CONTEXT_CI_SCAN_SPECS`: 新建线下扫描光谱 `dir` 或者说 `dir:glob` 形式.
-   `COBUILD_AUDIT_CONTEXT_PRUNE_DIR_NAMES`: 新行- 已限定目录名称被排除在基于扫描的选择之外, 并过滤被屏蔽的本地- residued checks .
-   `COBUILD_AUDIT_CONTEXT_EXCLUDE_GLOBS`:新线-受限外壳被从清单中排除.
-   `COBUILD_AUDIT_CONTEXT_EXCLUDE_SENSITIVE`: 设置为 `1` 从清单中去掉常见的秘密/存档路径.
-   `COBUILD_AUDIT_CONTEXT_VALIDATE_SOLIDITY_IMPORT_CLOSURE`: 设置为 `1` 要求固态进口在货单内保持封闭.
-   `COBUILD_RELEASE_PACKAGE_NAME`: 共享释放流的预期包名.
-   `COBUILD_RELEASE_REPOSITORY_URL`: 共享发布流的可选预期寄存器 URL.
-   `COBUILD_RELEASE_CHECK_CMD`: 可选放行检查命令; 默认为 `npm run release:check`。 。 。 .
-   `COBUILD_RELEASE_COMMIT_CMD`: 可选输入帮助路径; 默认为 `scripts/committer`。 。 。 .
-   `COBUILD_RELEASE_COMMIT_TEMPLATE`: 可选 `printf` 模板; 默认为 `chore(release): v%s`。 。 。 .
-   `COBUILD_RELEASE_TAG_MESSAGE_TEMPLATE`: 可选标记注释模板; 默认为 `v%s`。 。 。 .
-   `COBUILD_RELEASE_NOTES_ENABLED`: 设置为 `1` 生成释放注释.
-   `COBUILD_RELEASE_NOTES_DIR`: 可选发布注释输出目录;默认为 `release-notes`。 。 。 .
-   `COBUILD_RELEASE_POST_PUSH_CMD`:可选 shell 命令在被推出后运行.
-   `COBUILD_RELEASE_POST_PUSH_SKIP_ENV`:可选的env var名称;如果env var是 `1`跳过后推钩.

## 释放

-   `pnpm run release:check`
-   `pnpm run release:patch`
-   `pnpm run release:minor`
-   `pnpm run release:major`
-   `pnpm run sync:repos -- --version <semver>`

共享释放流量用途 `pnpm` 用于版本和发布检查,所以PNPM管理的重置重置程序保存 `pnpm-lock.yaml` 权威而非再创建 `package-lock.json`。 。 。 .

## 消费者最新政策

`@cobuild/repo-tools` 拟作为出版的包件从 `node_modules`而不是作为兄弟的退房.

-   目前直接工作场所的消费者: `v1-core`, (中文(简体) ), `wire`, (中文(简体) ), `interface`, (中文(简体) ), `chat-api`, (中文(简体) ), `cli`, (中文(简体) ), `indexer`, (中文(简体) ), `healthybob`,以及 `review-gpt`。 。 。 .
-   消费者包装脚本首先从已安装的 dev 依赖中解析 repo-tool bins, 所以一个兄弟 `repo-tools` 正常回波操作不需要克隆.
-   在一份公布的版本中修改了共享的bins,放出包装符,或配置插件合同后,故意地撞倒了受影响的同父异母兄弟重置,而不是假设代理商会推断推出.

典型的消费者突起指令 :

```bash
pnpm up @cobuild/repo-tools@<version>
```

现在的重播有相同的一个命令发布和弹出形状:

-   `scripts/release.sh` 可以打电话 `scripts/sync-dependent-repos.sh` 在推后和npm发布能见度后.
-   跳过下游自动起伏 `--no-sync-upstreams` 或者说 `REPO_TOOLS_SKIP_UPSTREAM_SYNC=1`。 。 。 .
-   手动运行相同的流程 `pnpm run sync:repos -- --version <semver> --wait-for-publish`。 。 。 .

## 实例

切换依赖到已发布的发布 :

```bash
pnpm exec cobuild-switch-package-source --package @cobuild/wire --field dependencies --published
```

切换依赖到本地链接 :

```bash
pnpm exec cobuild-switch-package-source --package @cobuild/wire --field dependencies --local ../wire
```

使用 repo- local 配置构建仅文本的审计捆绑 :

```bash
source scripts/repo-tools.config.sh
pnpm exec cobuild-package-audit-context --txt
```

仅通过先传递信件来提交明确命名的文件, 然后是每个精确路径 :

```bash
pnpm exec cobuild-committer "fix(tooling): keep generated output in sync" src/tool.mjs generated/tool.json
```

罪犯拒绝主动合并, 樱桃点心, 回归, 重建, `git am`,和测序器操作。 Hooks可能更新被命名的文件,但是它们可能不会去除一个最初选定的修改或者设置一个附加路径;列表中明确生成的输出. 在调和临时索引承诺时,保留现有的有舞台的快照.

`cobuild-package-audit-context` 现在阶段捆绑从 git- 可见文件, 在匹配 TypeScript 源代码兄弟姐妹时, 推倒未跟踪的 JS/声明侧车, 过滤常见的本地审查- 漏取残留物, 例如 `.env`, (中文(简体) ), `.next`, (中文(简体) ), `.test-dist`, (中文(简体) ), `dist`,以及 `*.tsbuildinfo` 从清单上看,没有实施广泛的针对具体建筑的禁止.

## 常见问题

### @cobuild/repo-tools 是什么？

Cobuilding 重置共享仓库操作工具

### 如何安装 @cobuild/repo-tools？

在项目目录运行 npm install @cobuild/repo-tools，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cobuild-committer、cobuild-doc-gardening、cobuild-open-exec-plan、cobuild-close-exec-plan、cobuild-release-package、cobuild-update-changelog、cobuild-sync-dependent-repos、cobuild-package-audit-context、cobuild-switch-package-source、cobuild-check-agent-docs-drift、cobuild-generate-release-notes，可以用 npx cobuild-committer 直接运行。

### @cobuild/repo-tools 支持 TypeScript 吗？

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

### @cobuild/repo-tools 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cobuild/repo-tools 可以商用吗？

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

### @cobuild/repo-tools 的下载量有多少？

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

### @cobuild/repo-tools 还在维护吗？

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