GitHub Projects v2 看板助手

你在解决什么问题

GitHub Projects v2 的字段、迭代和看板项并不总是和 gh issue 同一套模型：要在 CLI 里改 Status、Priority、Iteration，或把 Issue 挂进项目，你得区分「项目编号」和 GraphQL 的 node id，否则 item-edit 会直接报错。

技能如何工作

技能围绕 GitHub CLI（gh） 把常见看板操作串成可执行步骤：

• 列待办：用 project 相关命令拉取 backlog / 项目项列表，必要时配合 --format json 拿到后续编辑所需的 ID。
• 改项字段：通过 item-edit 更新状态、迭代、优先级等；文档强调需 --project-id（如 PVT_xxx）与 item 的 node ID，二者通常来自 item-list --format json。
• Issue 协作：给已有 Issue 加评论；创建 Issue 并加入指定项目。
• 子 Issue：原生 gh issue 尚不支持子 Issue；优先走 gh-sub-issue 扩展，不可用时再 GraphQL 兜底。

关于 ID：多数 gh project 子命令用 项目 number + --owner；item-edit 是例外，必须用 GraphQL 项目 ID，可用 gh project list --owner <owner> --format json 配合 jq 按 number 筛出 .id。

边界与注意点

• 需要已配置 gh 认证 及对目标 org/user 仓库、项目的访问权限。
• 子 Issue 路径依赖扩展或手写 GraphQL，行为与 UI/API 演进可能不一致，上线前建议在目标仓库试一条链路。
• 字段名、单选值以你项目模板为准；技能描述的是操作面，不会替你定义组织级工作流。