菜单
GitHub CLI operations for issues, PRs, milestones, and Projects v2. Covers gh commands, REST API patterns, and automation scripts. Use when managing GitHub issues, PRs, milestones, or Projects with gh.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/yonatangross/orchestkit --skill github-operations命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Chain patterns for multi-phase pipelines: MCP detection, handoff files, checkpoint-resume, worktree agents, CronCreate monitoring. Use when building or debugging a pipeline skill.
OrchestKit doctor for health diagnostics across manifest integrity, hook configuration, skill validation, agent frontmatter, MCP server connectivity, CC version compatibility, and permission rules. Reports issues with severity levels and auto-remediation suggestions. Validates component counts, detects orphaned entries, and checks CC version matrix compliance. Use when diagnosing plugin health, troubleshooting configuration issues, or running pre-release checks.
Inspects the OrchestKit telemetry pipeline for the current project — lists all known telemetry files with write counts, sizes, schema status, growth trend, and orphan detection. Use when verifying the observability pipeline is healthy, debugging a missing writer, or auditing which files have schema locks vs. which are drift-vulnerable. Read-only — never modifies telemetry files.
正在显示 SKILL.md
| name | github-operations |
| license | MIT |
| compatibility | Claude Code 2.1.220+. Requires gh CLI. |
| author | OrchestKit |
| description | GitHub CLI operations for issues, PRs, milestones, and Projects v2. Covers gh commands, REST API patterns, and automation scripts. Use when managing GitHub issues, PRs, milestones, or Projects with gh. |
| context | fork |
| version | 1.1.0 |
| tags | ["github","gh","cli","issues","pr","milestones","projects","api"] |
| user-invocable | false |
| complexity | medium |
| persuasion-type | guidance |
| metadata | {"category":"workflow-automation"} |
| allowed-tools | ["Read","Glob","Grep","Bash","Write","Edit","TaskCreate","TaskUpdate","TaskList"] |
Comprehensive GitHub CLI (gh) operations for project management, from basic issue creation to advanced Projects v2 integration and milestone tracking via REST API.
ghBEFORE doing ANYTHING else, create tasks to track progress:
# 1. Create main task IMMEDIATELY
TaskCreate(
subject="GitHub Operations: {target}",
description="Managing GitHub issues, PRs, milestones, or Projects",
activeForm="Managing GitHub resources"
)
# 2. Create subtasks matching the operation scope
TaskCreate(subject="Issue management", activeForm="Creating/updating issues")
TaskCreate(subject="PR management", activeForm="Managing pull requests")
TaskCreate(subject="Milestone tracking", activeForm="Updating milestones")
# 3. Set dependencies if operations are sequential
TaskUpdate(taskId="3", addBlockedBy=["2"])
TaskUpdate(taskId="4", addBlockedBy=["3"])
# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress") # When starting
TaskUpdate(taskId="2", status="completed") # When done
# Create issue with labels and milestone
gh issue create --title "Bug: API returns 500" --body "..." --label "bug" --milestone
gh issue list --state open --label --assignee @me
gh issue edit 123 --add-label --milestone
# Create PR with reviewers
gh pr create --title "feat: Add search" --body "..." --base dev --reviewer @teammate
# Watch CI status and auto-merge
gh pr checks 456 --watch
gh pr merge 456 --auto --squash --delete-branch
# Resume a session linked to a PR (CC 2.1.27)
claude --from-pr 456 # Resume session with PR context (diff, comments, review status)
claude --from-pr https://github.com/org/repo/pull/456
Tip (CC 2.1.27): Sessions created via
gh pr createare automatically linked to the PR. Use--from-prto resume with full PR context.
Footgun:
gh issue edit --milestonetakes a NAME (string), not a number. The REST API uses a NUMBER (integer). Never pass a number to--milestone. LoadRead("${CLAUDE_PLUGIN_ROOT}/skills/github-operations/references/cli-vs-api-identifiers.md").
# List milestones with progress
gh api repos/:owner/:repo/milestones --jq '.[] | "\(.title): \(.closed_issues)/\(.open_issues + .closed_issues)"'
# Create milestone with due date
gh api -X POST repos/:owner/:repo/milestones \
-f title="Sprint 8" -f due_on="2026-02-15T00:00:00Z"
# Close milestone (API uses number, not name)
MILESTONE_NUM=$(gh api repos/:owner/:repo/milestones --jq '.[] | select(.title=="Sprint 8") | .number')
gh api -X PATCH repos/:owner/:repo/milestones/$MILESTONE_NUM -f state=closed
# Assign issues to milestone (CLI uses name, not number)
gh issue edit 123 124 125 --milestone "Sprint 8"
# Add issue to project
gh project item-add 1 --owner @me --url https://github.com/org/repo/issues/123
# Set custom field (requires GraphQL)
gh api graphql -f query='mutation {...}' -f projectId="..." -f itemId="..."
# Get issue numbers matching criteria
gh issue list --json number,labels --jq '[.[] | select(.labels[].name == "bug")] | .[].number'
# PR summary with author
gh pr list --json number,title,author --jq '.[] | "\(.number): \(.title) by \(.author.login)"'
# Find ready-to-merge PRs (statusCheckRollup is an ARRAY, so fold it first)
gh pr list --json number,reviewDecision,statusCheckRollup \
--jq '[.[] | select(.reviewDecision == "APPROVED"
and ([(.statusCheckRollup // [])[] | .conclusion // .state]
| length > 0 and all(IN("SUCCESS","SKIPPED","NEUTRAL"))))]'
| Milestones | Epics |
|---|---|
| Time-based (sprints, releases) | Topic-based (features) |
| Has due date | No due date |
| Progress bar | Task list checkbox |
| Native REST API | Needs workarounds |
Rule: Use milestones for "when", use parent issues for "what".
Projects v2 uses GraphQL for setting custom fields (Status, Priority, Domain). Basic gh project commands work for listing and adding items, but field updates require GraphQL mutations.
| Rule | Impact | What It Covers |
|---|---|---|
issue-tracking-automation (load ${CLAUDE_PLUGIN_ROOT}/skills/github-operations/rules/issue-tracking-automation.md) | HIGH | Auto-progress from commits, sub-task completion, session summaries |
issue-branch-linking (load ${CLAUDE_PLUGIN_ROOT}/skills/github-operations/rules/issue-branch-linking.md) | MEDIUM | Branch naming, commit references, PR linking patterns |
When creating multiple issues at once (e.g., seeding a sprint), use an array-driven loop:
# Define issues as an array of "title|labels|milestone" entries
SPRINT="Sprint 9"
ISSUES=(
"feat: Add user auth|enhancement,backend|$SPRINT"
"fix: Login redirect loop|bug,high|$SPRINT"
"chore: Update dependencies|maintenance|$SPRINT"
)
for entry in "${ISSUES[@]}"; do
IFS='|' read -r title labels milestone <<< "$entry"
NUM=$(gh issue create \
--title "$title" \
--label "$labels" \
--milestone "$milestone" \
--body "" \
--json number --jq '.number')
echo "Created #$NUM: $title"
done
Tip: Capture the created issue number with
--json number --jq '.number'so you can reference it immediately (e.g., add to Projects v2, link in PRs).
--json for scripting - Parse with --jq for reliability--title, --body flagsgh api rate_limit. On CC ≥ 2.1.116, the Bash tool surfaces a rate-limit hint in the transcript when gh hits 403 — treat that hint as authoritative and back off, don't blind-retry. Before 2.1.116, agents had no signal and would burn all retry attempts in ~13 s.--body "$(cat <<'EOF'...EOF)"Closes #123, Fixes #456 — GitHub auto-closes on mergeYYYY-MM-DDTHH:MM:SSZ for milestone due_on--milestone takes NAME, not number - Load Read("${CLAUDE_PLUGIN_ROOT}/skills/github-operations/references/cli-vs-api-identifiers.md")gh issue close directly - Comment progress with gh issue comment; issues close only when their linked PR merges to the default branchgh-copilot extension is retiredGitHub retired the gh-copilot extension in October 2025. Copilot is now a standalone binary:
# OLD — no longer supported
gh extension install github/gh-copilot # fails
gh copilot suggest "revert last commit" # fails
# NEW — standalone `copilot` binary
copilot suggest "revert last commit"
copilot explain "git rebase -i HEAD~5"
Install from cli.github.com/copilot or via Homebrew (brew install github/gh/copilot). Authentication is shared with gh auth when both are installed.
gh agent-task (2026)New subcommand for managing Copilot coding-agent tasks:
gh agent-task create --repo owner/repo --title "Fix flaky login test"
gh agent-task list --state open
gh agent-task view 42 --log # stream agent log
gh agent-task watch 42 # live-follow until completion
gh agent-task cancel 42
Pairs with the REST endpoint POST /repos/{owner}/{repo}/agent-tasks for CI-driven task creation.
Sub-issues are now a native GitHub concept — no extension required:
# List sub-issues of parent #123
gh api repos/{owner}/{repo}/issues/123/sub_issues
# Add an existing issue #456 as sub-issue of #123
gh api -X POST repos/{owner}/{repo}/issues/123/sub_issues \
-f sub_issue_id=$(gh api repos/{owner}/{repo}/issues/456 --jq .node_id)
# Remove a sub-issue relationship
gh api -X DELETE repos/{owner}/{repo}/issues/123/sub_issue \
-F sub_issue_id=<id>
The old gh-sub-issue third-party extension still works but is superseded. GraphQL sub-issue mutations still require the issue node_id (see references/cli-vs-api-identifiers.md).
ork:create-pr - Create pull requests with proper formatting and review assignmentsork:review-pr - Comprehensive PR review with specialized agentsork:release-management - GitHub release workflow with semantic versioning and changelogsork:commit - Stacked-PR workflow and rebase coordination live in src/skills/commit/rules/ (stacked-pr-workflow, stacked-pr-rebase). There is no stacked-prs skill.ork:issue-progress-tracking - Automatic issue progress updates from commits| Decision | Choice | Rationale |
|---|---|---|
| CLI vs API | gh CLI preferred | Simpler auth, better UX, handles pagination automatically |
| Output format | --json with --jq | Reliable parsing for automation, no regex parsing needed |
| Milestones vs Epics | Milestones for time | Milestones have due dates and progress bars, epics for topic grouping |
| Projects v2 fields | GraphQL mutations | gh project commands limited, GraphQL required for custom fields |
| Milestone lifecycle | Close, don't delete | Preserves history and progress tracking |
These topics are documented first-party. Fetch them there instead of growing a copy in this skill.
| Topic | Source |
|---|---|
gh issue bulk create / edit / list loops, templates, transfer and pin | https://cli.github.com/manual/gh_issue |
| Cross-repo label create / edit / clone | https://cli.github.com/manual/gh_label |
| Org-wide issue search qualifiers | https://cli.github.com/manual/gh_search_issues |
| Milestone REST CRUD: endpoints, payload fields, list filters and sorting | https://docs.github.com/en/rest/issues/milestones |
| Projects v2 field mutations, value unions, field and option ID discovery | https://docs.github.com/en/issues/planning-and-tracking-with-projects/automating-your-project/using-the-api-to-manage-projects |
| Sub-issue endpoint payloads and pagination | https://docs.github.com/en/rest/issues/sub-issues |
| Rate-limit headers, reset semantics, secondary limits | https://docs.github.com/en/rest/using-the-rest-api/rate-limits-for-the-rest-api |
What still stays ours, in full, in this skill: PR review / merge gating including
the statusCheckRollup array fold (references/pr-workflows.md); GraphQL queries,
pagination, and node-id lookup (references/graphql-api.md); the CLI-NAME vs
API-NUMBER identifier mapping for milestones and Projects v2
(references/cli-vs-api-identifiers.md); the sub-issue quick reference above; and
the rate-limit pre-flight guard (examples/automation-scripts.md). House rules with
their rationale are collected in references/ork-delta.md.
Load on demand with Read("${CLAUDE_PLUGIN_ROOT}/skills/github-operations/references/<file>"):
| File | Content |
|---|---|
ork-delta.md | House rules: hook contracts, close-don't-delete, rate-limit discipline, the file-set contract |
pr-workflows.md | Reviews, merge strategies, auto-merge, statusCheckRollup folding |
graphql-api.md | Complex queries, pagination, bulk operations |
cli-vs-api-identifiers.md | NAME vs NUMBER footguns, milestone/project ID mapping |
issue-management.md | Pointer stub: issue delta plus upstream links |
milestone-api.md | Pointer stub: milestone delta plus upstream links |
projects-v2.md | Pointer stub: Projects v2 delta plus upstream links |
Load: Read("${CLAUDE_PLUGIN_ROOT}/skills/github-operations/examples/automation-scripts.md") - Rate-limit discipline for long gh loops, plus pointers for the bulk-loop recipes