mcpField
I
issue-progress-tracking

issue-progress-tracking

github.com/yonatangross开发299215 次安装今天更新
代码仓库

关于 issue-progress-tracking

Issue Progress Tracking 是一项通过 `gh` 命令行指导 GitHub Issue 更新的技能，覆盖从开始处理到创建 PR 的流程。它规定标签、分支、小型提交和进度评论的使用方式。

主要功能

  1. 01开始工作时更新 Issue 标签
  2. 02创建关联 Issue 的功能分支
  3. 03使用引用 Issue 的原子提交
  4. 04发布里程碑和阻塞事项进度
  5. 05创建可关闭 Issue 的拉取请求

适用场景

  1. 01在实现过程中保持 GitHub Issue 状态更新
  2. 02维护与 Issue 关联且便于审查的提交
  3. 03汇报长期任务的进展

安装

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

$npx skills add https://github.com/yonatangross/orchestkit --skill issue-progress-tracking

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

包含的文件

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

test-cases.json
rules/
start-work-ceremony.md
small-commits.md
_sections.md

详细介绍

Issue 进度跟踪

通过 gh CLI 跟踪 GitHub issue 进度的操作指南。确保随着工作从开始推进到 PR，issue 始终保持更新。

调用

此技能设置为 user-invocable: false 和 disable-model-invocation: true： 没有 /ork: 形式，模型也无法自动选择它（#3313）。Agent 通过读取此文件的路径显式加载该技能：

${CLAUDE_PLUGIN_ROOT}/skills/issue-progress-tracking/SKILL.md

阶段 1：开始工作

为 issue 添加标签并创建功能分支：

# Move issue to in-progress
gh issue edit $ARGUMENTS[0] --add-label "status:in-progress" --remove-label "status:todo"
gh issue comment $ARGUMENTS[0] --body "Starting work on this issue."

# Create feature branch
git checkout -b issue/$ARGUMENTS[0]-brief-description

规则：

  • 始终从默认分支（main/dev）创建分支
  • 分支名称格式：issue/<number>-<brief-description>
  • 绝不要直接在 main/dev 上工作

阶段 2：工作期间 — 小型提交

每完成一个逻辑步骤就提交，而不是等到最后。每次提交都要引用 issue：

# Each commit references the issue number
git commit -m "feat(#$ARGUMENTS[0]): add user model

Co-Authored-By: Claude <[email protected]>"

规则：

  • 每次提交只包含一项逻辑变更（原子性）
  • 每次提交都引用 issue：type(#N): description
  • 尽早且频繁地提交——不要累积大量差异

阶段 3：报告进度（较长的实现工作）

对于多步骤工作，发布进度更新：

gh issue comment $ARGUMENTS[0] --body "Progress update:
- Completed: database schema, API endpoints
- In progress: frontend components
- Remaining: tests, documentation"

何时发布更新：

  • 完成重要里程碑后
  • 遇到阻碍或改变方案时
  • 暂时离开长时间任务前

阶段 4：完成工作

创建 PR 并更新标签：

# Create PR that closes the issue
gh pr create \
  --title "feat(#$ARGUMENTS[0]): brief description" \
  --body "Closes #$ARGUMENTS[0]

## Changes
- Change 1
- Change 2

## Test Plan
- [ ] Unit tests pass
- [ ] Manual verification"

# Update issue status
gh issue edit $ARGUMENTS[0] --add-label "status:in-review" --remove-label "status:in-progress"

规则速查

规则影响涵盖内容
开始工作流程HIGH创建分支、更新标签、初始评论
小型提交HIGH引用 issue 的原子提交

总计：2 个类别中的 2 条规则

关键决策

决策选择理由
标签前缀status:符合 GitHub 惯例
分支格式issue/<N>-desc自动将分支关联到 issue
提交引用type(#N):规范提交格式 + issue 关联
进度评论手动让人类参与其中

常见错误

  1. 开始工作却没有添加标签 — 团队无法了解谁在处理什么
  2. 最后才提交一个巨大变更 — 增加审查难度，也会让历史记录无法用于二分查找
  3. 忘记将 PR 关联到 issue — 合并后 issue 仍会保持开启状态
  4. 创建 PR 时没有更新标签 — 审查期间 issue 仍显示“进行中”
  5. 使用 gh issue close 手动关闭 issue — 只有在 PR 正文中包含 Closes #N 并合并 PR 后，issue 才会关闭。工作期间，使用 gh issue comment 评论进度；绝不要直接关闭。

相关技能

  • ork:commit — 按规范格式提交
  • ork:fix-issue — 完整的 issue 解决工作流
  • ork:implement — 使用并行 Agent 实现功能
  • ork:create-pr — 创建拉取请求

评论

支持 Markdown