这个 Skill 能做什么，适合哪些场景？
这是 manaflow-ai/cmux 仓库中 skills/cmux-ghostty 下的一个 Agent Skill，面向参与 cmux 开发的贡献者。它规定了 Ghostty 子模块的提交与推送规则、GhosttyKit.xcframework 的 Release 构建命令，以及父仓库子模块指针的安全更新顺序。技能的核心价值在于防止一类隐蔽的 git 事故：在分离 HEAD 上提交子模块改动，导致父仓库指向任何远程分支都无法访问的 SHA，进而使未来的 checkout 或 CI 任务失败。它还要求维护 docs/ghostty-fork.md 记录与上游 fork 的冲突说明。
- 在 ghostty 子模块中用
zig build -Demit-xcframework=true -Dxcframework-target=universal -Doptimize=ReleaseFast以 ReleaseFast 优化重新构建 GhosttyKit.xcframework - 通过
git remote -v识别 manaflow-ai/ghostty fork 的正确 remote（通常是 origin），在子模块内建分支、提交并推送 - 添加
ghostty-org/ghostty为 upstream remote，fetch/merge 上游改动后推回 fork - 在父仓库中提交更新后的 ghostty 子模块指针
- 用
git merge-base --is-ancestor HEAD origin/main校验提交可从远程分支到达 - 维护 docs/ghostty-fork.md 中的 fork 变更与冲突记录
- 正在为 cmux 修改 ghostty 子模块、需要重建 GhosttyKit.xcframework 的贡献者；需要将上游 ghostty-org/ghostty 的改动同步进 manaflow-ai/ghostty fork 的维护者；更新父仓库子模块指针、担心指针指向不可达 SHA 的开发者；为多子模块仓库（ghostty、vendor/bonsplit、homebrew-cmux）制定安全推送顺序的团队。
- 不修改 cmux 源码或 ghostty 子模块的普通 cmux 用户——这只是应用，无需此技能
- 非 macOS / 不使用 zig 的环境——xcframework 构建流程依赖 macOS 与 zig 工具链
- 与 cmux 无关的通用子模块项目——流程细节（fork remote、bonsplit 等子模块名）是 cmux 特有的
如何安装这个 Skill？
- 这是面向 cmux 仓库贡献者的窄域工作流技能，不适用于一般 Ghostty 终端用户；技能仓库元数据许可证为 NOASSERTION，使用前请自行确认 GPL-3.0-or-later 条款适用性。
- 推送与 merge 指令涉及对外部仓库的写入；若上游或 fork 远程不可达（如中国大陆网络环境），流程将中断且技能未提供替代方案。
- 构建命令依赖 zig 与 Xcode 工具链，未给出版本要求或失败诊断指引。
- Shell / 命令行
- 网络访问
- 本地文件系统
gitzigmacOS (for building GhosttyKit.xcframework)
源材料未提供安装命令。该技能位于 manaflow-ai/cmux 仓库的 skills/cmux-ghostty/ 目录（SKILL.md 加 references/submodule-safety.md）。在支持 Agent Skills 的客户端中，按其惯例将技能文件夹复制到技能目录即可，例如：
git clone https://github.com/manaflow-ai/cmux.git
cp -r cmux/skills/cmux-ghostty ~/.claude/skills/（目标路径取决于你的客户端，源材料未逐字给出此步骤。）
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 我在 cmux 里改了 ghostty 子模块的代码，帮我按正确流程提交并推送到 manaflow-ai/ghostty fork，然后更新父仓库的子模块指针
- 把上游 ghostty-org/ghostty 的 main 合并进我们的 fork，并同步父仓库指针
- 帮我重建 GhosttyKit.xcframework，确认用了 ReleaseFast 优化
- 检查我刚才的子模块提交是否能从 origin/main 到达，防止 CI 拉取失败
技能由 SKILL.md 描述触发：当你修改 ghostty 子模块、重建 GhosttyKit.xcframework、更新父仓库子模块指针或撰写 fork 冲突说明时，Agent 会读取该技能并遵循其中的规则。流程要点：先 git remote -v 确认 fork remote；在子模块内提交并推送到远程分支；用 merge-base 校验可达性；最后才在父仓库提交指针更新。深入细节见随附的 references/submodule-safety.md（安全顺序与 fork 文档要求）。构建 xcframework 的命令为：
cd ghostty && zig build -Demit-xcframework=true -Dxcframework-target=universal -Doptimize=ReleaseFast这个 Skill 有哪些优点和局限？
- 直接来自 cmux 官方仓库，规则与该项目的实际 fork/子模块结构完全一致
- 明确防范了子模块指针悬空这一常见且隐蔽的 git 事故，并给出可执行的校验命令
- 处理了 remote 命名的历史差异（fork 可能是 origin 或 manaflow），减少照搬命令出错
- 附带 references/submodule-safety.md 提供更详细的顺序说明
- 仅适用于 cmux 及其子模块结构，可迁移性有限
- 构建依赖 macOS 上的 zig 工具链，其他平台无法执行 xcframework 构建
- 安装与触发方式未在源材料中逐字文档化，需依赖客户端对 Agent Skills 的通用支持
- 仓库许可证在 GitHub 上标记为 NOASSERTION（README 说明为 GPL-3.0-or-later 加部分 BSL 1.1），复用技能内容前需自行确认条款
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux Ghostty 子模块工作流技能 本页 | 54 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 调试技能 | 56 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 工作区操作技能 | 64 · 推荐 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义技能 | 55 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| cmux 自定义侧边栏 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
源材料未将该技能与其他技能或工具直接比较；其覆盖的领域（子模块安全工作流）与通用 git 教程的不同之处在于它是针对 cmux 的 manaflow-ai/ghostty fork 定制的。
FollowSkills 如何评估这个 Skill？
该技能仅提供 git 子模块与 GhosttyKit 构建流程的指令性指导，不执行网络请求、凭证处理或破坏性操作；'先推送子模块再更新指针'与 merge-base 可达性检查体现了防御性流程。扣分项：无显式的用户确认、回滚指引或失败恢复步骤，远程推送操作的外部效果未作数据流披露。
指令自洽，处理了远程命名的历史差异（git remote -v 先行确认），并提供 merge-base --is-ancestor 验证命令。扣分项：静态审阅无法执行验证，对 merge 冲突、fetch 失败、非快进推送等异常输入无失败反馈设计，测试与边界情况覆盖薄。
frontmatter 描述与触发条件清晰（修改 ghostty 子模块、重建 GhosttyKit.xcframework、更新指针），非适用边界隐含明确（仅 cmux 贡献者场景）。扣分项：受众极窄，无环境适配说明，未披露对 GitHub/Ghostty 上游仓库的网络可达性依赖，无中文支持考虑。
文档分层良好：SKILL.md 主流程 + references/submodule-safety.md 详解 + agents/openai.yaml 接口定义，命名稳定。扣分项：技能级许可证元数据为 NOASSERTION，无版本号、变更日志或明确更新路径；仓库许可为 GPL-3.0-or-later 且部分目录 BUSL-1.1，技能未声明自身适用条款。
核心任务（安全地提交/推送子模块并更新父指针）的指令完整可直接使用，相比无指导的手动操作能避免孤儿 SHA 这一真实痛点。扣分项：静态审阅无法验证构建命令可复现，产出质量与成本收益缺乏执行证据。
关键主张（安全顺序、孤儿 SHA 风险）有仓库内 CI 工作流（子模块 SHA 下载逻辑）部分佐证。扣分项：无第三方执行证据，无测试直接覆盖该技能路径，事实与推断未分离标注。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →