文档/工具与执行
Bash 与后台任务
让 Agent 执行命令、观察长任务输出，并区分运行中和已完成。
Bash 用于在工作区执行测试、构建和命令行工具。让 Agent 运行命令前，明确目标和工作目录；有审批请求时可以查看即将执行的命令。
发起命令任务
例如：“按 package.json 的测试脚本运行测试，告诉我失败的用例和错误，不修改测试。”Agent 应先确认脚本，再执行命令并读取结果。
命令返回成功退出码，和产品行为通过验收不是一回事。检查测试覆盖的范围，以及是否真的执行到了你关心的用例。
长任务在后台运行
较长的命令可以进入后台，工具返回任务标识和运行状态。后续通过输出读取工具查看增量日志，通过终止工具停止不再需要的任务。
看到“后台运行中”时，任务尚未完成。可以要求 Agent 继续读取输出，直到得到退出状态或明确的失败原因。后台命令属于当前应用进程的运行资源，应用退出时会被终止，不保证继续执行；但它的输出日志保存在会话里，重新打开会话后仍可以读到它跑到哪一步。命令结束时会自动通知 Agent。
bash-complete.png截取一次后台命令完成后的记录，保留命令、任务标识、输出和退出状态；不必另拍运行中画面。
失败、停止与权限
命令不存在时，检查工作区依赖和 PATH；目录错误时，确认实际 Worktree。审批拒绝或安全检查阻止命令时，先缩小操作范围，说明需要执行的具体步骤。
停止命令不会撤销已经发生的文件改动或外部操作。需要检查改动时使用代码审阅。需要自己操作交互式 CLI 或 REPL 时，请在系统终端里运行；ActSpace 不内置终端。