# @anacatavc/amiga-ia 中文文档
规范地址：https://npmcn.com/package/%40anacatavc/amiga-ia/
版本：5\.15\.1
npm 元数据更新时间：2026-11-06T00:16:54.859Z
中文译文更新时间：2026-11-06T08:47:55.270Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40anacatavc/amiga-ia
原文对照：https://npmcn.com/package/%40anacatavc/amiga-ia/?lang=original
项目主页：https://github.com/AnaCataVC/amiga-ia#readme
源码仓库：https://github.com/AnaCataVC/amiga-ia
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1 MB，103 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=20\.12\.0
- 运行依赖：2 个
- 首次发布：2026-06-08T04:39:12.671Z
- 最新版本发布：2026-11-06T00:16:54.478Z
- 近 30 天下载量：3729（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：84（近 12 个月 84 个）
## 中文简介
代理人的通用申报技能
## 安装
```sh
npm install @anacatavc/amiga-ia
```
也可以使用：`pnpm add @anacatavc/amiga-ia`、`yarn add @anacatavc/amiga-ia`、`bun add @anacatavc/amiga-ia`
## README
# Amiga IA - 自主代理套件和声明技能
[联合国](https://npmcn.com/package/%40anacatavc/amiga-ia/README.md) | [西班牙语Name](https://npmcn.com/package/%40anacatavc/amiga-ia/README.es.md)
[](https://www.npmjs.com/package/@anacatavc/amiga-ia) [](https://deepmind.google/technologies/gemini/) [](https://anthropic.com/) [](https://openai.com/codex/) [](https://npmcn.com/package/%40anacatavc/amiga-ia/benchmarks/README.md) [](https://npmcn.com/package/%40anacatavc/amiga-ia/LICENSE)
> 🎶 repo name inspo: [Amiga Mia - Los Prisioneros (意大利语)](https://www.youtube.com/watch?v=qPHaLk4-_Ew)
> 产品网站: [amiga-ia.ana-catalina.com (中文(简体) )](https://amiga-ia.ana-catalina.com/)
* * *
### 1\. 项目说明
**国际友爱协会** 是一个综合的生态系统 _自动子剂_, (中文(简体) ), _无国籍的护栏钩_,以及 _便携式申报技能_ 旨在将AI编码助理从被动指令执行员提升为主动团队合作者. 工程师 **反重力 (格米尼)**, (中文(简体) ), **克劳德代码**,以及 **OpenAI 代码**,Amiga IA提供了一个单一的真相来源,用于基于 **代理技能( Markdown + Lazy Loding)** 标准.
随着它的建筑进化 **v3.0.0 ("代理进化")** 改为 **页:1**Amiga IA提供分散的多技能管弦乐,双布林德清洁室TDD(`ami-cleanroom-arbiter`),三生态系统本土翻译,以及自主的UI快速原型和设计一致性套件(英语:`ami-ui-builder`, (中文(简体) ), `ami-prototype-ui`, (中文(简体) ), `ami-audit-ui-consistency`),而不需要人类分步指导.
#### 1.1 终到终自主工作流程
Amiga IA通过合同第一边界和自动仲裁,协调分散的子代理团队,而不是要求分步骤的人类提示:
```mermaid
flowchart TD
User(["User Request"]) --> Orchestrator["Autonomous Orchestrator
(ami-tech-lead / ami-pr-reviewer)"]
subgraph Execution ["Parallel Multi-Agent Execution"]
direction TB
Orchestrator --> StaticReview["Static Analysis & Code Quality
(ami-repo-auditor / ami-audit-quality)"]
Orchestrator --> Cleanroom["Double-Blind Cleanroom TDD
(ami-cleanroom-arbiter)"]
Cleanroom --> Builder["Isolated Implementer
(ami-cleanroom-builder)"]
Cleanroom --> Tester["Black-Box QA Tester
(ami-cleanroom-tester)"]
Orchestrator --> Adversarial["Adversarial Verification
(ami-adversarial-verifier)"]
end
StaticReview --> Evidence["Evidence Aggregation & Quality Gates"]
Builder --> Evidence
Tester --> Evidence
Adversarial --> Evidence
Evidence --> FinalReview(["Final Verified Delivery / Release"])
```
### 2\. 启动安装
官方和推荐的设置方法正在通过国家防范机制的一揽子登记册在全球安装Amiga IA `ami` CLI: 爱丽丝
```bash
# 1. Install globally from the NPM registry
npm install -g @anacatavc/amiga-ia
# 2. Launch the interactive CLI setup wizard (or use amiga-ia-setup)
ami install
# 3. View the ecosystem catalog, packs, and assistant status
ami list
# 4. Verify system health, hooks, and YAML frontmatter integrity
ami doctor
```
> 💡 **多引擎钩和护栏:** Claude Code支持自动承诺前咨询提醒和安全阻截合并为 `~/.claude/settings.json` (自动回滚备份在 `~/.claude/settings.json.amiga-backup`) (中文(简体) ). Google反重力原生地执行它的原子规划管道和宣示式护栏,通过 `rules/ami-rules.md`。OpenAI Codex 支持在 `~/.codex/hooks.json`。 。 。 .
>
> 高级CLI使用时,可选择域包(`ami add data`, (中文(简体) ), `ami add ui`)和克洛德代码运行时间扩展(`ami add claude-mods`见 [Amiga IA CLI 安装指南](https://npmcn.com/package/%40anacatavc/amiga-ia/docs/cli-installation-guide.md) (单位:千美元)[西班牙语Name](https://npmcn.com/package/%40anacatavc/amiga-ia/docs/cli-installation-guide.es.md)) (中文(简体) ).
#### 2.1 多生态系统环境配置
运行时 `amiga-ia-setup`, CLI 向导以干净、孤立的能力配置填充您的家目录 :
```text
~/.claude/ # Claude Code Global Configuration
├── skills/ami-*/SKILL.md # Declarative Skills (25 directories)
├── agents/ami-*.md # Autonomous Subagents (14 profiles)
├── settings.json # Merged Hooks (PreToolUse, PostToolUse)
└── settings.json.amiga-backup # Safe original settings backup
~/.gemini/config/ # Antigravity (Gemini) Global Configuration
├── skills/ami-*/SKILL.md # Declarative Skills (25 directories)
├── agents/ami-*.md # Autonomous Subagents (14 profiles)
└── rules/ami-rules.md # Declarative Operational Rules
~/.agents/skills/ # Codex Global Skills (25 directories)
~/.codex/ # Codex Global Configuration
├── agents/ami-*.toml # Custom Subagents in TOML format (14 profiles)
├── AGENTS.md # Merged Behavioral Rules (Optional)
└── hooks.json # Optional Lifecycle Hooks
```
#### 2.2 卸载
将Amiga IA从您的 AI 编码环境中清理出来:
1. 运行 `ami uninstall` (或 `amiga-ia-setup` 选择 `Uninstall`)从您的设置中清除所有被复制的技能、代理、规则和钩子注射.
2. 运行 `npm uninstall -g @anacatavc/amiga-ia` 从您的系统中清除 CLI 软件包 .
### 3\. 技术和建筑创新
- **代理技能( XML + Markdown Lazy 加载) :** 一种有符号效率的架构,将可用工具的索引编入系统即时,只允许AI模型在积极需要时打开并消费必要的技能指令.
- **多技能平行管弦乐团(ADR-002):** 分散化子剂配置(例如: `ami-pr-reviewer`, (中文(简体) ), `ami-doc-architect`,以及 `ami-repo-auditor`协调平行的工人线程,扫描代码基础技术债务,验证前推一致性,并同时审查代码.
- **双Blind Cleanroom TDD 三合一(ADR-012,ADR-017):** 脱钩执行者`ami-cleanroom-builder`)和质量保证测试器(`ami-cleanroom-tester`子剂,由 `ami-cleanroom-arbiter` 严格跨越被冻结的接口合同运行(`docs/contracts/`),消除测试过度调整和确认偏差.
- **三电子系统分布和语义编译器(ADR-014,ADR-015,ADR-016):** 横跨Anthropic Claude代码,将Canonic Markdown源变成平台-本地格式(`~/.claude/`),谷歌反重力(英语:`~/.gemini/config/`),和 OpenAI 编码器(`~/.agents/` 打开 `~/.codex/`),编译出原生TOML子剂表并进行动态路径扩展(`__AMIGA_CODEX_SKILLS_DIR__`) (中文(简体) ).
- **双模码检定和反相假化(ADR-006,ADR-013):** 主动对抗性审计`ami-adversarial-verifier`通过双重审查模式(Static Code Review vs. Full Dynamic Review with test expert)和5-dimension盲点探测器来评估PR,以消除假阳性.
- **自主 UI 原始和一致性审计(ADR-018):** 卸下动词布局标记到 `ami-ui-builder`,脚手架自成一体的 HTML5/Tailwind 活视规格(`docs/mockups/`),并审计整个Web,桌面,和Mobile的标志性遵守设计系统.
- **零监督无国籍处决(ADR-003):** 背景安全钩被优化为象征经济和零内存污染,在本土Bash,Windows PowerShell,和零依赖节点执行引擎之间无缝运行.
- **压缩系统快取和统一钩优化(ADR-004):** 重构通用适配器 XML 生成程序,以使用root- relative Contact 属性,并将内置的PowerShell和Bash命令迁移到外部运行时脚本(`hooks/scripts/ami-hooks.ps1` 打开 `ami-hooks.sh`) (中文(简体) ). 这实现了经核实 **减少36.3%(-1 211个令牌/转折)** 在反复出现的系统即时(从3,335个到2,124个令牌/转弯),更快的LLM推论,零钩去相差误差.
- **交互式 CLI 向导 (M)`amiga-ia-setup`:** 在Node.js所建的自动设置,迁移,和诊断套件,可以清洁地安装技能,将配置合并到AI用户设置,并动态地检查系统健康.
### 4\. 经验基准与核查
Amiga IA通过100%的确定性离线代理基准套件验证其核心建筑要求(`benchmarks/`:
```bash
# Run the complete agentic benchmark suite
npm run benchmark
# Run individual benchmarks
npm run benchmark:tokens # Validates -44.75% context reduction (ADR-004)
npm run benchmark:audit # Validates defect detection (100% precision & recall)
npm run benchmark:cleanroom # Validates Cleanroom TDD (0% confirmation bias)
```
| 基准试验 | 重点/索赔 | 经验结果 | 质量门 | 状态 |
| --- | --- | --- | --- | --- |
| **系统提示覆盖** | 每回合减少背景足迹(ADR-004) | **\- 保存了2 973个令牌(-44.75%)** | 减少35.0% | **已通过** |
| **仓库审计** | 精确度、回溯度和假正弹性 | **100%精度,100%召回(F 1 = 1.00美元)** | 1美元=0.85美元 | **已通过** |
| **清洁室 TDD 隔离** | 确认偏差和逃脱缺陷(ADR-012) | **0%确认偏差,0个逃脱缺陷** | 0个逃脱缺陷 | **已通过** |
> 详细的方法、评价合同和原始衡量标准见以下文件: [基准/README.md](https://npmcn.com/package/%40anacatavc/amiga-ia/benchmarks/README.md) 生成 [比利时出口公司](https://npmcn.com/package/%40anacatavc/amiga-ia/benchmarks/results/BENCHMARK_REPORT.md)。 。 。 .
### 5\. 旗舰能力与代理简介
AIGA 包含 **39个内置能力** (14名自主副代理人和25名申报技能) `ami-` 命名空间前缀,以防止与外部生态系统相撞.
以下矩阵突出核心 **旗舰代理人和技能** 驱动主要自主工作流程:
| 构成部分 | 类型 | 主要作用和责任 |
| --- | --- | --- |
| **清扫室选手** | 探员 | 主清洁室TDD仲裁人. 冻结正式接口合同`docs/contracts/`),发送孤立的构建器和测试器子剂,执行测试取用并判定失败. |
| **ami-pr-审查者** | 探员 | 通过双重审查模式(静态审查与带有测试的全面动态审查)和对抗性弄虚作假审计来评价公关的总审查指挥员. |
| **ami-repo- 审计人** | 探员 | 首席审计指挥员同时评价各单元的技术债务、依赖性卫生和安全弱点. |
| **技术领导** | 探员 | 主项目规划与建筑 Orchestrator. 评估储存库的健康状况、规划特征和协调建筑蓝图. |
| **建筑师** | 探员 | UI大师 UX和原型专家 构建交互式HTML5/Tailwind模型,独立原型,以及没有上下文污染的活生生的视觉相片. |
| **助推员** | 探员 | 推进前管弦乐团进行基线质量检查,扫描被泄露出的秘密/托盘,在远程Git推前验证测试套件. |
| **节奏清洁室** | 技能 | 双Blind 清扫室管弦乐工作流程 协调孤立的执行器和黑盒测试发电机子剂 与被冻结的合同. |
| **自我审查** | 技能 | 紧凑的高级工程师本地审查工作流程有5个分点盲点探测器和自动测试补救回路. |
| **审计质量** | 技能 | 深层代码检查工作流程,用于模块可维护性,安全缺陷,计划一致性,结构健全性. |
| **ami 设计工具** | 技能 | UX大师建筑师设计互动模型,用户行程,5个基本状态,以及微复制(`docs/ux/`) (中文(简体) ). |
| **ami-prototype-ui (英语)** | 技能 | 快速脚手架自成一体,交互式HTML5和Tailwind CSS UI模型和屏幕原型(`docs/mockups/`) (中文(简体) ). |
> 📚 **完整目录 :** 关于所有39个自主代理商和申报技能的详细参考、详细计划及域分类,请参见: [全能目录](https://npmcn.com/package/%40anacatavc/amiga-ia/docs/catalog.md) (单位:千美元)[西班牙语Name](https://npmcn.com/package/%40anacatavc/amiga-ia/docs/catalog.es.md)) (中文(简体) ).
### 6\. 主要学习(开发者外出)
Amiga IA的建设和规模化,通过它演变成一个完全具有促进作用的生态系统,产生了重大的工程经验:
- **代理对被动提示:** 传统的分步必行脚本被分解为代码库规模. 向自主的子剂剖面图过渡,以说明项目目标的理由,发现当地的工具,并平行地委托工人进行线程,事实证明,比起单一的即时工程,其强度和可伸缩性都大得多.
- **清洁室隔离与确认比斯:** 单代理测试生成不可避免地会受到确认偏差的影响——编写代码的同一种模型会写出由自身假设所塑造的测试. 将工作流程拆分成孤立的子剂,这些子剂严格通过不可移动的界面合同(Clearroom TDD)表面边缘外壳和在代码触摸出出出产前的建筑模棱两可.
- **托肯经济和无国籍:** 早期的迭代利用持续的背景缓存来存储会话摘要。 迭代分析显示,在整个会议期间保持僵化的环境会重新启动退化的LLM推论速度和膨胀的象征性消费。 降低会议状态,以利无国籍、按需进行反应性视察(ADR-003),大大提高了系统的反应能力和准确性.
- **减轻静态再现税:** 插入AI System Points的动态工具目录对扩展的对话会话造成了严重的复合成本. 使用由属性驱动的根相关系索引,而不是动词XML包装分级来消除大量静态冗余(ADR-004). 此外,从复杂的内含 shell 表达式向标准化的外部运行时引用的过渡,阻止了 OS shell 逃出 Getchas 并消除了跨平台的字符串匹配分解故障.
- **跨平面路径分辨率和运行时中性化 :** 在各种人工智能助理运行时间中部署申报技能需要严格的路径正常化。 共享包中的绝对路径会引发环境相撞;将本地目录抽象为运行时的插值占位符解决了Windows/Linux文件系统差异并阻止了regex在安装过程中的替换副作用.
- **跨平台和多引擎统一:** 实现不同AI运行时间(Antigravity, Claude Code, and OpenAI Codex)和不同操作系统(Linux/macOS Bash vs. Windows PowerShell)之间100%的交叉兼容性,需要将钩子逻辑抽象入通用运行时间脚本并强制进行全本地格式的严格能力翻译.
### 7\. 仓库结构
```text
amiga-ia/
├── package.json # NPM Package registry definition & Single Source of Truth
├── bin/setup.js # Interactive CLI setup wizard & doctor tool
├── adapters/ # Universal XML catalog compiler (universal_adapter.js)
├── agents/ # Autonomous Subagent profiles in Markdown (ami-*.md)
├── skills/ # Canonical declarative Markdown skills (ami-*/SKILL.md)
├── benchmarks/ # Empirical agentic benchmark suite & evaluation contracts
│ ├── contracts/ # Frozen benchmark evaluation contracts
│ ├── token-overhead/ # Context compression benchmark (ADR-004)
│ ├── repo-audit/ # Multi-agent defect detection benchmark
│ ├── cleanroom-tdd/ # Double-Blind Cleanroom vs Single-Agent benchmark
│ └── results/ # Raw metrics & generated BENCHMARK_REPORT.md
├── docs/ # Persistent agent memory & documentation tree
│ ├── catalog.md # Full Capabilities Catalog (39 agents & skills)
│ ├── adr/ # Architectural Decision Records (ADRs 001-021)
│ ├── architecture/ # Deep structural & adapter engineering guides
│ ├── contracts/ # Formal Cleanroom TDD interface contracts
│ ├── ux/ # Living UX specifications & interaction state matrices
│ ├── mockups/ # Living UI specifications (HTML5 + Tailwind CSS)
│ └── learning/ # Captured session learnings and iterative patterns
├── codex/ # Generated Codex-native skill and subagent files
├── hooks/ # Cross-platform guardrail hooks (.js wrappers, .ps1, .sh)
├── hooks.json # Claude Code native hooks configuration (Bash engine)
└── hooks-pwsh.json # Claude Code native hooks configuration (PowerShell engine)
```
### 8\. 扩大生态系统
- **强制性命名公约`ami-` 前缀 :** 所有自定义技能和代理配置 `ami-` (例如, `ami-db-migrator`) (中文(简体) ). 这确保了干净的命名空间分隔,并保护您的自定义工具免受外部冲突.
- **添加新技能 :** 在 `skills/ami-/` 包含一个 `SKILL.md` 以标准的 YAML 前题配置指令文件 .
- **添加新代理 :** 在 `agents/ami-.md` 详细说明行为规则、技能引用授权和协调指令.
* * *
## 许可证
这个项目根据麻省理工学院的许可证获得许可。 见 [自由主义](https://npmcn.com/package/%40anacatavc/amiga-ia/LICENSE) 详细情况.
## 常见问题
### @anacatavc/amiga-ia 是什么？
代理人的通用申报技能
### 如何安装 @anacatavc/amiga-ia？
在项目目录运行 npm install @anacatavc/amiga-ia，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ami、amiga-ia-setup，可以用 npx ami 直接运行。
### @anacatavc/amiga-ia 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/anacatavc\_\_amiga-ia 是否存在。
### @anacatavc/amiga-ia 支持 ESM 还是 CommonJS？
以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。
### @anacatavc/amiga-ia 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=20\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @anacatavc/amiga-ia 可以商用吗？
@anacatavc/amiga-ia 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @anacatavc/amiga-ia 的下载量有多少？
根据 npm 官方下载统计，@anacatavc/amiga-ia 在 2026/10/06 – 2026/11/04 这 30 天内被下载 3,729 次，日均约 124 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @anacatavc/amiga-ia 还在维护吗？
最新版本 5\.15\.1 发布于 2026/11/06（1 天前）；至今共发布 84 个版本，其中过去 12 个月发布了 84 个；首次发布于 2026/06/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。