Agent Skills
› gmickel/flow-next
› flow-next-worktree-kit
flow-next-worktree-kit
GitHub管理Git worktrees的创建、列表、切换和清理，支持并行功能开发、隔离审查及工作区整洁。提供.env文件复制功能，确保多代理并发时的状态安全与目录隔离。
Trigger Scenarios
用户需要并行处理多个特性分支
需要进行独立的代码审查环境
用户明确提到使用worktrees
需要清理或切换现有的git工作树
Install
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.
WORKTREE_SH="${CODEX_HOME:-$HOME/.codex}/scripts/worktree.sh"
[ -f "$WORKTREE_SH" ] || WORKTREE_SH="<plugin-root>/skills/flow-next-worktree-kit/scripts/worktree.sh" # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
bash "$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.
Version History
-
7db792a
Current 2026-09-28 08:13
增加对plugin-root路径的动态解析支持，优化脚本加载逻辑。
-
cd9ddf8
2026-08-28 18:47
更新文档，补充关于跨工作树共享.flow-state状态及FLOW_STATE_DIR环境变量的说明。
- 8baa538 2026-08-20 07:59
