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 格式),按其中说明在我的环境里完成安装和配置。