@aircury/ai-framework

中文文档
2.8.0发布于 2026/11/05构建来源已验证近 30 天下载 2728

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

中文使用文档
文档目录7 节
  1. 为什么是空洞
  2. 快速安装
  3. 更新一个工程
  4. 从本地分支安装
  5. 它安装什么
  6. 正在走动的 Skeleton
  7. 文档

气动AI框架

npm

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

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

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

为什么是空洞

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

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

快速安装

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

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,清晰的架构界限,以及任何例外的合理取舍.

更新一个工程

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

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 :

bun install
bun run build

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

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 技能作为可选能力.

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

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

使用工作流程顺序 :

/walking-skeleton plan
/walking-skeleton spec
/walking-skeleton build

文档

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

版本与发布记录

@aircury/ai-framework 共发布 78 个版本,首次发布于 2026/04/07;过去 12 个月发布了 78 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
2.8.0latest2026/11/052 天前
2.7.12026/10/308 天前
2.7.02026/10/2711 天前
2.6.12026/10/2513 天前
2.6.02026/10/2513 天前
2.5.02026/10/2513 天前

关于 @aircury/ai-framework 的常见问题

@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 和提交记录判断。