get-shit-done 如何用 /gsd-manager 从单个终端统一查看和管理多个 phase 的进度【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-doneget-shit-doneGSD为 Claude Code 提供了 phase 驱动的规划与执行流程项目被拆分成多个 phase每个 phase 依次经历 discuss讨论、plan规划、execute执行三个阶段。当一个里程碑下有多个 phase 时逐个手动执行/gsd:discuss-phase、/gsd:plan-phase、/gsd:execute-phase需要频繁切换上下文。/gsd-manager就是为此设计的单终端指挥中心它读取磁盘上的 phase 状态渲染出一块仪表盘根据依赖和进度推荐下一步动作并在一个循环里完成查看状态 → 派发工作 → 回到仪表盘的闭环其中 discuss 在终端内联执行plan/execute 以后台 agent 形式并行运行见 docs/COMMANDS.md 的/gsd-manager一节和 get-shit-done/workflows/manager.md 的完整工作流定义。前提条件GSD 已安装各运行时的安装命令见 docs/USER-GUIDE.md 的安装章节。已经用/gsd-new-project初始化过项目.planning/目录下存在ROADMAP.md和STATE.md。命令定义要求Requires an active milestone with ROADMAP.md and STATE.md见 commands/gsd/manager.md仪表盘就是基于这两个文件加上各 phase 目录的状态渲染的。项目配置存放在.planning/config.json由/gsd-new-project创建、/gsd-settings更新见 docs/CONFIGURATION.md。打开指挥中心/gsd-manager # 打开指挥中心仪表盘 /gsd-manager --analyze-deps # 先扫描 ROADMAP 各 phase 的依赖关系再进入进入时 manager 通过gsd-sdk query init.manager拉取里程碑上下文里程碑版本、phase 数量、已完成数量、依赖关系、推荐动作等然后打印启动横幅和仪表盘。启动失败时它会直接显示错误信息并退出——此时先确认.planning/下两个文件是否存在。如果你的 ROADMAP.md 还没有标注 phase 之间的依赖可以优先跑一次--analyze-deps。它对应 docs/FEATURES.md 中的 Phase Dependency Analysis 功能检测 phase 间的文件重叠、API/schema 的生产者-消费者关系和数据流依赖给出依赖建议表并在你确认后才把Depends on字段写回 ROADMAP.md。依赖标注准确后仪表盘里的 Deps 列和哪些 phase 可并行的推荐才可靠。读懂仪表盘每次回到 dashboard 步骤时manager 都会重新从磁盘读取状态因此后台 agent 的进展会实时反映出来。仪表盘元素如下进度条20 字符的█░条附百分比和完成数如████████████░░░░░░░░░░ 60% (3/5 phases)。每个 phase 一行列含义#编号、Phase 名称超长自动截断加…、Deps依赖的 phase 编号无依赖显示—、D/P/Ediscuss/plan/execute 三关的完成标记、Status当前状态。状态符号✓done、◆active、○pending、·queued。磁盘状态到状态栏的映射complete→✓ Completepartial→◆ Executing...planned→○ Ready to executediscussed或researched→○ Ready to plan尚无目录但轮到它 →○ Ready to discuss其余 →· Up next。某 phase 正在后台运行时状态前加◆并标注(active)同时表格上方显示◆ Background: Planning Phase 4, ...。以下是源文档给出的示例输出文档示例数值仅示意━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ GSD ► DASHBOARD ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ████████████░░░░░░░░░░ 60% (3/5 phases) ◆ Background: Planning Phase 4 | # | Phase | Deps | D | P | E | Status | |---|----------------------|------|---|---|---|---------------------| | 1 | Foundation | — | ✓ | ✓ | ✓ | ✓ Complete | | 2 | API Layer | 1 | ✓ | ✓ | ◆ | ◆ Executing (active)| | 3 | Auth System | 1 | ✓ | ✓ | ○ | ○ Ready to execute | | 4 | Dashboard UI Set… | 1,2 | ✓ | ◆ | · | ◆ Planning (active) | | 5 | Notifications | — | ○ | · | · | ○ Ready to discuss | | 6 | Polish Final Mail… | 1-5 | · | · | · | · Up next |当 roadmap 中还有下一个里程碑时表格下方会追加一个 Queued 区块预览下一里程碑的 phase只有编号、名称、依赖和固定的· Queued状态没有 D/P/E 列。注意 queued phase 不可操作——它们属于未来里程碑必须等当前里程碑 ship 之后才会进入可派发状态。派发工作Continue 选项的工作方式仪表盘下方是推荐动作区Next Steps。如果当前存在可执行的动作menu 会给出一个Continue复合选项把所有推荐动作列在一起一次派发先并行拉起全部后台 agentexecute/plan再运行内联的 discuss如果有的话。此外固定提供Refresh dashboard和Exit manager两个选项也可以直接输入 Other 自由文本manager 会解析其中的 phase 编号和动作并按对应方式派发。执行方式是分流的discuss是交互式的通过Skill(skillgsd-discuss-phase, args{phase} {flags})在当前终端内联运行完成后回到仪表盘。plan / execute是自主的通过Agent(run_in_backgroundtrue)拉起后台 agent 分别跑 plan-phase / execute-phase 全流程派发后立即回到仪表盘不阻塞你继续 discuss 其他 phase。这正是一个终端管理多个 phase的核心你在前台和某个 phase 讨论另外的 phase 在后台规划或执行。自动刷新只要有后台 agent 在运行存在is_active的 phasemanager 会开启 60 秒自动刷新循环——menu 展示后 60 秒内没有输入就自动重读仪表盘。间隔可通过 GSD 配置中的manager_refresh_interval调整默认 60 秒设为 0 关闭。配置透传参数减少每次手动敲 flag如果你希望 manager 每次派发 discuss/plan/execute 时自动带上固定参数可以在.planning/config.json里配置manager.flags见 docs/CONFIGURATION.md 的 Manager Passthrough Flags 一节{ manager: { flags: { discuss: --auto, plan: --skip-research, execute: --validate } } }三个键都是字符串默认空不附加任何 flag分别被追加到对应的 discuss-phase / plan-phase / execute-phase 命令参数上。也可以不改文件直接用gsd-sdk query config-set设置例如gsd-sdk query config-set manager.flags.discuss --auto --analyze配置里的无效 flag 会被清洗并记录为警告只有被识别的 GSD flag 会真正透传——所以填错参数不会导致命令挂掉只是不生效。非 Claude 运行时text modemanager 的 menu 依赖AskUserQuestion交互式提问。在非 Claude 运行时OpenAI Codex、Gemini CLI 等该组件不可用此时需要 text mode把 config 中workflow.text_mode设为true或对该会话使用--textflag。激活后所有交互菜单变成纯文本编号列表输入序号选择即可。后台 agent 失败时的处理路径后台 agent 完成时manager 会显示一行通知✓ {描述}加简要结果摘要然后回到仪表盘。失败时它按错误类型给出选项权限/工具访问类错误如某个工具或命令被沙箱策略拦截manager 会指明被拦截的具体工具或命令提供三个选项——Add permission and retry通过update-config把该权限写入settings.local.json后重新拉起后台 agent、Run this phase inline instead改在内联跑同一个 plan/execute 流程、Skip and continuephase 保持当前状态。其他错误git lock、文件冲突、逻辑错误等选项为 Retry / Run inline instead / Skip and continue / View details。View details 会读取 STATE.md 的 blockers 区块展示细节。另外后台execute-phase会在每个 wave 和 plan 边界输出[checkpoint]标记#2410避免长流程把流式响应拖到超时。如果某个后台 phase 中途失败可以直接在 transcript 里 grep[checkpoint]最后一个 checkpoint 就是已确认的边界manager 的后台完成处理器也会用这些标记上报部分进度[checkpoint] phase {N} wave {W}/{M} starting, {count} plan(s), {P}/{Q} plans done [checkpoint] phase {N} wave {W}/{M} plan {plan_id} complete ({P}/{Q} plans done)结束会话与恢复选择 Exit manager 后manager 打印带进度条的最终状态里程碑、完成百分比、完成数/总数并给出恢复提示Resume anytime: /gsd:manager退出时仍在运行的后台 agent 会继续跑完它们的进度会在下次/gsd:manager或/gsd:progress时可见。当所有 phase 都完成all_complete仪表盘会显示 MILESTONE COMPLETE 区块给出里程碑收尾的两个动作/gsd:verify-work跑验收测试和/gsd:complete-milestone归档收尾。相关的完整行为定义状态映射、派发 prompt、错误分支可继续查阅 get-shit-done/workflows/manager.md/gsd:progress --next的自动路由也可以作为不进入交互界面的轻量替代见 docs/COMMANDS.md。【免费下载链接】get-shit-doneA light-weight and powerful meta-prompting, context engineering and spec-driven development system for Claude Code by TÂCHES.项目地址: https://gitcode.com/GitHub_Trending/getshi/get-shit-done创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考