SynkraAI/aiox-core

GitHub: SynkraAI/aiox-core

一个面向全栈开发的AI Agent编排框架,通过多专业Agent协作实现从需求规划到代码交付的完整开发流程自动化。

Stars: 2266 | Forks: 753

# AIOX Squad: Artificial Intelligence Orchestration eXperience [![NPM 版本](https://img.shields.io/npm/v/aiox-core.svg)](https://www.npmjs.com/package/aiox-core) [![许可证: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Node.js 版本](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/) [![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/03/06939d727b192244.svg)](https://github.com/SynkraAI/aiox-core/actions/workflows/ci.yml) [![codecov](https://codecov.io/gh/SynkraAI/aiox-core/branch/main/graph/badge.svg)](https://codecov.io/gh/SynkraAI/aiox-core) [![文档](https://img.shields.io/badge/docs-disponível-orange.svg)](https://aioxsquad.ai) [![开源](https://img.shields.io/badge/Open%20Source-Yes-success.svg)](LICENSE) [![欢迎贡献](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md) [![行为准则](https://img.shields.io/badge/code%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md) ## 从这里开始 (10 分钟) 如果您是第一次使用 AIOX,请按照以下步骤操作: 1. 在新项目或现有项目中安装: ``` # 新建项目 npx aiox-core init meu-projeto # 现有项目 cd seu-projeto npx aiox-core install ``` 2. 选择您的 IDE/CLI 和激活路径: - Claude Code: `/agent-name` - Gemini CLI: `/aiox-menu` → `/aiox-` - Codex CLI: `/skills` → `aiox-` - Cursor/Copilot/AntiGravity: 请遵循 `docs/ide-integration.md` 中的限制和变通方法 3. 激活 1 个 agent 并确认 greeting。 4. 运行 1 个初始命令(`*help` 或等效命令)以验证 first-value。 first-value 的定义(二元):agent 激活 + 有效 greeting + 初始命令在 <= 10 分钟内产生有用输出。 ## IDE Hook 兼容性(AIOX 4.2 宎况) AIOX 的许多高级功能依赖于生命周期事件(hooks)。下表显示了 IDE/平台之间的实际对等关系: | IDE/CLI | 与 Claude 的 Hook 对等性 | 实际影响 | | --- | --- | --- | | Claude Code | 完整(参考基准) | 最大的上下文自动化、guardrails 和审计 | | Gemini CLI | 高(原生事件) | 强大的 pre/post tool 和会话自动化覆盖 | | Codex CLI | 部分/有限 | 部分自动化依赖于 `AGENTS.md`、`/skills`、MCP 和操作流程 | | Cursor | 无等效的生命周期 hooks | 较少的 pre/post tool 自动化;专注于规则、MCP 和 agent 流程 | | GitHub Copilot | 无等效的生命周期 hooks | 较少的会话/tooling 自动化;专注于仓库指令 + VS Code 中的 MCP | | AntiGravity | 基于工作流(非基于 hook) | 通过 workflows 集成,而非与 Claude 等效的 hook 事件 | 详细影响和缓解措施:`docs/ide-integration.md`。 ## 概述 ### 架构前提:CLI First AIOX 遵循清晰的优先级层次: ``` CLI First → Observability Second → UI Third ``` | 层级 | 优先级 | 焦点 | 示例 | | ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- | | **CLI** | 最高 | 智能所在。所有执行、决策和自动化都在这里发生。 | Agents(`@dev`、`@qa`)、workflows、命令 | | **可观测性** | 次要 | 实时观察和监控 CLI 中发生的事情。 | Dashboard SSE、日志、指标、时间线 | | **UI** | 第三 | 必要时的点状管理和可视化。 | Kanban、设置、故事管理 | **衍生原则:** - CLI 是事实来源 —— dashboard 仅用于观察 - 新功能必须先在 CLI 上 100% 运行,然后才能有 UI - UI 永远不应成为系统运行的先决条件 - 可观测性用于理解 CLI 正在做什么,而不是控制它 **AIOX 的两大关键创新:** **1. 智能体规划:** 专门的 agents(analyst、pm、architect)与您协作,创建详细且一致的 PRD 和架构文档。通过先进的 prompt 工程和 human-in-the-loop 优化,这些规划 agents 生成全面的规范,远超通用的 AI 任务生成。 **2. 工程驱动的上下文开发:** sm (Scrum Master) agent 随后将这些详细的计划转化为超详细的开发故事,其中包含 dev agent 需要的一切 —— 完整的上下文、实现细节和直接嵌入在故事文件中的架构指导。 这种两阶段方法消除了**规划不一致**和**上下文丢失** —— AI 辅助开发中最大的两个问题。您的 dev agent 打开一个故事文件,就能完全理解要构建什么、如何构建以及为什么构建。 **📖 [在用户指南中查看完整工作流](docs/guides/user-guide.md)** - 规划阶段、开发周期和所有 agent 角色 ## 先决条件 - Node.js >=18.0.0(推荐 v20+) - npm >=9.0.0 - GitHub CLI(可选,团队协作需要) **特定平台指南:** - 📖 [macOS 安装指南](docs/installation/macos.md) - 📖 [Windows 安装指南](docs/installation/windows.md) - 📖 [Linux 安装指南](docs/installation/linux.md) **多语言文档:** [English](docs/README.md) | [Português](docs/pt/README.md) | [Español](docs/es/README.md) | [中文](docs/zh/README.md) ## 快速导航 ### 了解 AIOX 工作流 **在深入了解之前,请查看这些解释 AIOX 如何工作的关键工作流图表:** 1. **[规划流程(Web 界面)](docs/guides/user-guide.md#the-planning-workflow-web-ui)** - 如何创建 PRD 和架构文档 2. **[主要开发周期(IDE)](docs/guides/user-guide.md#the-core-development-cycle-ide)** - sm、dev 和 qa agents 如何通过故事文件协作 ### 您想做什么? - **[安装并使用全栈 AI 敏捷团队构建软件](#início-rápido)** → 快速入门说明 - **[学习如何使用 AIOX](docs/guides/user-guide.md)** → 完整用户指南和分步指南 - **[查看可用的 AI agents](#agentes-disponíveis)** → 您团队的专门角色 - **[探索非技术用途](#-além-do-desenvolvimento-de-software---squads)** → 创意写作、商业、健康、教育 - **[创建我自己的 AI agents](#criando-seu-próprio-squad)** → 为您的领域构建 agents - **[浏览现成的 Squads](docs/guides/squads-overview.md)** → 了解如何创建和使用 AI agent 团队 - **[了解架构](docs/architecture/ARCHITECTURE-INDEX.md)** → 深入技术探讨 - **[报告问题](https://github.com/SynkraAI/aiox-core/issues)** → Bug 报告和功能请求 ## 重要提示:保持您的 AIOX 安装最新 **轻松保持最新状态!** 要更新您现有的 AIOX 安装: ``` npx aiox-core@latest install ``` 这将: - ✅ 自动检测您现有的安装 - ✅ 仅更新已更改的文件 - ✅ 为任何自定义修改创建 `.bak` 备份文件 - ✅ 保留您项目的特定配置 这使您能够轻松享受最新的改进、bug 修复和新 agents,而不会丢失您的自定义设置! ## 快速入门 ### 🚀 通过 NPX 安装(推荐) **使用单个命令安装 AIOX:** ``` # 使用现代交互式助手创建新项目 npx aiox-core init meu-projeto # 或者安装到现有项目 cd seu-projeto npx aiox-core install # 或者使用特定版本 npx aiox-core@latest init meu-projeto ``` ### ✨ 现代安装向导 AIOX 现在包含一流的交互式安装体验,灵感来自 Vite 和 Next.js 等现代工具: **交互式安装程序功能:** - 🎨 **现代界面**:使用 @clack/prompts 的彩色视觉提示 - ✅ **实时验证**:即时反馈无效输入 - 🔄 **进度指示器**:长时间操作(文件复制、deps 安装)的 Spinners - 📦 **多组件选择**:使用直观的界面选择要安装的组件 - ⚙️ **包管理器选择**:在 npm、yarn 或 pnpm 之间选择 - ⌨️ **取消支持**:Ctrl+C 或 ESC 随时优雅退出 - 📊 **安装摘要**:在继续之前查看所有配置 - ⏱️ **持续时间跟踪**:查看安装花费了多长时间 **安装程序提供:** - ✅ 从 NPM 下载最新版本 - ✅ 现代交互式安装向导 - ✅ 自动 IDE 配置(Codex CLI、Cursor 或 Claude Code) - ✅ 配置所有 AIOX agents 和 workflows - ✅ 创建必要的配置文件 - ✅ 初始化 meta-agents 系统 - ✅ 系统健康检查 - ✅ **跨平台支持**:在 Windows、macOS 和 Linux 上测试 **先决条件**:需要 [Node.js](https://nodejs.org) v18+(推荐 v20+)| [故障排除](docs/guides/installation-troubleshooting.md) ### 更新现有安装 如果您已经安装了 AIOX: ``` npx aiox-core@latest install # 安装程序将检测您现有的安装并进行更新 ``` ### 配置您的 IDE 进行 AIOX 开发 AIOX 包含预配置的 IDE 规则以改善您的开发体验: #### 对于 Cursor: 1. 打开 Cursor 设置 2. 导航到 **User Rules** 3. 复制 `.cursor/global-rules.md` 的内容 4. 粘贴到规则部分并保存 #### 对于 Claude Code: - ✅ 已配置!`.claude/CLAUDE.md` 文件自动加载 - 专用 agents 同步:`npm run sync:ide:claude` - 专用验证:`npm run validate:claude-sync && npm run validate:claude-integration` #### 对于 Codex CLI: - ✅ AIOX 4.2 中的一流集成(共享激活和 greeting 管道) - ✅ 已配置!根目录下的 `AGENTS.md` 文件自动加载 - 可选:使用 `npm run sync:ide:codex` 同步辅助 agents - 在此仓库中推荐:使用 `npm run sync:skills:codex` 生成并版本化本地 skills - 仅在此项目之外使用 `npm run sync:skills:codex:global`(以避免 `/skills` 中的重复) - 专用验证:`npm run validate:codex-sync && npm run validate:codex-integration` - skills/paths guardrails:`npm run validate:codex-skills && npm run validate:paths` #### 对于 Gemini CLI: - ✅ 可使用 `npm run sync:ide:gemini` 同步规则和 agents - 生成的文件位于 `.gemini/rules.md`、`.gemini/rules/AIOX/agents/` 和 `.gemini/commands/*.toml` - ✅ 安装流程中的本地 hooks 和 settings(`.gemini/hooks/` + `.gemini/settings.json`) - ✅ 通过 slash commands 快速激活(`/aiox-menu`、`/aiox-dev`、`/aiox-architect` 等) - 专用验证:`npm run validate:gemini-sync && npm run validate:gemini-integration` - 一个命令实现多 IDE 对等:`npm run validate:parity` 这些规则提供: - 🤖 Agent 命令识别和集成 - 📋 故事驱动的开发工作流 - ✅ 自动 checkbox 跟踪 - 🧪 测试和验证模式 - 📝 AIOX 特定的代码模式 ### 使用 Web 界面快速入门(2 分钟) 1. **安装 AIOX**:运行 `npx aiox-core init meu-projeto` 2. **配置您的 IDE**:按照 Codex CLI、Cursor 或 Claude Code 的配置说明操作 3. **开始规划**:激活一个 agent,如 `@analyst`,开始创建您的简报 4. **使用 AIOX 命令**:输入 `*help` 查看可用命令 5. **遵循流程**:查看[用户指南](docs/guides/user-guide.md)了解更多详情 ### CLI 命令参考 AIOX 提供具有直观命令的现代跨平台 CLI: ``` # 项目管理(配合交互式助手) npx aiox-core init [opções] --force Forçar criação em diretório não vazio --skip-install Pular instalação de dependências npm --template Usar template específico (default, minimal, enterprise) # 安装和配置(配合现代提示) npx aiox-core install [opções] --force Sobrescrever configuração existente --quiet Saída mínima durante instalação --dry-run Simular instalação sem modificar arquivos # 系统命令 npx aiox-core --version Exibir versão instalada npx aiox-core --help Exibir ajuda detalhada npx aiox-core info Exibir informações do sistema npx aiox-core doctor Executar diagnósticos do sistema npx aiox-core doctor --fix Corrigir problemas detectados automaticamente # 维护 npx aiox-core update Atualizar para versão mais recente npx aiox-core uninstall Remover AIOX ``` **CLI 功能:** - ✅ **全面的帮助系统**:任何命令的 `--help` 显示详细文档 - ✅ **输入验证**:即时反馈无效参数 - ✅ **彩色消息**:错误显示红色、成功显示绿色、警告显示黄色 - ✅ **跨平台**:在 Windows、macOS 和 Linux 上完美运行 - ✅ **Dry-Run 支持**:测试安装而不修改文件 ### 💡 使用示例 #### 完整交互式安装 ``` $ npx aiox-core install 🚀 AIOX Installation ◆ What is your project name? │ my-awesome-project │ ◇ Which directory should we use? │ ./my-awesome-project │ ◆ Choose components to install: │ ● Core Framework (Required) │ ● Agent System (Required) │ ● Squads (optional) │ ○ Example Projects (optional) │ ◇ Select package manager: │ ● npm │ ○ yarn │ ○ pnpm │ ◆ Initialize Git repository? │ Yes │ ◆ Install dependencies? │ Yes │ ▸ Creating project directory... ▸ Copying framework files... ▸ Initializing Git repository... ▸ Installing dependencies (this may take a minute)... ▸ Configuring environment... ▸ Running post-installation setup... ✔ Installation completed successfully! (34.2s) Next steps: cd my-awesome-project aiox-core doctor # Verify installation aiox-core --help # See available commands ``` #### 静默安装 (CI/CD) ``` # 无提示自动安装 $ npx aiox-core install --quiet --force ✔ AIOX installed successfully ``` #### 安装模拟 (Dry-Run) ``` # 在不修改文件的情况下测试安装 $ npx aiox-core install --dry-run [DRY RUN] Would create: ./my-project/ [DRY RUN] Would copy: .aiox-core/ (45 files) [DRY RUN] Would initialize: Git repository [DRY RUN] Would install: npm dependencies ✔ Dry run completed - no files were modified ``` #### 系统诊断 ``` $ npx aiox-core doctor 🏥 AIOX System Diagnostics ✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0) ✔ npm version: 10.2.3 ✔ Git installed: version 2.43.0 ✔ GitHub CLI: gh 2.40.1 ✔ AIOX: v4.2.11 Configuration: ✔ .aiox-core/ directory exists ✔ Agent files: 11 found ✔ Workflow files: 8 found ✔ Templates: 15 found Dependencies: ✔ @clack/prompts: ^0.7.0 ✔ commander: ^12.0.0 ✔ execa: ^9.0.0 ✔ fs-extra: ^11.0.0 ✔ picocolors: ^1.0.0 ✅ All checks passed! Your installation is healthy. ``` #### 获取帮助 ``` $ npx aiox-core --help Usage: aiox-core [options] [command] AIOX: AI-Orchestrated System for Full Stack Development Options: -V, --version output the version number -h, --help display help for command Commands: init Create new AIOX project with interactive wizard install [options] Install AIOX in current directory info Display system information doctor [options] Run system diagnostics and health checks help [command] display help for command Run 'aiox-core --help' for detailed information about each command. ``` ### 替代方案:克隆并构建 对于想要修改源代码的贡献者或高级用户: ``` # 克隆仓库 git clone https://github.com/SynkraAI/aiox-core.git cd aiox-core # 安装依赖 npm install # 运行安装程序 npm run install:aiox ``` ### 团队快速配置 对于加入项目的团队成员: ``` # 在项目中安装 AIOX npx aiox-core@latest install # 这将: # 1. 检测现有安装(如果有的话) # 2. 安装/更新 AIOX framework # 3. 配置 agents 和 workflows ``` ## 🌟 超越软件开发 - Squads AIOX 的自然语言框架适用于任何领域。Squads 为创意写作、商业策略、健康保健、教育等提供专门的 AI agents。此外,Squads 可以使用并非通用所有情况的功能扩展 AIOX 核心。[查看 Squads 指南](docs/guides/squads-guide.md)并学习如何创建您自己的 Squads! ## 可用的 Agents AIOX 附带 12 个专门的 agents: ### Meta Agents - **aiox-master** - 主编排 agent(包括框架开发能力) - **aiox-orchestrator** - 工作流编排和团队协调 ### 规划 Agents(Web 界面) - **analyst** - 业务分析和 PRD 创建专家 - **pm** (Product Manager) - 产品经理和优先级排序 - **architect** - 系统架构师和技术设计 - **ux-expert** - 用户体验设计和可用性 ### 开发 Agents(IDE) - **sm** (Scrum Master) - Sprint 管理和故事创建 - **dev** - 开发人员和实现 - **qa** - 质量保证和测试 - **po** (Product Owner) - Backlog 管理和故事 - **data-engineer** - 数据库设计和数据建模 - **devops** - CI/CD、基础设施和 git 操作(独占 push 权限) ## 文档和资源 ### 重要指南 - 📖 **[用户指南](docs/guides/user-guide.md)** - 从项目构思到完成的完整分步指南 - 🏗️ **[核心架构](docs/architecture/AIOX-VISUAL-OVERVIEW.md)** - 深入技术探讨和系统设计 - 🚀 **[Squads 指南](docs/guides/squads-guide.md)** - 将 AIOX 扩展到软件开发之外的任何领域 ### 更多文档 - 🤖 **[Squads 指南](docs/guides/squads-guide.md)** - 创建和发布 AI agent 团队 - 📋 **[入门指南](docs/getting-started.md)** - 初学者分步教程 - 🔧 **[故障排除](docs/troubleshooting.md)** - 常见问题的解决方案 - 🎯 **[指导原则](docs/GUIDING-PRINCIPLES.md)** - AIOX 的理念和最佳实践 - 🏛️ **[架构概述](docs/architecture/AIOX-VISUAL-OVERVIEW.md)** - 系统架构详细视图 - ⚙️ **[性能调优指南](docs/performance-tuning-guide.md)** - 优化您的 AIOX 工作流 - 🔒 **[安全最佳实践](docs/security-best-practices.md)** - 安全和数据保护 - 🔄 **[迁移指南](docs/migration-guide.md)** - 从早期版本迁移 - 📦 **[版本控制和发布](docs/versioning-and-releases.md)** - 版本策略 ## 🤖 AIOX Autonomous Development Engine (ADE) AIOX 引入了 **Autonomous Development Engine (ADE)** —— 一个完整的自主开发系统,将需求转化为功能代码。 ### 🎯 什么是 ADE? ADE 是一组 **7 个 Epics**,可实现自主开发执行: | Epic | 名称 | 描述 | | ----- | ---------------- | ------------------------------------------ | | **1** | Worktree Manager | 通过 Git worktrees 实现分支隔离 | | **2** | Migration V2→V3 | 迁移到 autoClaude V3 格式 | | **3** | Spec Pipeline | 将需求转化为可执行规范 | | **4** | Execution Engine | 执行带有 13 个步骤 + 自我批评的规范 | | **5** | Recovery System | 自动故障恢复 | | **6** | QA Evolution | 10 阶段结构化审查 | | **7** | Memory Layer | 模式和洞察的持久记忆 | ### 🔄 主流程 ``` User Request → Spec Pipeline → Execution Engine → QA Review → Working Code ↓ Recovery System ↓ Memory Layer ``` ### ⚡ ADE 快速入门 ``` # 1. 根据需求创建 spec @pm *gather-requirements @architect *assess-complexity @analyst *research-deps @pm *write-spec @qa *critique-spec # 2. 执行已批准的 spec @architect *create-plan @architect *create-context @dev *execute-subtask 1.1 # 3. QA Review @qa *review-build STORY-42 ``` ### 📖 ADE 文档 - **[ADE 完整指南](docs/guides/ade-guide.md)** - 分步教程 - **[Agent 变更](docs/architecture/ADE-AGENT-CHANGES.md)** - 各 agent 的命令和能力 - **[Epic 1 - Worktree Manager](docs/architecture/ADE-EPIC1-HANDOFF.md)** - **[Epic 2 - Migration V2→V3](docs/architecture/ADE-EPIC2-HANDOFF.md)** - **[Epic 3 - Spec Pipeline](docs/architecture/ADE-EPIC3-HANDOFF.md)** - **[Epic 4 - Execution Engine](docs/architecture/ADE-EPIC4-HANDOFF.md)** - **[Epic 5 - Recovery System](docs/architecture/ADE-EPIC5-HANDOFF.md)** - **[Epic 6 - QA Evolution](docs/architecture/ADE-EPIC6-HANDOFF.md)** - **[Epic 7 - Memory Layer](docs/architecture/ADE-EPIC7-HANDOFF.md)** ### 🆕 各 Agent 的新命令 **@devops:** - `*create-worktree`, `*list-worktrees`, `*merge-worktree`, `*cleanup-worktrees` - `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch` **@pm:** - `*gather-requirements`, `*write-spec` **@architect:** - `*assess-complexity`, `*create-plan`, `*create-context`, `*map-codebase` **@analyst:** - `*research-deps`, `*extract-patterns` **@qa:** - `*critique-spec`, `*review-build`, `*request-fix`, `*verify-fix` **@dev:** - `*execute-subtask`, `*track-attempt`, `*rollback`, `*capture-insights`, `*list-gotchas`, `*apply-qa-fix` ## 创建您自己的 Squad Squads 允许将 AIOX 扩展到任何领域。基本结构: ``` squads/seu-squad/ ├── config.yaml # Configuração do squad ├── agents/ # Agentes especializados ├── tasks/ # Fluxos de trabalho de tarefas ├── templates/ # Templates de documentos ├── checklists/ # Checklists de validação ├── data/ # Base de conhecimento ├── README.md # Documentação do squad └── user-guide.md # Guia do usuário ``` 有关详细说明,请参阅 [Squads 指南](docs/guides/squads-guide.md)。 ## 可用的 Squads Squads 是模块化的 AI agent 团队。有关更多信息,请参阅 [Squads 概述](docs/guides/squads-overview.md)。 ### 外部 Squads - **[hybrid-ops](https://github.com/SynkraAI/aiox-hybrid-ops-pedro-valerio)** - 人机混合操作(单独的仓库) ## AIOX Pro **AIOX Pro** (`@aiox-fullstack/pro`) 是 AIOX 的高级模块,为更大规模的团队和项目提供高级功能。 ### 安装 ``` npm install @aiox-fullstack/pro ``` ### 高级功能 - **高级 Squads** - 具有扩展能力的专门 Squads - **Memory Layer** - 跨会话的模式和洞察的持久记忆 - **指标和分析** - 生产力 dashboard 和开发指标 - **Enterprise 集成** - Jira、Linear、Notion 等的连接器 - **分层配置** - 具有继承性的 L1-L4 配置系统 - **许可** - 通过 `aiox pro activate --key ` 进行许可证管理 有关更多信息,请在安装后运行 `npx aiox-core pro --help`。 ## 支持 - 🐛 [Issue 跟踪器](https://github.com/SynkraAI/aiox-core/issues) - Bug 报告和功能请求 - 💡 [功能流程](docs/FEATURE_PROCESS.md) - 如何提出新功能 - 📋 [如何贡献](CONTRIBUTING.md) - 🗺️ [路线图](docs/roadmap.md) - 查看我们正在构建的内容 - 🤖 [Squads 指南](docs/guides/squads-guide.md) - 创建 AI agent 团队 ## Git 工作流和验证 AIOX 实施多层验证系统以确保代码质量和一致性: ### 🛡️ 纵深防御 - 3 层验证 **第 1 层:Pre-commit(本地 - 快速)** - ✅ ESLint - 代码质量 - ✅ TypeScript - 类型检查 - ⚡ 性能:<5s - 💾 启用缓存 **第 2 层:Pre-push(本地 - 故事验证)** - ✅ 故事 checkbox 验证 - ✅ 状态一致性 - ✅ 必需部分 **第 3 层:CI/CD(云端 - 合并必需)** - ✅ 所有测试 - ✅ 测试覆盖率(最低 80%) - ✅ 完整验证 - ✅ GitHub Actions ### 📖 详细文档 - 📋 **[Git 工作流完整指南](docs/git-workflow-guide.md)** - 详细的工作流指南 - 📋 **[CONTRIBUTING.md](CONTRIBUTING.md)** - 贡献指南 ### 可用命令 ``` # 本地验证 npm run lint # ESLint npm run typecheck # TypeScript npm test # Testes npm run test:coverage # Testes com cobertura # AIOX Validator node .aiox-core/utils/aiox-validator.js pre-commit # Validação pre-commit node .aiox-core/utils/aiox-validator.js pre-push # Validação pre-push node .aiox-core/utils/aiox-validator.js stories # Validar todas stories ``` ### 分支保护 使用以下命令配置 master 分支保护: ``` node scripts/setup-branch-protection.js ``` 需要: - 已安装并经过身份验证的 GitHub CLI (gh) - 对仓库的管理员访问权限 ## 贡献 **我们对贡献感到兴奋,并欢迎您的想法、改进和 Squads!** 🎉 要贡献: 1. Fork 仓库 2. 为您的功能创建分支(`git checkout -b feature/MinhaNovaFeature`) 3. 提交您的更改(`git commit -m 'feat: Adicionar nova feature'`) 4. 推送到分支(`git push origin feature/MinhaNovaFeature`) 5. 打开 Pull Request 另请参阅: - 📋 [如何通过 Pull Requests 贡献](docs/how-to-contribute-with-pull-requests.md) - 📋 [Git 工作流指南](docs/git-workflow-guide.md) ## 📄 法律信息 | 文档 | English | 中文 | | --------------------- | ------------------------------------------- | ------------------------------------- | | **许可证** | [MIT License](LICENSE) | - | | **许可模式** | [Core vs Pro](docs/legal/license-clarification.md) | - | | **隐私** | [Privacy Policy](docs/legal/privacy.md) | - | | **使用条款** | [Terms of Use](docs/legal/terms.md) | - | | **行为准则** | [Code of Conduct](CODE_OF_CONDUCT.md) | [PT-BR](docs/pt/code-of-conduct.md) | | **贡献** | [Contributing](CONTRIBUTING.md) | [PT-BR](docs/pt/contributing.md) | | **安全** | [Security](docs/security.md) | [PT-BR](docs/pt/security.md) | | **社区** | [Community](docs/community.md) | [PT-BR](docs/pt/community.md) | | **路线图** | [Roadmap](docs/roadmap.md) | [PT-BR](docs/pt/roadmap.md) | | **更新日志** | [Version History](CHANGELOG.md) | - | ## 贡献者 [![Contributors](https://contrib.rocks/image?repo=SynkraAI/aiox-core)](https://github.com/SynkraAI/aiox-core/graphs/contributors) ### 🌟 社区贡献者
Nikolas de Hor
Nikolas de Hor

💻🐛⚠️👀
用 ❤️ 为 AI 辅助开发社区构建 **[⬆ 返回顶部](#aiox-squad-artificial-intelligence-orchestration-experience)**
标签:AIOX Squad, AI协作者, Claude Code, Copilot, Cursor, DNS解析, Gemini CLI, GNU通用公共许可证, MITM代理, Node.js, NPM包, OSV-Scalibr, Synkra AIOS, 人工智能编排, 代码生成, 全栈开发框架, 工作流自动化, 开发效能, 开源项目, 智能体系统, 暗色界面, 核心框架, 渗透测试工具, 网络安全研究, 自动化开发, 自定义脚本