mcpField
D
do-issue

do-issue

github.com/athola开发34398 次安装1 天前更新
代码仓库

关于 do-issue

do-issue 是一款从 GitHub、GitLab 或 Bitbucket 获取 issue,并通过任务规划和子 Agent 协调实现工作的 Skill。它可并行处理相互独立的任务,设置审查关卡,并将多个 issue 汇总到一个 PR。

主要功能

  1. 01自动检测 git 平台
  2. 02接受 issue 编号、URL 或列表
  3. 03规划任务及依赖关系
  4. 04并行执行独立任务
  5. 05在任务批次间进行审查
  6. 06将多个 issue 汇总为一个 PR

适用场景

  1. 01一起实现多个相关 issue
  2. 02将独立工作分配给子 Agent
  3. 03协调多个 git 平台上的 issue 修复
  4. 04通过审查关卡准备汇总 PR

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/athola/claude-night-market --skill do-issue

安装后在 Claude Code 中输入/do-issue确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

modules/
completion.md
issue-discovery.md
parallel-execution.md
quality-gates.md
task-planning.md
troubleshooting.md

详细介绍

不适用场景

  • 可以直接完成的单文件修复
  • 工作完成后准备 PR(使用 sanctum:pr-prep)

修复问题

从检测到的 Git 平台(GitHub、GitLab 或 Bitbucket)获取问题内容,并使用 subagent-driven-development 系统地处理需求;在依赖关系允许的情况下并行执行任务。

平台会自动检测,由 leyline:git-platform SessionStart hook 完成。检查会话上下文中的 git_platform:,以确定要使用哪个 CLI。

主要功能

  • 跨平台:自动检测 GitHub/GitLab/Bitbucket,并使用相应的 CLI
  • 灵活输入:单个问题编号、平台 URL 或以空格分隔的列表
  • 并行执行:通过子 Agent 并发运行互不依赖的任务
  • 一个 PR:所有问题都汇总到一个 PR 中(绝不为每个问题单独创建 PR)
  • 质量关卡:任务组之间进行代码审查
  • 全新上下文:每个子 Agent 都从干净的上下文开始,专注处理工作

工作流概览

阶段说明模块
1. 发现解析输入、获取问题、提取需求issue-discovery
2. 规划分析依赖关系、创建任务拆分task-planning
3. 执行为互不依赖的任务分派并行子 Agentparallel-execution
4. 质量任务批次之间的代码审查关卡quality-gates
5-6. 完成顺序执行任务、最终审查、更新问题completion

必需的进度项

  1. do-issue:discovery-complete
  2. do-issue:tasks-planned
  3. do-issue:parallel-batch-complete
  4. do-issue:review-passed
  5. do-issue:sequential-complete
  6. do-issue:issues-updated

Forge CLI 命令

使用会话上下文中检测到的平台(git_platform:)。完整映射请参阅 Skill(leyline:git-platform)。

操作GitHub(gh)GitLab(glab)
获取问题gh issue view <N> --json title,body,labels,commentsglab issue view <N>
评论gh issue comment <N> --body "msg"glab issue note <N> --message "msg"
关闭gh issue close <N> --comment "reason"glab issue close <N>
搜索gh issue list --search "query"glab issue list --search "query"

**验证:**运行命令并添加 --help 标志,以确认命令是否可用。

Agent Teams(默认执行模式)

Agent teams 是 do-issue 的默认并行执行后端。队友通过基于文件系统的消息机制进行协作;在实现过程中发现共享文件或依赖关系时,可以实时沟通。

自动降级:对于使用 --scope minor 的单个问题,将跳过 agent teams(改用 Task 工具或内联执行)。使用 --no-agent-teams 可在任何调用中强制通过 Task 工具分派。

要求:Claude Code 2.1.32+、tmux、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。如果缺少前置条件,将静默回退到通过 Task 工具分派。

# Agent teams configuration
fix_issue:
  agent_teams:
    enabled: true           # on by default; --no-agent-teams to disable
    max_teammates: 4        # limit concurrent workers
    model: sonnet           # teammate model (lead uses current model)
    auto_downgrade: true    # skip agent teams for --scope minor

有关 agent teams 模式的详细信息,请参阅 modules/parallel-execution.md。

配置

fix_issue:
  parallel_execution: true
  max_parallel_subagents: 3
  review_between_batches: true
  auto_close_issues: false
  commit_per_task: true

**验证:**运行命令并添加 --help 标志,以确认命令是否可用。

详细资源

退出标准

  • 执行开始前,已创建全部 6 项必需的进度项(从 do-issue:discovery-complete 到 do-issue:issues-updated),并在各阶段结束时将对应项标记为已完成
  • 根据会话上下文检测到的代码托管平台,使用正确的平台 CLI 获取 Issue 需求(GitHub 使用 gh, GitLab 使用 glab)
  • 仅创建一个涵盖所有 Issue 的整合 PR;不创建逐 Issue 的 PR
  • 并行任务批次之间执行代码审查门禁;必须通过后才能分派下一批任务
  • PR 准备好接受审查后,已对所有指定 Issue 发表评论或将其关闭,并附上 PR 引用

评论

支持 Markdown