用途:在当前仓库中启动一个 Marshroom cart 议题的处理流程,包括创建分支、注入上下文、将议题状态更新为 running。
主要能力与步骤:读取 ${MARSHROOM_STATE:-~/.config/marshroom/state.json} 并解析 JSON;提取 cart 数组,若为空则提示用户在 Marshroom 应用中添加议题;运行 git remote get-url origin 获取当前仓库远程地址;从 HTTPS 或 SSH 远程地址中提取 owner/repo;用 repoCloneURL(HTTPS)或 repoSSHURL(SSH)匹配 cart 条目;若无匹配则告知该仓库没有 cart 议题;若 $ARGUMENTS 含议题编号则定位该条目,否则在多个匹配时列出并让用户选择;运行 git checkout main && git pull origin main;创建并切换分支 git checkout -b {branchName},分支名格式为 Feature/#N 或 HotFix/#N,N 为议题编号。
状态更新(强制):先尝试 marsh start #{issueNumber};若 PATH 中无 marsh,则回退到 jq 原子写入:STATE_FILE="${MARSHROOM_STATE:-~/.config/marshroom/state.json}",TMP="$(mktemp "${STATE_FILE}.XXXXXX")",jq --argjson n ISSUE_NUMBER '.cart |= map(if .issueNumber == $n then .status = "running" else . end)' "$STATE_FILE" > "$TMP" && mv -f "$TMP" "$STATE_FILE"。随后读取 state.json 确认状态为 running,失败必须停止并报告错误,不得静默继续。
上下文注入:读取匹配条目的 issueBody 字段,若非 null,则在 "## Issue Details" 标题下显示,为智能体提供任务上下文。最后确认分支已创建并展示 Issue、Branch、Repository、Status 信息,并询问用户是否允许开始规划;若允许,则使用 /plan 模式开始规划。
限制:依赖 Marshroom 状态文件与 cart 结构;需要 git 仓库及远程地址;marsh 可用时优先使用,否则依赖 jq。其余环境与兼容性信息暂未提供。