# 元代理命令参考 > 🌐 [EN](../meta-agent-commands.md) | [PT](../pt/meta-agent-commands.md) | [ES](../es/meta-agent-commands.md) | **ZH** --- Synkra AIOX 所有元代理命令的完整参考指南。 ## 目录 1. [命令语法](#命令语法) 2. [核心命令](#核心命令) 3. [代理管理](#代理管理) 4. [任务操作](#任务操作) 5. [工作流命令](#工作流命令) 6. [代码生成](#代码生成) 7. [分析与改进](#分析与改进) 8. [内存层](#内存层) 9. [自我修改](#自我修改) 10. [系统命令](#系统命令) 11. [高级命令](#高级命令) ## 命令语法 所有元代理命令遵循此模式： ``` *command-name [required-param] [--optional-flag value] ``` - 命令以 `*`（星号）开头 - `[]` 中的参数是必需的 - 标志以 `--` 开头，可能有值 - 可以组合多个标志 ### 示例 ```bash *create-agent my-agent *analyze-code src/app.js --depth full *generate-tests --type unit --coverage 80 ``` ## 核心命令 ### *help 显示所有可用命令或获取特定命令的帮助。 ```bash *help # 显示所有命令 *help create-agent # 特定命令的帮助 *help --category agents # 按类别显示命令 ``` ### *status 显示当前系统状态和活动代理。 ```bash *status # 基本状态 *status --detailed # 详细系统信息 *status --health # 健康检查结果 ``` ### *config 查看或修改配置。 ```bash *config # 查看当前配置 *config --set ai.model gpt-4 # 设置配置值 *config --reset # 重置为默认值 *config --export # 导出配置 ``` ### *version 显示版本信息。 ```bash *version # 当前版本 *version --check-update # 检查更新 *version --changelog # 显示更新日志 ``` ## 代理管理 ### *create-agent 创建新的 AI 代理。 ```bash *create-agent [options] 选项： --type 代理类型：assistant、analyzer、generator、specialist --template 使用模板：basic、advanced、custom --capabilities 交互式能力构建器 --from-file 从 YAML 定义创建 示例： *create-agent code-reviewer --type analyzer *create-agent api-builder --template advanced *create-agent custom-bot --from-file agents/template.yaml ``` ### *list-agents 列出所有可用代理。 ```bash *list-agents # 列出所有代理 *list-agents --active # 仅活动代理 *list-agents --type analyzer # 按类型过滤 *list-agents --detailed # 显示完整详情 ``` ### *activate 激活代理以供使用。 ```bash *activate # 激活单个代理 *activate agent1 agent2 # 激活多个 *activate --all # 激活所有代理 *activate --type assistant # 按类型激活 ``` ### *deactivate 停用代理。 ```bash *deactivate # 停用单个代理 *deactivate --all # 停用所有代理 *deactivate --except agent1 # 停用除指定代理外的所有代理 ``` ### *modify-agent 修改现有代理配置。 ```bash *modify-agent [options] 选项： --add-capability 添加新能力 --remove-capability 移除能力 --update-instructions 更新指令 --version 更新版本 --interactive 交互式修改 示例： *modify-agent helper --add-capability translate *modify-agent analyzer --update-instructions *modify-agent bot --interactive ``` ### *delete-agent 删除代理（需确认）。 ```bash *delete-agent # 删除单个代理 *delete-agent --force # 跳过确认 *delete-agent --backup # 删除前创建备份 ``` ### *clone-agent 创建现有代理的副本。 ```bash *clone-agent # 基本克隆 *clone-agent bot bot-v2 --modify # 克隆并修改 ``` ## 任务操作 ### *create-task 创建新的可重用任务。 ```bash *create-task [options] 选项： --type 任务类型：command、automation、analysis --description 任务描述 --parameters 交互式定义参数 --template 使用任务模板 示例： *create-task validate-input --type command *create-task daily-backup --type automation *create-task code-metrics --template analyzer ``` ### *list-tasks 列出可用任务。 ```bash *list-tasks # 列出所有任务 *list-tasks --type automation # 按类型过滤 *list-tasks --recent # 最近使用的任务 *list-tasks --search # 搜索任务 ``` ### *run-task 执行特定任务。 ```bash *run-task [params] 示例： *run-task validate-input --data "user input" *run-task generate-report --format pdf *run-task backup-database --incremental ``` ### *schedule-task 计划任务执行。 ```bash *schedule-task 计划格式： --cron "0 0 * * *" Cron 表达式 --every "1 hour" 间隔 --at "14:30" 特定时间 --on "monday,friday" 特定日期 示例： *schedule-task cleanup --cron "0 2 * * *" *schedule-task report --every "6 hours" *schedule-task backup --at "03:00" --on "sunday" ``` ### *modify-task 更新任务配置。 ```bash *modify-task [options] 选项： --add-param 添加参数 --update-logic 更新实现 --change-type 更改任务类型 --rename 重命名任务 ``` ## 工作流命令 ### *create-workflow 创建自动化工作流。 ```bash *create-workflow [options] 选项： --steps 交互式步骤构建器 --trigger 触发器类型：manual、schedule、event --template 使用工作流模板 --from-file 从 YAML 导入 示例： *create-workflow ci-pipeline --trigger push *create-workflow daily-tasks --trigger "schedule:0 9 * * *" *create-workflow deployment --template standard-deploy ``` ### *list-workflows 显示可用工作流。 ```bash *list-workflows # 所有工作流 *list-workflows --active # 当前运行中 *list-workflows --scheduled # 已计划的工作流 *list-workflows --failed # 失败的执行 ``` ### *run-workflow 执行工作流。 ```bash *run-workflow [options] 选项： --params 工作流参数 --skip-steps 跳过特定步骤 --dry-run 预览而不执行 --force 即使正在运行也强制运行 示例： *run-workflow deploy --params '{"env":"staging"}' *run-workflow backup --skip-steps "upload" *run-workflow test-suite --dry-run ``` ### *stop-workflow 停止运行中的工作流。 ```bash *stop-workflow # 停止特定工作流 *stop-workflow --all # 停止所有工作流 *stop-workflow --force # 强制停止 ``` ### *workflow-status 检查工作流执行状态。 ```bash *workflow-status # 单个工作流状态 *workflow-status --all # 所有工作流状态 *workflow-status --history # 执行历史 ``` ## 代码生成 ### *generate-component 使用 AI 辅助生成新组件。 ```bash *generate-component [options] 选项： --type 组件类型：react、vue、angular、web-component --features 组件特性 --style 样式：css、scss、styled-components --tests 生成测试 --storybook 生成 Storybook 故事 --template 使用组件模板 示例： *generate-component UserProfile --type react --features "avatar,bio,stats" *generate-component DataTable --type vue --tests --storybook *generate-component CustomButton --template material-ui ``` ### *generate-api 生成 API 端点。 ```bash *generate-api [options] 选项： --operations CRUD 操作：create、read、update、delete --auth 添加认证 --validation 添加输入验证 --docs 生成 API 文档 --tests 生成 API 测试 --database 数据库类型：postgres、mongodb、mysql 示例： *generate-api users --operations crud --auth --validation *generate-api products --database mongodb --docs *generate-api analytics --operations "read" --tests ``` ### *generate-tests 生成测试套件。 ```bash *generate-tests [target] [options] 选项： --type 测试类型：unit、integration、e2e --framework 测试框架：jest、mocha、cypress --coverage 目标覆盖率百分比 --mocks 生成模拟数据 --fixtures 生成测试夹具 示例： *generate-tests src/utils/ --type unit --coverage 90 *generate-tests src/api/ --type integration --mocks *generate-tests --type e2e --framework cypress ``` ### *generate-documentation 生成文档。 ```bash *generate-documentation [target] [options] 选项： --format 格式：markdown、html、pdf --type 文档类型：api、user-guide、technical --include-examples 添加代码示例 --diagrams 生成图表 --toc 生成目录 示例： *generate-documentation src/ --type api --format markdown *generate-documentation --type user-guide --include-examples *generate-documentation components/ --diagrams --toc ``` ## 分析与改进 ### *analyze-framework 分析整个代码库。 ```bash *analyze-framework [options] 选项： --depth 分析深度：surface、standard、deep --focus 关注领域：performance、security、quality --report-format 格式：console、json、html --save-report 保存分析报告 --compare-previous 与之前的分析比较 示例： *analyze-framework --depth deep *analyze-framework --focus "performance,security" *analyze-framework --save-report reports/analysis.json ``` ### *analyze-code 分析特定代码文件。 ```bash *analyze-code [options] 选项： --metrics 显示代码指标 --complexity 分析复杂度 --dependencies 分析依赖项 --suggestions 获取改进建议 --security 安全分析 示例： *analyze-code src/app.js --metrics --complexity *analyze-code src/api/ --security --suggestions *analyze-code package.json --dependencies ``` ### *improve-code-quality 使用 AI 辅助改进代码质量。 ```bash *improve-code-quality [options] 选项： --focus 关注点：readability、performance、maintainability --refactor-level 级别：minor、moderate、major --preserve-logic 不改变功能 --add-comments 添加解释性注释 --fix-eslint 修复 linting 问题 示例： *improve-code-quality src/utils.js --focus readability *improve-code-quality src/legacy/ --refactor-level major *improve-code-quality src/api.js --fix-eslint --add-comments ``` ### *suggest-refactoring 获取重构建议。 ```bash *suggest-refactoring [options] 选项： --type 重构类型：extract、inline、rename --scope 范围：function、class、module、project --impact-analysis 显示更改影响 --preview 预览更改 --auto-apply 自动应用建议 示例： *suggest-refactoring src/helpers.js --type extract *suggest-refactoring src/models/ --scope module *suggest-refactoring src/app.js --preview --impact-analysis ``` ### *detect-patterns 检测代码模式和反模式。 ```bash *detect-patterns [path] [options] 选项： --patterns 要检测的特定模式 --anti-patterns 关注反模式 --suggest-fixes 建议模式改进 --severity 最低严重级别：low、medium、high 示例： *detect-patterns --anti-patterns --suggest-fixes *detect-patterns src/ --patterns "singleton,factory" *detect-patterns --severity high ``` ## 内存层 ### *memory 内存层操作。 ```bash *memory [options] 操作： status 显示内存层状态 search 语义搜索 rebuild 重建内存索引 clear-cache 清除内存缓存 optimize 优化内存性能 export 导出内存数据 import 导入内存数据 示例： *memory status *memory search "authentication flow" *memory rebuild --verbose *memory optimize --aggressive ``` ### *learn 从代码更改和模式中学习。 ```bash *learn [options] 选项： --from 来源：recent-changes、commits、patterns --period