Amiga IA - 自主代理套件和声明技能

联合国 | 西班牙语Name

🎶 repo name inspo: Amiga Mia - Los Prisioneros (意大利语)
产品网站: amiga-ia.ana-catalina.com (中文(简体) )

1. 项目说明

国际友爱协会 是一个综合的生态系统 自动子剂, (中文(简体) ), 无国籍的护栏钩,以及 便携式申报技能 旨在将AI编码助理从被动指令执行员提升为主动团队合作者. 工程师 反重力 (格米尼), (中文(简体) ), 克劳德代码,以及 OpenAI 代码,Amiga IA提供了一个单一的真相来源,用于基于 代理技能( Markdown + Lazy Loding) 标准.

随着它的建筑进化 v3.0.0 ("代理进化") 改为 页:1Amiga IA提供分散的多技能管弦乐,双布林德清洁室TDD(ami-cleanroom-arbiter),三生态系统本土翻译,以及自主的UI快速原型和设计一致性套件(英语:ami-ui-builder, (中文(简体) ), ami-prototype-ui, (中文(简体) ), ami-audit-ui-consistency),而不需要人类分步指导.

1.1 终到终自主工作流程

Amiga IA通过合同第一边界和自动仲裁,协调分散的子代理团队,而不是要求分步骤的人类提示:

flowchart TD
    User(["User Request"]) --> Orchestrator["Autonomous Orchestrator<br/>(ami-tech-lead / ami-pr-reviewer)"]
    
    subgraph Execution ["Parallel Multi-Agent Execution"]
        direction TB
        Orchestrator --> StaticReview["Static Analysis & Code Quality<br/>(ami-repo-auditor / ami-audit-quality)"]
        Orchestrator --> Cleanroom["Double-Blind Cleanroom TDD<br/>(ami-cleanroom-arbiter)"]
        Cleanroom --> Builder["Isolated Implementer<br/>(ami-cleanroom-builder)"]
        Cleanroom --> Tester["Black-Box QA Tester<br/>(ami-cleanroom-tester)"]
        Orchestrator --> Adversarial["Adversarial Verification<br/>(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: 爱丽丝

# 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 安装指南 (单位:千美元)西班牙语Name) (中文(简体) ).

2.1 多生态系统环境配置

运行时 amiga-ia-setup, CLI 向导以干净、孤立的能力配置填充您的家目录 :

~/.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/:

# 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)

详细的方法、评价合同和原始衡量标准见以下文件: 基准/README.md 生成 比利时出口公司。 。 。 .

5. 旗舰能力与代理简介

AIGA 包含 39个内置能力 (14名自主副代理人和25名申报技能) ami- 命名空间前缀,以防止与外部生态系统相撞.

以下矩阵突出核心 旗舰代理人和技能 驱动主要自主工作流程:

📚 完整目录 : 关于所有39个自主代理商和申报技能的详细参考、详细计划及域分类,请参见: 全能目录 (单位:千美元)西班牙语Name) (中文(简体) ).

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. 仓库结构

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-<name>/ 包含一个 SKILL.md 以标准的 YAML 前题配置指令文件 .
• 添加新代理 : 在 agents/ami-<name>.md 详细说明行为规则、技能引用授权和协调指令.

许可证

这个项目根据麻省理工学院的许可证获得许可。 见 自由主义 详细情况.