# @dtlabs/ai-toolkit 中文文档

规范地址：https://npmcn.com/package/%40dtlabs/ai-toolkit/

版本：0\.29\.1
npm 元数据更新时间：2026-11-12T15:59:43.948Z
中文译文更新时间：2026-11-12T23:12:38.136Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.6 MB，106 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-07-14T12:44:35.698Z
- 最新版本发布：2026-11-12T15:59:43.708Z
- 近 30 天下载量：4529（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：76（近 12 个月 76 个）

## 中文简介

AI工具箱——开发者用于构建AI动力应用程序的可重复使用的代理和程序.

## 安装

```sh
npm install @dtlabs/ai-toolkit
```

也可以使用：`pnpm add @dtlabs/ai-toolkit`、`yarn add @dtlabs/ai-toolkit`、`bun add @dtlabs/ai-toolkit`

## README

# @dtlabs/ai-toolkit — 大赦国际工具包

可重复使用的Claude代码代理,技能,命令,以及端到端的软件特性交付和代码库评估程序——从要求到PR,从审计到补救.

## 来见见Gaia——你的工具包助理

一旦安装,最好的开始方式是说:

```
/hi-gaia
```

**盖亚** 是工具包的内置助手。 她自我介绍,扫描你的工作空间以了解背景(项目已经设置了吗? 并引导你走向正确的工具.

您也可以直接询问她具体的主题:

```
/hi-gaia feature       → how to build a new feature end-to-end
/hi-gaia assess        → how to audit and improve an existing codebase
/hi-gaia setup         → how to onboard a new project
/hi-gaia agents        → full catalog of available agents and skills
```

如果你不确定该用哪个指令或代理,盖亚就是正确的起点. 她不会运行任何东西——她帮助你理解工具包,并决定下一步要做什么.

* * *

## 它提供的东西

两个独立的管道:

### 特性输送管道

-   **12名探员** 完成整个交付生命周期(要求-技术-类别-工作故障-后端/前端/测试实施-建筑师审查)
-   **5个技能** 可通过斜线命令(`/install-toolkit`, (中文(简体) ), `/init-agents`, (中文(简体) ), `/implement-feature`, (中文(简体) ), `/define-feature`, (中文(简体) ), `/hi-gaia`(中文(简体) )
-   **4个命令** 用于快速的日常快捷键( :`/feature-status`, (中文(简体) ), `/check-docs`, (中文(简体) ), `/pr-description`, (中文(简体) ), `/next-task`(中文(简体) )

### 评估和补救管道

-   **10名代理人** 编码基础评估和定向补救(基因评估、分层审计、货币安全、神类分解、DI重构、域模型重构、安全强化、供应链安全、干预文件)
-   **1个技能** (单位:千美元)`/assess-codebase`在任何代码更改之前,使用人批准门运行完整的评估管道
-   **1个命令** (单位:千美元)`/assessment-status`用于检查正在进行的评估状况

### 共享

-   **4个通用程序** (代码生成、代码审查、安全编码、测试)项目可以覆盖本地

## 安装

**当地安装** (计入当前项目):

```bash
npx @dtlabs/ai-toolkit
```

**全球安装** (进) `~/.claude/`:

```bash
npm install -g @dtlabs/ai-toolkit
ai-toolkit --global
```

命令复制代理、技能、程序 `CLAUDE.md` 进入合适的地点.

## 如何运作

工具包船 **通用剂** 与任何项目。 每一代理机构都从下列来源阅读具体项目公约: `AGENTS.md` 中的文件。 运行 `/init-agents` 为新工程生成该文件.

通用程序在 `docs/procedures/`。项目可以通过将同名文件放在自己的位置来覆盖其中的任何项目 `docs/procedures/`特工先检查项目 然后回到工具箱.

## 所需的配置——子剂产卵深度

> ⚠️ **此设置对所规划的管道不是可选的 .** 没有它, `/implement-feature` 财务报告和审定财务报表 `/assess-codebase` 默而贬之.

该工具包建立在 **两级代理等级**: 管弦乐演奏家(`project-manager` 或者说 `assessment-manager`)作为子剂被产出,它反过来又孕育出专门的工人代理人(开发者,审查者,评估者),每个代理人在自己适合的角色模式上都有孤立的背景.

克劳德代码以来 **v2.1.217, 亚剂不能默认生成进一步的亚剂** (发作深度被封为1,故意防无约束回转扇出和成本. 在这种默认下,当一个管弦乐团作为副代理运行时,它有 **没有 `Agent` 工具** 因此,它不授权,而是执行每个工人的任务 _在自己的背景中,根据自己的模式_后果:

-   **代理代理模式转让停止生效** - 那个 `haiku`编号 :`sonnet`编号 :`opus` 对每种物剂的绘图从未应用过,因为这些物剂从未实际被产出. 一切运行在管弦乐队的模型.
-   **失去背景隔离** ——一长串管弦乐器上下文取而代之的是原意的逐剂隔离.
-   **代理代号遥测消失** 没有每名代理人 `<usage>` 块被释放,所以 `*-Token-Estimate.md` 只记录了总和的管弦乐手总数.

为使工具包按设计发挥作用,提高允许的深度 **2个** (主循环-管弦乐-工人). 这回波已经放进去了 [`.claude/settings.json`](https://npmcn.com/package/%40dtlabs/ai-toolkit/.claude/settings.json)数字 :

```json
{
  "env": {
    "CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH": "2"
  }
}
```

**当您将工具包安装到另一个项目时, 您必须自己添加此设置 .** 安装器`npx @dtlabs/ai-toolkit`, (中文(简体) ), `ai-toolkit --global`,则 `/install-toolkit` 代理人) **从不复制或编辑任何 `settings.json`** – 该文件是用户拥有的, 并自动合并它会冒打乱您现有的配置的风险. 相反,每个安装器 **检查** 是否为 `CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH` 设置为 `2`\+ 在目的地,如果缺少,则打印要添加的确切片段(至 `.claude/settings.json` 用于一个项目,或 `~/.claude/settings.json` (关于所有项目)。 在添加后, 重新启动 Claude 代码, 使变量被加载 .

管弦乐的特工已经省略了 `tools:` 前题字段,所以它们继承 `Agent` 一旦深度允许,工具就自动生效——不需要每个代理更改.

## 发展

### 正在本地测试

```bash
npm install        # install devDependencies (jest, gray-matter)
npm test           # run all tests; stops at first failure (--bail)
npm run test:coverage  # run all tests and generate a coverage report
```

测试套房包括:

-   **`tests/cli/`** - 单位测试纯函数 `bin/cli.js` (单位:千美元)`fileHash`, (中文(简体) ), `walkDir`, (中文(简体) ), `expandMappings`, (中文(简体) ), `categorize`, (中文(简体) ), `readInstalledVersion`(中文(简体) )
-   **`tests/frontmatter/`** ——所有项目的结构验证 `.claude/agents/*.md` 财务报告和审定财务报表 `.claude/skills/**/SKILL.md` 前题字段

覆盖面积报告 `coverage/` (恶作剧). 打开 `coverage/index.html` 在浏览器中浏览行级覆盖。 没有实施覆盖门槛; 报告只是诊断.

### 中情局

GitHub 动作工作流程(`.github/workflows/ci.yml`自动运行 每次拉动请求都瞄准 `main`数字 :

1.  检查重播 `ubuntu-latest` 带节点 20
2.  安装依赖关系 `npm ci`
3.  运行 `npm test` ——如果测试失败, 公关检查为红色
4.  运行 `npm run test:coverage` 上传 `coverage/` 作为目录 30天工作流程文物

### 添加或更改测试

-   当您修改函数时 `bin/cli.js`,更新匹配测试文件 内 `tests/cli/`。 。 。 .
-   当添加代理 `.md` 或技能 `SKILL.md`前题测试 `tests/frontmatter/` 自动运行 —— 确保 需要的字段(`name`, (中文(简体) ), `description`, (中文(简体) ), `model` 代理人; `description` (a) 具备并有效.

## 文档

-   [快速引用](https://npmcn.com/package/%40dtlabs/ai-toolkit/docs/reference.md) - 每种技能、指挥、代理和程序的欺骗表
-   [安装指南](https://npmcn.com/package/%40dtlabs/ai-toolkit/docs/installation.md) ——满 `.npmrc` 设置和 CLI 选项
-   [`CLAUDE.md`](https://npmcn.com/package/%40dtlabs/ai-toolkit/CLAUDE.md) - 代理和技能参考
-   [`docs/procedures/`](https://npmcn.com/package/%40dtlabs/ai-toolkit/docs/procedures/) ——可再使用的工作流程

## 许可证

麻省理工学院

## 常见问题

### @dtlabs/ai-toolkit 是什么？

AI工具箱——开发者用于构建AI动力应用程序的可重复使用的代理和程序\.

### 如何安装 @dtlabs/ai-toolkit？

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

### @dtlabs/ai-toolkit 支持 TypeScript 吗？

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

### @dtlabs/ai-toolkit 可以商用吗？

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

### @dtlabs/ai-toolkit 的下载量有多少？

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

### @dtlabs/ai-toolkit 还在维护吗？

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