SuperAPI AI 工具集

maestro-fork

通用与其它

查看项目

更新于 10-15 20:10

技能介绍

用途:为并行开发创建或同步 session 工作树,支撑多会话并行推进。命令使用 session 术语,底层工作流文件 fork.md 中的 milestone 为 session 的旧别名,--session 对应工作流的 -m,state.json.sessions[] 对应 state.json.milestones[]。

主要能力与模式:Fork 模式创建工作树;Sync 模式将 main 合并进工作树分支。支持 --session 指定会话,--base <ref> 指定 fork 起点(分支、标签或提交哈希,默认 HEAD),--sync 触发同步。会话解析、工作树布局与产物作用域规则由 fork.md 定义。

Fork 流程与门槛:先校验会话从 state.json.sessions[] 解析成功、该会话无活动工作树、且不在工作树内运行;随后创建分支 session/{slug} 的 git worktree,复制共享 .workflow/ 文件(project.md、config.json、specs/);最后经 request_user_input 确认后写入 worktree-scope.json、作用域化的 state.json,并在主工作树更新 worktrees.json 注册表。任一门槛缺失即阻断,工作树不可用。

Sync 流程:完成 main 到工作树分支的合并并重新复制共享产物,存在未解决冲突即阻断。

完成后建议:Fork 完成后 cd {wt.path} 并继续后续流程,或用 maestro delegate 自动化;Sync 完成后在工作树继续工作,遇冲突手动解决后重试。

错误码:E001 项目未初始化;E002 无路线图;E003 在工作树内运行;E004 未提供会话 ID;E005 state.json 无会话;E006 会话不存在;E007 该会话无活动工作树(--sync);E008 会话已有活动工作树。

限制:必须在主工作树运行,不能在工作树内执行;需已初始化项目且存在路线图与会话定义;注册表写入与状态写入需用户确认。安装与价格等资料暂未提供。