用途:这是一套面向特性开发的 Git 规范,用于统一分支命名、worktree 布局、子代理合并与提交信息,支持非多代理、多代理 base 及子代理三种工作流。
主要能力:仅使用 feature 与默认分支(main/master 等价)两类分支。非多代理分支命名模板为 feature/<developer>[/<taskId>]/<taskName>;多代理 base 分支为 feature/<developer>[/<taskId>]/<taskName>/base;子代理分支为 feature/<developer>[/<taskId>]/<taskName>/<agentId>/<subtaskName>。developer 取 git config 名称,未设置时用邮箱前缀;agentId 仅用角色名(如 backend、frontend、test、review、docs),不得含数字后缀、范围或目标信息。各段需规范为小写、仅含 a-z、0-9、.、_、- 的文件系统安全文本。
使用方式:worktree 根目录由 ELITEFORGE_SKILL_GIT_LITE_WORKTREE_ROOT 指定,默认 ${CODEX_HOME:-$HOME/.codex}/worktrees。worktree 路径须镜像分支树,与分支一一对应,一个分支不得被多个 worktree 同时复用。子代理分支完成后必须合并回对应 /base 分支,不得绕过 /base 直接合入默认或发布分支;冲突解决与最终验收由协调代理负责。特性分支合入 master 使用仅快进合并,合并后清理已合并分支;打标签前确保所有特性已合并。提交遵循 Conventional Commits,无需创建 MR/PR。
适用场景:需要按特性持续开发与测试、并在多代理或子代理间隔离实现的团队。
限制:编码前须检查分支,禁止直接在默认分支开发;非多代理流程不得使用 /base;任务若从非多代理转为多代理,需先将分支重命名为对应 /base 再建子代理分支,不得同时保留两种形式。资料未提供安装命令、收费与平台信息。