# @a2f0/agent-tool 中文文档

规范地址：https://npmcn.com/package/%40a2f0/agent-tool/

版本：0\.1\.53
npm 元数据更新时间：2026-11-06T22:18:55.269Z
中文译文更新时间：2026-11-05T22:25:19.483Z
软件包许可：UNLICENSED

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

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

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

- 包体积（解压后）：698 kB，99 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- 首次发布：2026-10-05T10:38:33.243Z
- 最新版本发布：2026-11-06T22:18:54.953Z
- 近 30 天下载量：12525（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 53 个）

## 中文简介

便携式跨代理审查、公关工作流程和共享技能

## 安装

```sh
npm install @a2f0/agent-tool
```

也可以使用：`pnpm add @a2f0/agent-tool`、`yarn add @a2f0/agent-tool`、`bun add @a2f0/agent-tool`

## README

# 代理工具

代理工具是一个命令行工具和一组寄存器的可移植技能 claude Code, Codex, OpenCode 或 Hermes 进行修改的地方. 它提供共享基特, GitHub,审查、验证和发布工作流程:独立代理审查 坚守的分行 严密的推力 和被审查的合并 承诺、软件包版本、品牌图像渲染、截图 框架无边廊,以及用于吵闹命令的紧凑输出。 仓库政策留在 `agent-tool.json`; 便携式技能 协调独立审查的修改.

## 快开始

安装 [阿宝](https://bun.sh/) 1.3.11或更新和Git,然后在项目中 将使用代理工具 :

```sh
bun add --dev --exact @a2f0/agent-tool
bun run agent-tool init
bun run agent-tool skills install --apply
bun run agent-tool doctor
```

安装技能后重新启动代理设备, 如果其发现缓存需要 令人兴奋.

Npm包船源和嵌入式技能没有安装脚本. Bun 运行 npm 工程也需要在 PATH 上的 Bun :

```sh
npm install --save-dev --save-exact @a2f0/agent-tool
```

版本准备需要 Bun 1.4 或 更新 。 GitHub 操作需要一个 认证 `gh` 支助 `pr checks --json`,独立审查要求 认证的 Claude 代码、 Codex 或 OpenCode CLI。 独立编译 可执行文件在运行时不需要 Bun 或节点 .

添加 `"agent-tool": "agent-tool"` 用于软件包脚本,或引用 `node_modules/.bin/agent-tool` 直接说 为空使用直接可执行文件 位置参数。 全球 `--repo <directory>` 财务报告和审定财务报表 `--config <file>` 选择一个 退出和明确的政策文件.

## 正常用途

```sh
agent-tool branch create chore/maintenance --base main --remote origin
agent-tool repo context
agent-tool bun test --log
agent-tool review claude
agent-tool branch push <reviewed-head> --remote origin
agent-tool pr open 'chore: maintain repository' --body-file /tmp/pr-body.txt
agent-tool pr checks --wait --head <reviewed-head>
agent-tool pr preflight <reviewed-head> <base-branch> <reviewed-base>
agent-tool pr merge 'chore: maintain repository' <reviewed-head> <base-branch>
```

捆绑起来 `ship-pr` 技能运行全验证、版本、独立 从您的代理商获取的审查、反馈、合并、清理和部署工作流程 绳子。 这个 [CLI 参考](https://npmcn.com/package/%40a2f0/agent-tool/docs/reference.md#commands) 解释什么是审查 结果意味着,以及 [共享工作流程](https://npmcn.com/package/%40a2f0/agent-tool/docs/workflows.md) 描述每个 仓库命令的合同.

## 发展

安装代理工具 [爱](https://mise.jdx.dev/)运行 从克隆取出 :

```sh
mise install
bun install --frozen-lockfile
bun src/index.ts --help
bun test --parallel=2
```

[发展](https://npmcn.com/package/%40a2f0/agent-tool/docs/development.md) 覆盖源版式, 完整 验证套件和释放程序.

## 文档

-   [共享工作流程](https://npmcn.com/package/%40a2f0/agent-tool/docs/workflows.md)树枝 承诺信任 复制钩子, PR检查/线程、清理、CI聚合门、释放核查、耐用 验证收据和工具链/保护诊断.
-   [CLI 参考](https://npmcn.com/package/%40a2f0/agent-tool/docs/reference.md): 现有审查、版本、技能安装, 命令抓取、进口图检查、配置和分发合同.
-   [发展](https://npmcn.com/package/%40a2f0/agent-tool/docs/development.md): 设置、源版式、验证和发布 本软件包的程序.
-   [图像](https://npmcn.com/package/%40a2f0/agent-tool/docs/images.md):申报品牌来源和产出.
-   [截图](https://npmcn.com/package/%40a2f0/agent-tool/docs/screenshots.md):将捕获的截图装入 以及展示他们的画廊和旋转木马网络组件.
-   [权限](https://npmcn.com/package/%40a2f0/agent-tool/docs/permissions.md): 未批准运行的指令 Claude Code和Codex, 以及强制执行它的依赖命令.
-   [扶养费](https://npmcn.com/package/%40a2f0/agent-tool/docs/dependency-upgrades.md): 活动兼容性 限制和依赖更新的工作流程.
-   [设计](https://npmcn.com/package/%40a2f0/agent-tool/docs/design.md) 财务报告和审定财务报表 [提取历史](https://npmcn.com/package/%40a2f0/agent-tool/docs/extraction.md)页:1 边界、起源和明确的执行限制.

该工具不执行寄存器 JavaScript 作为策略, 绕过 Git hooks for 运输突变,丢弃本地编辑,或默默地削弱所需的CI检查. 项目建设、测试、部署预览、健康检查和专门检查 保留寄存器命令.

## 常见问题

### @a2f0/agent-tool 是什么？

便携式跨代理审查、公关工作流程和共享技能

### 如何安装 @a2f0/agent-tool？

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

### @a2f0/agent-tool 支持 TypeScript 吗？

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

### @a2f0/agent-tool 支持 ESM 还是 CommonJS？

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

### @a2f0/agent-tool 可以商用吗？

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

### @a2f0/agent-tool 的下载量有多少？

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

### @a2f0/agent-tool 还在维护吗？

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