用途
GSD Executor 是 GSD 工作流中的执行代理,在 Antigravity 2.0+ 中由 /execute 工作流作为 gsd-executor 子代理调用,每个计划启动一个实例;在旧版本中由 /execute 在当前上下文中内联应用同一套规则。其目标只有一个:完整执行计划、为每个任务提交、生成 SUMMARY.md、更新 STATE.md。
主要能力
- 状态与计划加载:执行前读取 .gsd/STATE.md,解析当前位置、累积决策与阻塞项;若文件缺失但 .gsd/ 存在则从现有产物重建;若 .gsd/ 不存在则报错。随后解析计划的前置元数据(phase、plan、type、autonomous、wave、depends_on)、目标、上下文文件、任务类型、验证标准与成功标准。
- 三种执行模式:模式 A 全自动顺序执行所有任务并生成总结;模式 B 遇检查点即停止并返回结构化检查点消息,由新的续接代理继续;模式 C 为续接模式,先核对已完成任务的提交是否存在,再从指定任务恢复。
- 偏差处理规则:规则 1 自动修复缺陷(含安全漏洞、逻辑错误、竞态等);规则 2 自动补充关键缺失功能(错误处理、输入校验、鉴权、CSRF、限流、数据库索引等);规则 3 自动修复阻塞问题(缺失依赖、导入路径、环境变量、构建配置等);规则 4 涉及架构性变更时必须停止并请求用户决策。规则冲突或不确定时按规则 4 处理。
- 认证门处理:任务执行中遇到认证错误不视为失败,而是停止并返回 human-action 检查点,给出确切认证步骤与验证命令。
- 检查点协议:checkpoint:human-verify 用于自动化后的视觉/功能验证;checkpoint:decision 用于需要用户选择的实现方案;checkpoint:human-action 用于不可避免的手动步骤。返回统一结构,包含类型、计划、进度、已完成任务表、当前任务与待办事项。
- 任务提交协议:每个任务完成后分别执行 git add -A、git commit、git log -1 --oneline 三条独立命令,不得使用 && 或 || 串联(尤其在 Windows PowerShell 5.1 下会解析失败),必须读取 git log 输出确认提交指向当前任务;禁止 --allow-empty,不伪造提交;无跟踪变更的任务不算完成,目录创建不能作为独立任务。
- 总结与上下文管理:计划完成后创建 .gsd/phases/{N}/{plan}-SUMMARY.md,记录任务表、提交哈希、偏差、文件变更与验证结果;上下文按需加载,只读当前计划、STATE.md 及被引用的文件,避免累积全部 SUMMARY 与架构文档。
使用方式
该技能由 /execute 工作流调用,而非独立命令行工具。执行流程为:加载项目状态 → 加载计划 → 判定执行模式 → 逐任务执行并验证 → 提交并记录哈希 → 生成 SUMMARY.md / 更新 STATE.md。遇到检查点或认证门时按固定格式返回并等待用户操作。
适用场景
适用于已用 GSD 初始化、以计划文件组织阶段任务的软件开发项目,尤其是需要逐任务原子提交、可追溯提交记录、需要人工检查点介入的自动化编码流程。
限制
资料未提供该技能的独立安装方式、收费模式、支持平台(除 Antigravity 2.0+ 的提及外)及具体 CLI/API 集成细节;认证门示例中的 Vercel 命令仅为示例,不代表内置集成。涉及架构变更必须人工介入,无法全自动完成。