用途:aep-executor 是一个执行器抽象,用于在隔离工作区中运行实现类任务,不依赖具体代理宿主(Claude Code 或 Codex)及其可用机制。生命周期类技能统一说一套操作词汇,本技能把每个操作映射为各模式下的具体做法。它作为库被 /aep-launch、/aep-build、/aep-autopilot 消费,也可单独调用做检测干跑。
主要能力:原生优先。Claude Code 启动使用进程内后台子代理 native-bg-subagent(默认),或在存在 claude --bg 时用原生后台会话 claude-bg;Codex 启动使用原生子代理 codex-subagent 或无头 exec 工作器 codex-exec。tmux+cmux 为遗留模式,仅在显式固定(git config aep.executor-backend tmux)或通用宿主上选用。所有模式都在 AEP 创建的 git worktree(.feature-workspaces/<ws>)中运行工作器。
操作契约:detect() 解析宿主、原生能力、固定项并选择模式;spawn(ws, branch, prompt) 启动绑定工作区的实现代理;spawn_evaluator(ws, role) 在模式的评估上下文中启动评估代理,可接受可选的分层努力提示;nudge(ws, msg) 发送中途指令(可操纵模式,claude-bg 下为拉取式);liveness(ws) 判断代理是否在活跃工作;gate(ws) 呈现工作器的人类决策,经主代理轮辐式回答;check(prompt, schema) 在廉价、上下文隔离的代理中运行只读分析提示并返回 JSON;monitor(ws) 读取 .dev-workflow/signals/status.json;present(ws) 提供人类审阅界面;teardown(ws) 清理工作器与工作区。进度通过阶段边界处的信号文件报告,与宿主无关;原生推送通道仅为加速层。
使用方式:先读 references/backends.md,再按所选模式读对应参考文件。脚本:bash scripts/detect-backend.sh [--lifetime long|ephemeral] [--opt-in workflow|tmux] [--json],可用 eval "$(bash scripts/detect-backend.sh)";以及 scripts/spawn-liveness-probe.sh <name> <agent_id>。单独调用时仅报告检测结果与模式选择原因,不实际启动任何东西。
适用场景:需要跨 Claude Code / Codex 宿主运行实现代理、选择后端与启动模式、进行宿主检测、启动评估器、中途干预、人类决策门、定期 tick 检查与合并后清理的编排流程。
限制:模式可用性取决于宿主能力与是否存在 claude --bg;workflow 需显式选择且限 Claude Code;tmux 需显式固定;无法确定宿主时回退 headless(最后手段)。未提供具体版本、收费或性能数据。