用途
fork 用于创建一个隔离的探索环境。它基于当前阶段创建一个新的 git worktree,并在新分支 explore/[branch-name] 上进行实验。这样可以在不影响主工作目录的情况下进行尝试,之后可以选择将改动合并回主分支,或者直接丢弃整个探索分支。
主要能力
- 创建 git worktree,路径为 ../[project-dir]-explore-[branch-name]。
- 在新分支 explore/[branch-name] 上工作,分支名带有 explore/ 前缀,明确标记为临时探索分支。
- 在新 worktree 中,所有 .cocoplus/ 状态是共享的(相同文件)。
- 输出 worktree 路径、分支名、合并命令和丢弃命令。
使用方式
使用前需验证当前目录下存在 .cocoplus/ 目录。如果不存在,输出 "CocoPlus not initialized in this directory. Run $pod init to begin." 并停止。
调用格式:
$fork [branch-name]
如果未提供 branch-name,输出 "Usage: $fork [branch-name] — e.g., $fork try-new-schema" 并停止。
创建 worktree 的命令逻辑:
BRANCH_NAME="explore/[branch-name]" WORKTREE_PATH="../[project-dir]-explore-[branch-name]" git worktree add "$WORKTREE_PATH" -b "$BRANCH_NAME"
输出示例:
Exploration worktree created. Branch: explore/[branch-name] Path: [worktree-path]
合并回主分支:
git merge explore/[branch-name]
丢弃探索分支:
git worktree remove [worktree-path] && git branch -d explore/[branch-name]
适用场景
- 需要在不影响主工作目录的情况下尝试新方案、新结构或新代码。
- 希望将实验性改动隔离在独立分支上,便于后续合并或丢弃。
- 需要与主工作目录共享 .cocoplus/ 状态,但代码改动相互隔离。
限制
- 必须在已初始化 CocoPlus 的目录中使用(存在 .cocoplus/)。
- 必须提供 branch-name,否则不会创建 worktree。
- 该技能仅创建 worktree 和分支,不自动合并或删除,需要用户手动执行合并或丢弃命令。
- 关于收费、价格、平台支持等更多信息暂未提供。