名称： comanda
版本： 1.0.1
描述： 使用 comanda CLI 生成、可视化和执行声明式 AI 流水线。适用于从自然语言创建 LLM 工作流、查看工作流图表、编辑 YAML 工作流文件或处理/运行 comanda 工作流。支持多模型编排（OpenAI、Anthropic、Google、Ollama、Claude Code、Gemini CLI、Codex）。
主页： https://comanda.sh
仓库： https://github.com/kris-hansen/comanda

Comanda - 声明式 AI 流水线

🌐 官网: comanda.sh | 📦 GitHub: kris-hansen/comanda

Comanda 使用 YAML 定义 LLM 工作流，并通过命令行运行。工作流可以串联多个 AI 模型、并行执行步骤，并在处理阶段之间传递数据。

安装

# macOS
brew install kris-hansen/comanda/comanda

# 或通过 Go 安装
go install github.com/kris-hansen/comanda@latest

然后配置 API 密钥：

comanda configure

命令

生成工作流

根据自然语言描述创建 YAML 工作流文件：

comanda generate <输出文件.yaml> "<提示词>"

# 示例
comanda generate summarize.yaml "创建一个用于总结文本输入的工作流"
comanda generate review.yaml "分析代码中的错误，然后建议修复方案" -m claude-sonnet-4-20250514

可视化工作流

以 ASCII 图表形式显示工作流结构：

comanda chart <工作流文件.yaml>
comanda chart workflow.yaml --verbose

显示步骤关系、使用的模型、输入/输出链以及有效性。

处理/执行工作流

运行工作流文件：

comanda process <工作流文件.yaml>

# 带输入
cat file.txt | comanda process analyze.yaml
echo "设计一个 REST API" | comanda process multi-agent.yaml

# 多个工作流
comanda process step1.yaml step2.yaml step3.yaml

查看/编辑工作流

工作流文件为 YAML 格式。可直接读取以理解或修改：

cat workflow.yaml

工作流 YAML 格式

基础步骤

步骤名称:
  input: STDIN | NA | 文件名 | $变量名
  model: gpt-4o | claude-sonnet-4-20250514 | gemini-pro | ollama/llama2 | claude-code | gemini-cli
  action: "给模型的指令"
  output: STDOUT | 文件名 | $变量名

并行执行

并行处理:
  分析一:
    input: STDIN
    model: claude-sonnet-4-20250514
    action: "分析安全问题"
    output: $安全报告

  分析二:
    input: STDIN
    model: gpt-4o
    action: "分析性能问题"
    output: $性能报告

链式步骤

提取:
  input: document.pdf
  model: gpt-4o
  action: "提取关键点"
  output: $关键点

总结:
  input: $关键点
  model: claude-sonnet-4-20250514
  action: "生成执行摘要"
  output: STDOUT

生成 + 处理（元工作流）

创建工作流:
  input: NA
  generate:
    model: gpt-4o
    action: "创建一个分析情感的工作流"
    output: generated.yaml

运行它:
  input: NA
  process:
    workflow_file: generated.yaml

可用模型

运行 comanda configure 来设置 API 密钥。常用模型：

示例位置

查看 ~/clawd/comanda/examples/ 目录中的工作流示例：
- agentic-loop/ - 自主代理模式
- claude-code/ - Claude Code 集成
- gemini-cli/ - Gemini CLI 工作流
- document-processing/ - PDF、文本提取
- database-connections/ - 数据库查询工作流

故障排除

• "model not configured"：运行 comanda configure 添加 API 密钥
• 工作流验证错误：使用 comanda chart workflow.yaml 可视化并检查有效性
• 调试模式：添加 --debug 标志以获取详细日志