# @aircury/ai-framework 中文文档

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

版本：2\.8\.0
npm 元数据更新时间：2026-11-05T10:50:17.336Z
中文译文更新时间：2026-11-06T16:39:01.501Z
软件包许可：未声明

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

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

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

- 包体积（解压后）：394 kB，3 个文件
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2026-04-07T11:24:38.121Z
- 最新版本发布：2026-11-05T10:50:16.980Z
- 近 30 天下载量：2728（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：78（近 12 个月 78 个）

## 中文简介

Aircury AI Framework安装器——在任何项目中设置可选择的架构标准,测试,以及AI代理配置

## 安装

```sh
npm install @aircury/ai-framework
```

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

## README

# 气动AI框架

[![npm](https://img.shields.io/npm/v/@aircury/ai-framework)](https://www.npmjs.com/package/@aircury/ai-framework)

Aircury AI框架是AI辅助软件工程的元路由框架. 其主要工作是决定AI代理对每项请求应使用哪一个工作流程.

一般不选择模式。 询问您需要的工作, 框架告诉代理是否使用 `plan-build`, Spec Kit, 或直接执行流. 仅在您明确想要强制工作流程时指定一个模式 .

它还安装了项目规则、代理入门点、生活规格文件夹、强制性工程不可转让、可选标准、绿地靴子制导和园艺技能,同时将共享工作流程架构与可安装能力分开.

## 为什么是空洞

Aircury为毒剂提供了足够的结构,使其能持续工作,而不会迫使每次改变都经过了沉重的过程. 默认行为是自动路由 :

-   使用 `plan-build` 为了明确的日常变化.
-   在要求需要正式澄清和规划之前使用 Spec Kit 代码 .
-   将持久的行为知识保存在 `specs/features/`。 。 。 .

## 快速安装

从任何工程目录(或全局设置的主目录)中运行安装器 :

```bash
bunx @aircury/ai-framework
# or
npx @aircury/ai-framework
```

TUI要求:

1.  **范围** —— 说 `Local` 配置当前工程, `Global` 来配置您的机器.
2.  **AI 工具** ——选择您想要的工具特定集成.
3.  **语言偏好** ——对于本地安装,可选择执行英国英语并包括语言能力.
4.  **能力** 选择这种安装应包括的工作流程和标准.

重运行安装器在不询问的情况下更新一个项目: 载有框架维护的通知的文件被当前版本所取代, `AGENTS.md` 财务报告和审定财务报表 `CLAUDE.md` 保留其内容并获得框架部分,即项目自己的文件(`FRAMEWORK.local.md`,则 `specs/` 指南)从不被覆盖,不再安装的配置文件框架能力文件被删除。 已安装的版本记录为 `frameworkVersion` 内 `.aircury/framework.config.json`技能通过技能生态系统与 `npx` 或者说 `bunx`,因此可以在以后更新。 当项目保持时 `.agents/skills` 作为 git 子模块(一个共享的技能存储器),安装者在那里安装没有技能:该存储器拥有这些技能,安装者列出它已经提供的所选技能以及要添加的技能.

当地安装的每台设备都包含不可转让的工程规则 `FRAMEWORK.md`:TDD 在自动化测试可行的情况下,SOLID设计限制,Clean Code,清晰的架构界限,以及任何例外的合理取舍.

## 更新一个工程

将一个已安装的项目带入最新的框架而不提示(例如来自自动代理),从项目根运行:

```bash
npx @aircury/ai-framework@latest --update
# or preview the plan without writing anything
npx @aircury/ai-framework@latest --update --dry-run
```

它读取了保存 `.aircury/framework.config.json` 并应用与交互式安装器相同的计划:框架维护的文件被刷新,项目自己的文件被保存, `AGENTS.md`编号 :`CLAUDE.md` 合并、卸下的能力文件被去除、技能得到安装(无一成为 `.agents/skills` 分模块).

## 从本地分支安装

要测试一个未公布的分支, 请从您的本地退出中创建 CLI :

```bash
bun install
bun run build
```

然后从您想要配置的项目中运行已建安装器 :

```bash
node /absolute/path/to/ai-framework/dist/cli.js
```

如果您想要在安装到真正的仓库之前验证生成的文件, 请先使用丢弃项目 .

## 它安装什么

| 范围 | 产出 |
| --- | --- |
| 当地 | `FRAMEWORK.md`, (中文(简体) ), `AGENTS.md`, (中文(简体) ), `.aircury/framework.config.json`开始器 `specs/` 文件夹、可选工具文件、选定技能以及 a `.gitignore` 条目 `specs/changes/`。 。 。 . |
| 全球 | 选定全球代理人一体化的选定技能. |

## 正在走动的 Skeleton

对于绿地项目,Aircury可以安装外部 [`aircury/walking-skeleton`](https://github.com/aircury/walking-skeleton) 技能作为可选能力.

当一个团队想从经过审查的发展成果评估开始,定义一个细小的端到端切片,并在正常特性交付开始前建立可运行基线时,建议采用.

技能留在自己的仓库里。 此框架只引用并安装到 `skills add`;它不销售 ADR 目录或生成示例代码.

使用工作流程顺序 :

```text
/walking-skeleton plan
/walking-skeleton spec
/walking-skeleton build
```

## 文档

| 文档 | 目的 |
| --- | --- |
| [`docs/concepts.md`](https://npmcn.com/package/%40aircury/ai-framework/docs/concepts.md) | 概念模型:框架存在的原因,工作流程的路径,能力,和犬科. |
| [`docs/implementation.md`](https://npmcn.com/package/%40aircury/ai-framework/docs/implementation.md) | 安装器流程,生成的文件,能力,技能安装,以及冲突处理. |
| [`docs/playbook.md`](https://npmcn.com/package/%40aircury/ai-framework/docs/playbook.md) | 工作流程选择指南,实例,以及已安装项目的操作规则. |
| [`docs/contribution.md`](https://npmcn.com/package/%40aircury/ai-framework/docs/contribution.md) | 如何提供模块、模板、技能和安装器接线. |
| [`docs/improvements.md`](https://npmcn.com/package/%40aircury/ai-framework/docs/improvements.md) | 从2026年6月反馈综合中优先改进了框架. |

## 常见问题

### @aircury/ai-framework 是什么？

Aircury AI Framework安装器——在任何项目中设置可选择的架构标准,测试,以及AI代理配置

### 如何安装 @aircury/ai-framework？

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

### @aircury/ai-framework 支持 TypeScript 吗？

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

### @aircury/ai-framework 可以商用吗？

@aircury/ai-framework 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @aircury/ai-framework 的下载量有多少？

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

### @aircury/ai-framework 还在维护吗？

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