aix

AIX 是一个命令行包装工具，用于解析并执行多种类型的 AI 代理命令。

功能特性

• 支持多种 AI 代理工具：opencode、cursor、claude、kiro、iflow
• 支持直接参数传递和命令模板两种模式
• 支持命令模板的元数据解析（Markdown 格式）
• 支持参数占位符替换（$ARGUMENTS）
• 支持跨类型的命令模板加载（--cmd-source 参数）
• 支持带路径分割符的命令名（如 /common/check）
• 支持 dry-run 模式用于调试
• 支持可选的 model 参数

安装

cargo build --release

使用方法

直接参数模式

直接传递参数给对应的 agent 工具：

# opencode
aix opencode "直接参数内容"

# cursor（带 model 参数）
aix cursor --model gpt-4 "直接参数内容"

# claude
aix claude --model claude-3.5 "直接参数内容"

# kiro
aix kiro --model gpt-4 "直接参数内容"

# iflow
aix iflow --model gpt-4 "直接参数内容"

命令模板模式

使用预定义的命令模板：

# 使用模板
aix opencode "/check-code 文件路径"

# 使用带路径的模板
aix cursor "/common/refactor 函数名"

# 跨类型使用模板
aix kiro --cmd-source opencode "/check-code 参数"

Dry-run 模式

查看将要执行的命令，不实际执行：

aix opencode --dry-run "测试参数"

命令模板

命令模板是 Markdown 文件，存储在特定目录下：

• opencode: .opencode/command/ 或 ~/.config/opencode/command/
• cursor: .cursor/commands/ 或 ~/.cursor/commands/
• claude: .claude/commands/ 或 ~/.claude/commands/
• kiro: .kiro/commands/ 或 ~/.kiro/commands/
• iflow: .iflow/commands/ 或 ~/.iflow/commands/

模板格式

带元数据的模板：

---
description: 检查代码质量
---

检查以下代码的 $ARGUMENTS，查找潜在问题和改进建议

简单模板：

检查以下代码的 $ARGUMENTS，查找潜在问题和改进建议

开发

构建

cargo build

运行

cargo run -- <args>

测试

# 运行所有测试
cargo test

# 运行单个测试
cargo test <test_name>

代码检查

# 代码格式化
cargo fmt

# 代码检查
cargo clippy

项目结构

• src/cli.rs - 命令行参数解析和路由
• src/agent.rs - Agent 类型定义和配置
• src/template.rs - 命令模板加载和解析
• src/executor.rs - 命令执行器
• src/main.rs - 程序入口和模块协调

依赖

• clap - 命令行参数解析
• serde_yaml - YAML 元数据解析
• anyhow - 错误处理
• dirs - 目录路径获取