# @adobe/data-ai 中文文档

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

版本：0\.10\.32
npm 元数据更新时间：2026-11-05T04:54:10.104Z
中文译文更新时间：2026-11-05T18:30:25.040Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40adobe/data-ai
原文对照：https://npmcn.com/package/%40adobe/data-ai/?lang=original

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

- 包体积（解压后）：252 kB，86 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@adobe/data 0\.10\.32
- 首次发布：2026-07-03T22:23:29.770Z
- 最新版本发布：2026-11-05T04:54:09.921Z
- 近 30 天下载量：67238（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

用于@adobe/data的跨代理架构技能——可安装为克洛德代码插件或复制到任何代理-Skills-兼容代理(Cursor, Codex).

## 安装

```sh
npm install @adobe/data-ai
```

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

## README

# @ adobe/ data-ai (英语)

AI 架构技能 + 构建应用程序的规则 [`@adobe/data`](https://www.npmjs.com/package/@adobe/data) 一层层地, 光谱第一特征结构( :`data → services → ui`诚实地遵守 测试。 与库一起锁定版本 : `@adobe/data-ai@x.y.z` 目标 `@adobe/data@x.y.z`。 。 。 .

它装了两样东西:

-   **技能** —— 说 `build-*` 命令脚手架的特性和应用.
-   **规则** ——这些技能在建设过程中遵循路径范围公约.

这个 **规则** 经常进化,所以 `install` 针入包并 每次安装时自动重印: 刷新版本 没有手动的步骤, 没有承诺的diff, 没有手动编辑.

## 快开始

从您的工程文件夹根 :

**1\. 安装** 一个命令:

```
npx @adobe/data-ai@latest install
```

_(仅保留代码:_ 也添加技能插件一次——见 [克劳德代码](https://npmcn.com/package/%40adobe/data-ai/#readme-claude-code--add-the-skills-plugin-one-time)需要光标/编码 无额外; `install` 复制他们的技能._(中文(简体) )_

**2\. 恢复你的人工智能代理** 因此它装入新安装的技能和规则.

**3\. 创建应用程序** - 问你的经纪人:

```
/build-application <a description of the app you want>
```

即为通通. 下面的一切解释什么 `install` 执行和 其他培养技能.

## 什麽 `install` 已经

`install` 做两件事: **现在复制捆绑** (规则 ) `.claude/rules/adobe-data-ai/`,并用于 Cursor/Codex 技能 → `.agents/skills/adobe-data-ai/`)),以及该词 **电线接回,然后安装未来 自我更新**编辑 `package.json` 财务报告和审定财务报表 `.gitignore` 改为:

1.  针 `@adobe/data-ai` 内 `devDependencies` 地点 **准确的版本它只是 已解决** (从来没有一个范围,所以后安装不能默默地拉出一个) 未经审查的释放;
2.  添加 `data-ai install` 改为 **你们自己** `postinstall` 脚本( 如果一个链条) ——必须 __ 脚本: pnpm 不运行依赖的生命周期 脚本,所以 `postinstall` 在包裹内运输不会静静地开火;
3.  gitignore 管理捆绑文件夹 .

每个管理好的文件夹还收到一个简短的"外部管理——不要编辑"通知,所以 打开它的一个代理在触摸再生成的文件之前被警告。 通知 遵循您 repo 的指令协议 : 它被写为 `AGENTS.md` 默认 (Claude Code也读到的交叉代理标准) `CLAUDE.md` (单位:千美元) 仍然只有CLAUDEMD的重播. `install` 从不掉入 `CLAUDE.md` 进入重置 用途 `AGENTS.md` 一个流浪汉 `CLAUDE.md` 任何地方 使克洛德代码忽略每一个 `AGENTS.md` 全项目.

复制的文件是再生成的文物——从未承诺,从未编辑过 地点 接线是同能的,所以重跑是无害的 `--global` 或在一个 没有目录 `package.json`, (中文(简体) ), `install` 只复制(无接线).

第一次运行后, 将锁文件与正常安装同步( Q)`pnpm install`这样 记录被绑定的 dev-dependent;从此以后,每次安装都会刷新 通过邮站捆绑.

**为什么 `@latest` 第一个命令,但后面有一个被钉住的版本?** 那个 命令你打字是一次性的 人类发动的靴子圈,所以 `@latest` 没事 (姿态与 `npm create …@latest`) (中文(简体) ). 那个角色 _重复_ ——每个 队友和CI的安装——从 **准确版本 `install` 钉入  `devDependencies`**从不移动标签,所以从来没有未经审查的发布 自动执行。 平宁会自动发生.

**更新 :** 颠倒 `@adobe/data-ai` 版本在 `package.json` 并再次安装. 就是这样.

### Claude Code — 添加技能插件( 一次)

Claude Code 从市场插件装入技能, 不是从 `.claude/skills/`这样 其技能是单独的一次性安装( `install` 已经在上面 处理 Claude 代码的规则 :

```
claude plugin marketplace add adobe/data --scope project
claude plugin install adobe-data-ai@adobe-data-skills --scope project
```

(交互式会话可以使用 `/plugin marketplace add adobe/data` 接下来 `/plugin install adobe-data-ai@adobe-data-skills`. ) (中文(简体) ) **更新技能:** `claude plugin update adobe-data-ai`。光标/编码不需要插件 - `install` 复制他们的技能.

### 只有文件,没有管理的依赖性

如果你不希望自动更新的接线——一个被丢弃的脚手架,一个非节点回放, 或者你宁愿把捆绑 并更新它 在你自己的时间表——运行 `install` 无法接线的地方(否) `package.json`,或通过 `--global`)或简单 删除 `postinstall`/dev-dependency 线它添加。 重运行 `install` 实值 总是一个干净的擦拭和复制;然后通过自己重新运行来更新.

## 培养技能

以上步骤3 `build-application`技能:

-   **`build-application`** ——构建整个应用程序:主机的基础特性 懒惰的同级特性.
-   **`build-feature`** ——构建一个特征端到结束. 培养每个层次的技能 (单位:千美元)`data → core-database → transactions → … → ui`然后检验 以纯洁的事物发誓 `data/` 谱.

兼有精致和可发现的技巧 需要单相或相通时的名称: `build-data`, (中文(简体) ), `build-core-database`, (中文(简体) ), `build-indexes`, (中文(简体) ), `build-transactions`, (中文(简体) ), `build-computed`, (中文(简体) ), `build-services`, (中文(简体) ), `build-service-database`, (中文(简体) ), `build-actions`, (中文(简体) ), `build-systems`, (中文(简体) ), `build-ui`, (中文(简体) ), `build-app-entry`; 附加 `build-game`, (中文(简体) ), `meta-build` (分阶段) 以副剂表示, `review` (对照规则审计产出)和 `structure` (布局的理由).

## 单线:安装+构建一个app(无头)

粘贴到已经在您的工程根中运行的代理, 替换 引用您自己的应用程序描述的文本 。 它安装捆绑,然后运行 `build-application` 在您的提示:

```
Set up @adobe/data-ai in the current directory: run
`npx @adobe/data-ai@latest install` (this copies the bundle and pins the exact
version so rules auto-update on every install). On Claude Code also add the
skills plugin per the package README. Then use its /build-application skill to
build <prompt here>
```

## 常见问题

### @adobe/data-ai 是什么？

用于@adobe/data的跨代理架构技能——可安装为克洛德代码插件或复制到任何代理-Skills-兼容代理\(Cursor, Codex\)\.

### 如何安装 @adobe/data-ai？

在项目目录运行 npm install @adobe/data-ai，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@adobe/data（0\.10\.32）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 data-ai，可以用 npx data-ai 直接运行。

### @adobe/data-ai 支持 TypeScript 吗？

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

### @adobe/data-ai 支持 ESM 还是 CommonJS？

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

### @adobe/data-ai 可以商用吗？

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

### @adobe/data-ai 的下载量有多少？

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

### @adobe/data-ai 还在维护吗？

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