Lobster

参与贡献：源代码与 Pull Request 欢迎提交至 github.com/guwidoe/lobster-skill

AI agent 的工作流运行时 —— 支持类型定义的流水线，内置审批关卡（approval gates）。

CLI 位置

# 设置别名（请根据实际安装路径调整）
LOBSTER="node /home/molt/clawd/tools/lobster/bin/lobster.js"

# 或全局安装：npm install -g @clawdbot/lobster
# 然后使用：lobster ''

快速参考

# 运行流水线（human 模式 — 输出格式化友好）
$LOBSTER ''

# 运行流水线（tool 模式 — 返回 JSON 封装格式，便于集成）
$LOBSTER run --mode tool ''

# 运行工作流文件
$LOBSTER run path/to/workflow.lobster

# 审批后恢复执行
$LOBSTER resume --token "" --approve yes|no

# 列出可用命令 / 工作流
$LOBSTER commands.list
$LOBSTER workflows.list

核心命令

内置工作流

# 监控 PR 变更（有状态 — 记住上次运行状态）
$LOBSTER "workflows.run --name github.pr.monitor --args-json '{"repo":"owner/repo","pr":123}'"

# 监控 PR 并仅在发生变更时发出通知
$LOBSTER "workflows.run --name github.pr.monitor.notify --args-json '{"repo":"owner/repo","pr":123}'"

审批流程（Tool 模式）

当流水线执行到 approve 时，将返回如下响应：

{
  "status": "needs_approval",
  "requiresApproval": {
    "prompt": "发送 3 封邮件？",
    "items": [...],
    "resumeToken": "eyJ..."
  }
}

继续执行需调用：

$LOBSTER resume --token "eyJ..." --approve yes

示例流水线

# 列出最近的 PR，筛选已合并项，并以表格形式展示
$LOBSTER 'exec --json --shell "gh pr list --repo owner/repo --json number,title,state --limit 20" | where "state=MERGED" | table'

# 获取数据 → 请求审批 → 后续处理
$LOBSTER run --mode tool 'exec --json --shell "echo [{"id":1},{"id":2}]" | approve --prompt "处理这些数据？" | pick id | json'

# 与上一次运行结果对比（仅在内容变化时输出）
$LOBSTER 'exec --json --shell "gh pr view 123 --repo o/r --json state,title" | diff.last --key "pr:o/r#123" | json'

工作流文件（.lobster）

采用 YAML/JSON 格式，定义步骤、条件及审批关卡：

name: pr-review-reminder
steps:
  - id: fetch
    command: gh pr list --repo ${repo} --json number,title,reviewDecision
  - id: filter
    command: jq '[.[] | select(.reviewDecision == "")]'
    stdin: $fetch.stdout
  - id: notify
    command: echo "待评审的 PR：" && cat
    stdin: $filter.stdout
    approval: required

执行方式：$LOBSTER run workflow.lobster --args-json '{"repo":"owner/repo"}'

Clawdbot 集成

Lobster 可通过 clawd.invoke 调用 Clawdbot 工具：

$LOBSTER 'clawd.invoke --tool message --action send --args-json "{"target":"123","message":"hello"}"'

需配置环境变量：CLAWD_URL 和 CLAWD_TOKEN。

状态目录

Lobster 默认将状态存储于 ~/.lobster/state/。可通过环境变量 LOBSTER_STATE_DIR 覆盖该路径。