marshroom
连接Claude Code与GitHub的多仓库工作流自动化工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:marshroom。 它的用途是:连接Claude Code与GitHub的多仓库工作流自动化工具 完整的 Skill 内容见:https://321skill.com/skills/marshroom/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“/start-issue 42”,Claude Code会自动切换到主分支、拉取最新代码、创建对应分支(如 `HotFix/#42`),并将Issue #42的完整描述注入上下文,同时更新任务状态为“进行中”。完成后,
对AI说:“/create-pr”,它会自动推送分支、创建包含“Closes #42”的PR,并将状态更新为“待审核”。
介绍
Marshroom 旨在解决开发者在使用 Claude Code 等AI编码助手时,处理跨多个GitHub仓库问题的繁琐流程痛点。传统的“找问题-建分支-加载上下文-推送-提PR-关问题”流程涉及大量手动点击和上下文切换,尤其是在多仓库、多Agent会话并行时,效率低下且容易出错。
该工具通过一个共享的JSON状态文件(~/.config/marshroom/state.json)将三个组件无缝连接:一个macOS菜单栏应用(用于浏览和排队问题)、一个CLI工具(用于状态管理和IDE启动)以及Claude Code技能(用于自动化分支和PR生命周期)。用户只需在菜单栏应用中将问题加入队列,然后在终端使用 /start-issue 命令,Claude Code便能获取完整上下文开始编码,最后用 /create-pr 命令自动创建PR。
它非常适合需要同时处理多个GitHub仓库问题、并深度依赖Claude Code进行实际编码的开发者或小型团队。尤其适合那些厌倦了在不同工具和界面间反复切换,希望将AI编码助手深度集成到现有Git工作流中的人。
与同类单纯提供Git操作CLI或简单Issue浏览器的工具不同,Marshroom的核心创新在于充当了“胶水”角色。它并非替代 gh CLI 或 Claude Code,而是通过一个中心化的状态文件,在macOS原生应用、终端Tmux环境和Claude Code技能之间建立了一个自动化的工作流闭环,实现了从问题发现到PR合并的全链路状态同步与自动化。
核心特点
Marshroom的核心区别在于其“三合一”架构与状态同步机制:通过一个共享的JSON状态文件,将macOS原生菜单栏应用、终端CLI/Tmux HUD和Claude Code技能三者深度打通,实现了跨GUI、终端和AI编码环境的全工作流状态自动同步与流转,而非仅提供孤立的命令行功能。
注意事项
目前仅支持macOS 14.0+系统,且深度绑定Claude Code和Tmux,对于使用其他编辑器、IDE或操作系统的开发者不适用。
常见问题
Marshroom支持Windows或Linux吗?
不支持。它重度依赖macOS 14.0+的特定API(如@Observable, MenuBarExtra)来构建菜单栏应用。
必须使用Tmux和Claude Code吗?
是的,其CLI的HUD状态显示和快捷键集成基于Tmux,核心自动化流程(/start-issue, /create-pr)依赖于Claude Code技能来执行。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/marshroom/raw/index.md 读取 marshroom 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/marshroom/raw/index.md(查看排版版本)