用途:do-issue 用于端到端解决多步骤的 GitHub 或 GitLab issue。它从检测到的 git 平台(GitHub、GitLab、Bitbucket)获取 issue 内容,并通过子智能体驱动开发,在依赖允许时并行执行任务。平台通过 leyline:git-platform 的 SessionStart 钩子自动检测,会话上下文中含 git_platform,据以选择相应 CLI。
主要能力:跨平台自动识别 GitHub/GitLab/Bitbucket;输入灵活,可单个 issue 编号、平台 URL 或空格分隔的列表;通过子智能体并行执行独立任务;所有 issue 汇总为一个合并 PR,绝不按 issue 分别建 PR;任务批次间设置代码审查关卡。
工作流:分六阶段——发现(解析输入、获取 issue、提取需求)、计划(分析依赖、拆分任务)、执行(并行派发子智能体)、质量(批间代码审查)、完成(顺序任务、最终审查、更新 issue)。需创建六个 TodoWrite 项,从 do-issue:discovery-complete 到 do-issue:issues-updated。
执行模式:智能体团队为默认并行后端,通过基于文件系统的消息传递协调;单 issue 且 --scope minor 时自动降级,--no-agent-teams 可强制使用 Task 工具。需 Claude Code 2.1.32+、tmux、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1;缺前置时静默回退。配置项包括 parallel_execution、max_parallel_subagents、review_between_batches、auto_close_issues、commit_per_task。
不适用场景:明显可直接修复的单文件修改;工作完成后准备 PR(应使用 sanctum:pr-prep)。
限制:退出条件要求六个 TodoWrite 项全部创建并在对应阶段完成;使用正确 forge CLI(GitHub 用 gh,GitLab 用 glab);只开一个合并 PR;批间代码审查须通过才派发下一批;PR 就绪后对指定 issue 评论或关闭并引用 PR。完整命令映射与模块细节见资料中列出的各模块文件,其他未提及项暂未提供。