SuperAPI AI 工具集

fork

编程与开发

查看项目

更新于 10-23 23:07

技能介绍

用途

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 和分支,不自动合并或删除,需要用户手动执行合并或丢弃命令。
  • 关于收费、价格、平台支持等更多信息暂未提供。