集成 Claude Code
Spark CLI 可以为 Claude Code 生成一组本地 slash commands。Claude Code 根据命令模板理解参数和安全要求，再调用本机 spark 命令。
1. 安装
先完成 Spark CLI 安装与认证，然后执行：
spark integrations install claude
默认写入：
~/.claude/commands
也可以指定目录：
spark integrations install claude --dir ~/.claude/commands
检查安装位置：
spark integrations doctor
安装后重新启动 Claude Code 会话。
:::info 当前集成边界
Claude 安装器当前生成 slash command 文件，不会自动修改 Claude 的 MCP 配置。所有命令通过本机 Spark CLI 执行，并复用 ~/.spark 中的认证 profile。
:::
2. 常用 Slash Commands
| Command | 用途 |
|---|---|
/spark-guide | 查看 Spark CLI 帮助并选择模块 |
/spark-set-access-key | 保存用户提供的 Access Key |
/spark-task-designer | 选择任务设计器 App、版本和操作入口 |
/spark-task-types | 管理任务类型和分类 |
/spark-task-fields | 管理任务字段 |
/spark-task-forms | 管理任务表单 |
/spark-task-workflows | 管理步骤、工作流节点、连线和规则 |
/spark-task-permissions | 管理权限方案和授权项 |
/spark-task-i18n | 管理任务设计器翻译 |
/spark-task-check | 运行任务设计器检查 |
/spark-worklist | 查询任务运行期 Worklist |
/spark-sla | 查看 SLA 设计和运行数据 |
3. 任务设计器示例
/spark-task-designer app list
/spark-task-designer app use spark-sample
/spark-task-workflows workflow list
/spark-task-workflows workflow use "Purchase Approval"
/spark-task-workflows workflow describe --lang zh-CN
/spark-task-workflows 后的参数会追加到 spark-designer task。因此 workflow list 最终执行的是：
spark-designer task workflow list
4. 工作流修改示例
/spark-task-workflows workflow add-node --type status --name "Manager Review" --step "Manager Review" --yes
/spark-task-workflows workflow connect Start "Manager Review" --name Submit --yes
/spark-task-workflows workflow rules 2
写操作前，应让 Claude 明确复述目标 App、版本、工作流、节点或连线。不要把 --yes 用在尚未确认目标的命令上。
5. 运行期示例
/spark-worklist my-pending --app spark-sample --env dev
/spark-worklist my-created --app spark-sample --env test --keyword Purchase
/spark-worklist search 'assignee = currentUser() AND status = OPEN' --app spark-sample --env dev
查看某个任务详情时，可以让 Claude 直接执行 CLI：
请运行 spark task detail DEV-PURCHASE-18 --app spark-sample --env dev，汇总当前步骤、处理人、字段和可用操作。
6. 更新与排查
CLI 更新后重新生成 commands：
spark integrations install claude
排查步骤：
spark integrations doctor
ls ~/.claude/commands/spark-*.md
spark auth status
- slash command 不出现：重新安装并重启 Claude Code。
- 命令存在但执行失败：先在终端直接执行对应
spark ...命令。 - 连接失败：检查当前 Spark profile 和网络。
- 参数含空格：用引号包住 App、工作流、节点或 Filter 名称。