菜单
Manage GitHub Project v2 issue states, workpad comments, and related follow-up actions.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Merge an approved PR during the Land state. Runs pre-flight checks, performs squash merge, completes post-merge bookkeeping, and transitions the issue to Done.
Sync the current branch with the latest base branch (PR base if a PR exists, otherwise origin/main).
Analyze backlog issues to set Priority, Size, and Estimate, then identify and connect blocking relationships between issues. Use when backlog items need evaluation or when new items have been added without triage.
Manage a repository's GitHub Project workflow through PROJECT_MANAGE.md. Use when setting up project management for a repo, creating structured issues from implementation requests, triaging backlog items with Priority/Size/Estimate, analyzing blocking relationships across open issues, or rendering a project status dashboard.
Design, refine, and validate repository WORKFLOW.md files for GitHub Symphony projects.
Initialize PROJECT_MANAGE.md with repository-specific project management rules, GitHub Project board binding, and field mappings. Use when setting up project management for a repository for the first time.
| name | gh-project |
| description | Manage GitHub Project v2 issue states, workpad comments, and related follow-up actions. |
| license | MIT |
| metadata | {"author":"gh-symphony","version":"2.0","generatedBy":"gh-symphony"} |
Interact with the GitHub Project v2 board to manage issue status, create workpad comments, and handle follow-up issues.
gh CLI is authenticated (gh auth status).gh-symphony/context.yaml exists with field IDs and option IDsProject: 🧩 Moncher Stack (PVT_kwHOAPiKdM4BYPVD, hojinzs/projects/14)
Status Field ID: PVTSSF_lAHOAPiKdM4BYPVDzhTWkPc
| Column Name | Role | Option ID |
|---|---|---|
| Backlog | wait | ecd228db |
| Ready | active | f043e389 |
| In progress | active | b734c33a |
| In review | wait | ffe0efa5 |
| Land | active | 161b1b30 |
| Done | terminal | 444fc1b2 |
Use gh project item-edit with the field ID and option ID from the table above:
# Get the project item ID for an issue
gh project item-list <project-number> --owner <owner> --format json \
| jq '.items[] | select(.content.number == <issue-number>) | .id'
# Update the status field
gh project item-edit \
--project-id PVT_kwHOAPiKdM4BYPVD \
--id <item-id> \
--field-id PVTSSF_lAHOAPiKdM4BYPVDzhTWkPc \
--single-select-option-id <option-id-from-table-above>
gh issue comment <issue-number> --repo <owner>/<repo> --body "## Workpad\n\n### Plan\n- [ ] Task 1"
gh api -X PATCH /repos/<owner>/<repo>/issues/comments/<comment-id> \
-f body="## Workpad\n\n### Plan\n- [x] Task 1 (done)"
gh issue create --repo <owner>/<repo> \
--title "Follow-up: <title>" \
--body "<description>" \
--label "backlog"
gh issue edit <issue-number> --repo <owner>/<repo> --add-label "<label>"