Comanda - 声明式AI流水线

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

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

安装

bash

macOS

brew install kris-hansen/comanda/comanda

或通过 Go 安装

go install github.com/kris-hansen/comanda@latest

然后配置 API 密钥：
bash
comanda configure

命令

生成工作流

通过自然语言创建 YAML 工作流：

bash
comanda generate

示例

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

可视化工作流

显示工作流结构的 ASCII 图表：

bash
comanda chart
comanda chart workflow.yaml --verbose

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

处理/执行工作流

运行工作流文件：

bash
comanda process

带输入

cat file.txt | comanda process analyze.yaml echo 设计一个 REST API | comanda process multi-agent.yaml

多个工作流

comanda process step1.yaml step2.yaml step3.yaml

查看/编辑工作流

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

bash
cat workflow.yaml

工作流 YAML 格式

基本步骤

yaml
step_name:
input: STDIN | NA | filename | $VARIABLE
model: gpt-4o | claude-sonnet-4-20250514 | gemini-pro | ollama/llama2 | claude-code | gemini-cli
action: 给模型的指令
output: STDOUT | filename | $VARIABLE

并行执行

yaml
parallel-process:
analysis-one:
input: STDIN
model: claude-sonnet-4-20250514
action: 分析安全问题
output: $SECURITY

analysis-two:
input: STDIN
model: gpt-4o
action: 分析性能问题
output: $PERF

链式步骤

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

summarize:
input: $POINTS
model: claude-sonnet-4-20250514
action: 创建执行摘要
output: STDOUT

生成+处理（元工作流）

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

run_it:
input: NA
process:
workflow_file: generated.yaml

可用模型

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

提供商	模型
OpenAI	gpt-4o, gpt-4o-mini, o1, o1-mini
Anthropic

claude-sonnet-4-20250514, claude-opus-4-20250514 |
| Google | gemini-pro, gemini-flash |
| Ollama | ollama/llama2, ollama/mistral 等 |
| 代理型 | claude-code, gemini-cli, openai-codex |

示例位置

查看 ~/clawd/comanda/examples/ 获取工作流示例：

• - agentic-loop/ - 自主代理模式
• claude-code/ - Claude Code 集成
• gemini-cli/ - Gemini CLI 工作流
• document-processing/ - PDF、文本提取
• database-connections/ - 数据库查询工作流

故障排除

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