pi-jj-git-align
为Pi中Jujutsu与Git共存的仓库提供安全的发布同步
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-jj-git-align。 它的用途是：为Pi中Jujutsu与Git共存的仓库提供安全的发布同步 完整的 Skill 内容见：https://321skill.com/skills/pi-jj-git-align/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请使用pi-jj-git-align将我的Jujutsu `main`分支变更发布到对应的Git远程仓库。” 它会首先检查本地JJ工作区与Git远程仓库之间的状态差异和潜在冲突，在确认操作安全后，执行必要的`jj git push`等命令来完成同步，并给出操作结果报告。
介绍
该Skill旨在解决在Pi环境中，当开发者使用Jujutsu版本控制系统并与Git仓库共存时，手动执行jj git push或jj git fetch等同步操作可能带来的意外变更或冲突风险。它通过提供一层“防护”机制，在执行发布（publish）操作前进行必要的检查和确认，确保Jujutsu与Git之间的状态对齐是安全可控的。
使用方式通常是在Pi Agent中安装并启用此Skill后，在需要进行Jujutsu与Git仓库同步时，通过特定的命令或触发条件来调用它。Skill会自动执行预定义的检查流程，并在确认安全后完成对齐操作，简化了原本需要手动处理的多步命令和状态验证。
它非常适合同时使用Jujutsu和Git进行版本控制，尤其是在Pi开发环境中工作的开发者。特别是那些在团队协作中，需要频繁在Jujutsu本地变更与远程Git仓库（如GitHub、GitLab）之间同步，且对代码历史完整性和操作安全性有较高要求的用户。
建议在使用前，确保你已熟悉Jujutsu的基本操作和与Git的交互概念。在关键分支或重要变更发布前，即使使用了此防护Skill，也建议结合代码审查流程。注意它主要针对“发布对齐”场景，不覆盖所有Jujutsu-Git交互，复杂工作流可能仍需部分手动干预。
核心特点
与通用的Git同步工具或简单的JJ-Git集成不同，它专门针对“Pi环境”和“git-colocated Jujutsu repos”这一特定配置，提供了“防护性（Guarded）”的发布对齐，内置了针对此场景的状态检查和保护逻辑，而非仅仅包装底层命令。
注意事项
该Skill主要适用于Pi环境中Jujutsu与Git共存的配置，对于纯Git仓库、纯Jujutsu仓库或其他版本控制系统不适用。
常见问题
pi-jj-git-align是做什么的？
它是一个用于在Pi开发环境中，安全地将Jujutsu仓库的变更发布（对齐）到共存的Git远程仓库的Skill。
安装后如何使用？
在Pi Agent中启用该Skill后，通常在需要同步JJ与Git时，通过相关命令触发其防护性对齐流程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-jj-git-align/raw/index.md 读取 pi-jj-git-align 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-jj-git-align/raw/index.md（查看排版版本）