branchout
Pi 平台安全创建 Git 分支的 Skill
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：branchout。 它的用途是：Pi 平台安全创建 Git 分支的 Skill 完整的 Skill 内容见：https://321skill.com/skills/branchout/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'使用 branchout 从 develop 分支创建一个名为 feature/login 的新分支。' 它会自动调用 branchout 命令，校验 develop 分支是否存在，然后创建并切换到新分支，整个过程无需手动输入 git 命令。
介绍
branchout 是 Pi 平台上一个专为 Git 分支管理设计的 Skill，它允许用户从指定的源分支安全地创建新分支，避免误操作或分支冲突。在日常开发中，频繁切换和创建分支容易导致混乱，尤其是当团队协作时，分支来源不明确可能引发合并冲突。branchout 通过明确指定源分支，确保每次创建的新分支都基于正确的起点，从而降低风险。
使用 branchout 非常简单：在 Pi 环境中直接调用 branchout 命令，并指定源分支名称和新分支名称即可。例如，branchout --source develop --new feature/login 会从 develop 分支创建一个名为 feature/login 的新分支。该命令会自动校验源分支是否存在，并在创建后自动切换到新分支，省去手动切换的步骤。
branchout 特别适合在 Pi 平台上进行智能体开发、全栈项目或后端服务的开发者。如果你经常需要从不同的基线分支（如 main、develop、release）创建功能分支或修复分支，这个 Skill 能显著提升效率并减少人为失误。对于团队协作场景，它还能帮助统一分支创建流程，避免分支来源混乱。
需要注意的是，branchout 依赖于 Pi 平台的 Git 集成，因此仅适用于 Pi 环境中的 Git 仓库。如果你的工作流需要更复杂的分支策略（如同时创建多个分支或带标签的分支），建议结合其他 Git 工具使用。此外，虽然 branchout 做了安全校验，但仍建议在创建分支前确认当前工作区已提交或暂存所有更改。
核心特点
与手动执行 `git checkout -b` 相比，branchout 强制要求指定源分支，避免了因默认基于当前分支创建而导致的误操作；同时，它自动切换到新分支并校验源分支是否存在，适合 Pi 平台的智能体工作流。
注意事项
仅适用于 Pi 平台内的 Git 仓库，且不支持跨仓库或远程分支的创建。
常见问题
branchout 和 git checkout -b 有什么区别？
branchout 要求明确指定源分支，避免基于当前分支创建；而 git checkout -b 默认基于当前 HEAD，容易误操作。
branchout 能在非 Pi 环境中使用吗？
不能，branchout 是 Pi 平台的 Skill，仅支持 Pi 环境中的 Git 仓库。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/branchout/raw/index.md 读取 branchout 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/branchout/raw/index.md（查看排版版本）