用途:该技能用于在整个工作过程中持续更新 GitHub Issue,保持 Issue 为唯一事实来源,避免最后一次性补写。
主要能力:按不同节点执行更新,包括开始工作时将状态改为 In Progress;遇到阻碍时发表评论说明;做出决策时记录决策;发现新信息时写入发现;完成验收标准时勾选正文复选框;完成验证后发布验证报告;提交 PR 时关联 Issue;工作完成时状态改为 Done。
使用方式:技能通过 gh 命令操作。状态更新使用 gh project item-edit 配合项目、字段和选项 ID;评论更新使用 gh issue comment;验收清单更新先读取正文再用 sed 等方式将 - [ ] 改为 - [x],最后用 gh issue edit 更新正文。开始任何 Issue 工作前先查看历史:gh issue view [ISSUE_NUMBER] --comments,可结合 --json timeline。
适用场景:长期或多人协作的开发任务,需要保持进度可见、记录决策与阻碍、追踪验收标准完成情况;与其他技能如 issue-driven-development、acceptance-criteria-verification、error-recovery 配合使用。
限制:资料只说明更新流程与命令用法,未提供具体安装步骤、费用、支持平台或效果数据。最低更新节点为开始、受阻、解除阻碍、创建 PR 和完成;建议每 30-60 分钟或每完成重要步骤更新一次。应避免批量补写、空泛评论、只记录成功、跳过阻碍记录和未验证即关闭。命令中的项目编号、字段 ID 等占位符需按实际环境替换。