Agent Skills
› gmickel/flow-next
› flow-next-worktree-kit
flow-next-worktree-kit
GitHub管理Git工作树及复制环境变量，支持并行开发、隔离审查和清理。提供创建、切换、列出、清理工作树及同步.env文件的功能，确保工作区整洁与安全。
触发场景
用户提到 worktree 或工作树
需要并行进行特性开发
需要隔离环境进行代码审查
需要清理工作树以恢复干净工作区
安装
npx skills add gmickel/flow-next --skill flow-next-worktree-kit -g -y
SKILL.md
Frontmatter
{
"name": "flow-next-worktree-kit",
"description": "Manage git worktrees (create\/list\/switch\/cleanup) and copy .env files. Use for parallel feature work, isolated review, clean workspace, or when user mentions worktrees."
}
Worktree kit
Use the manager script for all worktree actions.
bash "${CODEX_HOME:-$HOME/.codex}/scripts/worktree.sh" <command> [args]
Commands:
create <name> [base]listswitch <name>(prints the worktree path; it cannot change your shell's directory - usecd "$(... switch <name>)")cleanup [<name>...] [--yes](no args = interactive; names skip the prompt;--yesskips the confirmation, required off a terminal)copy-env <name>
Safety notes:
createdoes not change the current branchcreatesets no upstream on the new branch (--no-track) - under the upstream-based push modes (simple,upstream,current) a baregit pushcannot aim at the base branch; under the defaultpush.default=simple(withoutpush.autoSetupRemote) the first push needsgit push -u origin <name>(legacypush.default=matchingpushes all name-matched branches regardless of upstream)cleanupdoes not force-remove worktrees and does not delete branchescleanupdeletes the worktree directory (including ignored files); removal fails if the worktree is not clean.env*is copied with no overwrite (symlinks skipped)- refuses to operate if
.worktrees/or any worktree path component is a symlink copy-envonly targets registered worktreesoriginfetch is optional; local base refs are allowed- fetch from
originonly when base looks like a branch - Worktrees live under
.worktrees/ createinitializes.worktrees/.gitignore(*plus!.gitignore) when absent, sogit add -Acannot stage nested worktrees as gitlinks; existing custom ignore files are preserved
Shared claim state. Parallel agents in sibling worktrees driving flowctl on the same repo share claim state via .git/flow-state. Set FLOW_STATE_DIR per agent (outside the tree) when running flow pipelines concurrently.
版本历史
-
cd9ddf8
当前 2026-08-28 18:47
更新文档，补充关于跨工作树共享.flow-state状态及FLOW_STATE_DIR环境变量的说明。
- 8baa538 2026-08-20 07:59
