SynkraAI/aiox-core
GitHub: SynkraAI/aiox-core
一个面向全栈开发的AI Agent编排框架,通过多专业Agent协作实现从需求规划到代码交付的完整开发流程自动化。
Stars: 2266 | Forks: 753
# AIOX Squad: Artificial Intelligence Orchestration eXperience
[](https://www.npmjs.com/package/aiox-core)
[](LICENSE)
[](https://nodejs.org/)
[](https://github.com/SynkraAI/aiox-core/actions/workflows/ci.yml)
[](https://codecov.io/gh/SynkraAI/aiox-core)
[](https://aioxsquad.ai)
[](LICENSE)
[](CONTRIBUTING.md)
[](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) | - |
## 贡献者
[](https://github.com/SynkraAI/aiox-core/graphs/contributors)
### 🌟 社区贡献者
用 ❤️ 为 AI 辅助开发社区构建
**[⬆ 返回顶部](#aiox-squad-artificial-intelligence-orchestration-experience)**
![]() Nikolas de Hor 💻🐛⚠️👀 |
标签:AIOX Squad, AI协作者, Claude Code, Copilot, Cursor, DNS解析, Gemini CLI, GNU通用公共许可证, MITM代理, Node.js, NPM包, OSV-Scalibr, Synkra AIOS, 人工智能编排, 代码生成, 全栈开发框架, 工作流自动化, 开发效能, 开源项目, 智能体系统, 暗色界面, 核心框架, 渗透测试工具, 网络安全研究, 自动化开发, 自定义脚本
