Agent Skills
› gmickel/flow-next
› flow-next-worktree-kit
flow-next-worktree-kit
GitHub管理Git工作树，支持创建、列表、切换和清理，并复制.env文件。用于并行功能开发、隔离审查或保持工作区整洁。新增共享状态文档说明。
Trigger Scenarios
需要并行处理多个功能分支
进行隔离的代码审查
用户明确提及 worktree
需要清理孤立的工作树目录
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.
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.
Version History
-
cd9ddf8
Current 2026-08-28 18:47
更新文档，补充关于跨工作树共享.flow-state状态及FLOW_STATE_DIR环境变量的说明。
- 8baa538 2026-08-20 07:59
