用途:让 GitHub Project 的字段始终反映真实工作进展,项目字段即仪表盘,需保持准确。该技能贯穿整个工作流程,并被其他技能调用,如 issue-lifecycle、acceptance-criteria-verification、issue-prerequisite、issue-decomposition。
主要能力:维护标准字段,包括 Status(Backlog、Ready、In Progress、In Review、Done、Blocked)、Verification(Not Verified、Failing、Partial、Passing)、Criteria Met、Criteria Total、Priority、Type、Last Verified、Verified By。支持状态流转,如 Backlog→Ready→In Progress→In Review→Done,任意状态可转入 Blocked 并恢复。可将新 issue 加入项目并设置初始字段值。
使用方式:需设置环境变量 GITHUB_PROJECT,例如 echo $GITHUB_PROJECT。通过 gh project 命令获取项目号、项目 ID、字段 ID、选项 ID 和 item ID,再用 gh project item-edit 更新字段,如 --field-id 配合 --single-select-option-id、--number、--date、--text。示例:gh project list --owner @me --format json | jq -r '.projects[] | select(.number == 4) | .id';gh project item-add [PROJECT_NUMBER] --owner @me --url [ISSUE_URL]。
适用场景:在验证运行、PR 创建或合并、依赖清理、遇到或解决阻塞、创建新 issue 时同步字段。验证状态与推荐状态存在映射,如 Passing 对应 In Review。
限制:需正确配置 gh 认证与权限;字段必须已存在于项目中;item 不在项目内时需先用 item-add 添加。资料未提供收费、价格或平台支持范围等信息。