用途:本技能通过 gh CLI 的 gh project 命令管理 GitHub Projects (v2),包括创建项目、管理条目、字段和工作流。
前置条件:需为 gh 添加 project 权限范围。先运行 gh auth status 检查当前范围,若缺失则运行 gh auth refresh -s project 添加。
主要能力:项目层面支持 list、view、create、edit、close(含 --undo 重新打开)、link/unlink 仓库或团队。条目层面支持 item-add 添加已有 Issue/PR、item-create 创建草稿、item-list 列出(默认 30,可用 --limit 调整)、item-edit 修改字段值、item-archive 归档、item-delete 删除。字段层面支持 field-list、field-create(TEXT、NUMBER、DATE、SINGLE_SELECT 等类型)、field-delete。
使用方式:命令形如 gh project item-add PROJECT_NUM --owner OWNER --url URL。编辑条目字段需先通过 item-list --format json 和 field-list --format json 获取 ITEM_ID、PROJECT_ID、FIELD_ID 及选项 ID,再运行 item-edit 并搭配 --text、--number、--date、--single-select-option-id、--iteration-id 或 --clear。多处命令支持 --format json,可配合 jq 过滤,例如 gh project list --format json | jq '.projects[] | {number, title}'。
限制与注意:close、unlink、item-archive、item-delete、field-delete 等命令会更改或删除数据。执行前需先确认:运行 gh project view PROJECT_NUM --owner OWNER 或 gh project list --owner OWNER --format json 核对标题;条目与字段的 ID 必须在本次会话中通过 item-list --format json 或 field-list --format json 获取,不得猜测、截断或复用无关输出。批量添加时先对单个 --url 运行 item-add 并在 JSON 或界面中确认出现,再用 xargs 或循环处理多个 URL。