imux
imux

AI Agent 工作流

当每个 agent 会话都有清晰工作区、可见文件、边界明确的目标和人工审查循环时，imux 的效果最好。这些模式适用于 Claude Code、Codex、Gemini CLI、OpenCode、Aider 或任何终端型编码 agent。

# One workspace, one concrete task
icc new-workspace
cd ~/work/app
claude

# Mark state for the operator
icc notify --title "Agent waiting" --body "Review the proposed patch"
icc sidebar status set review --label "Review" --value "needed"
Reusable workflow scopes:
app     shared imux recipes such as build, test, review, release checks
user    your personal prompt templates, verification steps, handoff formats
project repo-specific commands and acceptance checks, kept with the project

每个工作区只承载一个有意义的目标

一个工作区应该代表一个仓库、一个远程主机或一个具体调查。这样终端、文件资源管理器、Git 状态、浏览器界面和监督器上下文才会对齐。

  • 为互不相关的任务创建独立工作区，不要把所有 agent 堆在一个终端里。
  • 用目标结果命名工作区，而不是只用工具名命名。
  • 打开最相关文件，让当前任务旁边始终有证据。

把终端 agent 当作执行引擎，而不是隐藏 worker

agent 可以运行在 shell 里，但操作者应该持续看到外围证据。imux 会把文件、浏览器预览、通知和 Git 状态绑定在同一个工作区中。

  • 从仓库根目录或目标远程路径启动 agent。
  • 给出边界清楚、完成条件明确的任务。
  • 继续下一步前，先验证改动文件和命令输出。

用通知和元数据路由注意力

当脚本能把进度、完成或失败信号送进工作区 UI，长时间运行的 agent 就更容易监管。

  • 在 agent 需要人工输入时从 hook 调用 `icc notify`。
  • 用侧栏状态项显示 CI、部署、预览或审查状态。
  • 用最新未读跳转快捷键回到下一个需要关注的工作区。

把重复任务沉淀成工作流库配方

v2.0.2 继续把重复命令和 agent 操作推进成更明确的一等模型。一个工作流应该足够小，方便检查、复用和验证，而不是变成另一层隐藏自动化。

  • 应用级工作流适合常见动作，例如 build、test、review 和 release 检查。
  • 用户级工作流适合个人常用 agent 提示词、验证步骤和交接模板。
  • 项目级工作流适合仓库专属命令、环境假设和应该跟随项目走的验收检查。

把设置就绪度当作启动门槛

启动长时间 agent 前，先检查真正相关的设置状态：provider 配置、CLI 可用性、通知 hook、工作区目录、远程连接，以及浏览器或源码状态上下文。

  • 在任务变紧急前补齐缺失的 provider 或 CLI 设置。
  • 把通知 hook 当成有用的路由基础设施，而不是审查流程的替代品。
  • 如果就绪度提示和实际情况不一致，直接在 imux 终端里验证对应 CLI 或保存配置。

让审查循环保持本地且具体

agent 的输出不足以直接采纳。imux 的设计目标是让人能检查路径、运行测试、打开浏览器、读取控制台错误，并在接受工作前审查 Git 状态。

  • 每次有意义的编辑后立即打开被改文件。
  • 先运行最窄但有用的验证命令。
  • 只有在审查可见工作树后，才打包、提交或部署。

好的 agent 简报

  • 先说明仓库、文件夹或 SSH 目标。
  • 用一句话说明当前需要的准确结果。
  • 如果已知，列出关键文件、命令、URL 或日志。
  • 在 agent 改代码前定义完成标准。
  • 如果已有可复用工作流或验证配方，直接点名使用。
  • 要求给出验证证据，而不只是总结。
Use the terminal agent for execution, use readiness as the launch gate, then use imux surfaces for evidence: files, browser state, command output, reusable workflow results, and source control.