Github Flow

👤 drumrobot 📦 v0.6.1 ⭐ 4.5 ⬇️ 1.1K 下載
💻 開發程式設計 免費

📖 技能介紹


name: github-flow metadata: author: es6kr version: "0.1.0" depends-on: - code-workflow - web-browser description: | GitHub issue/PR workflow automation. Topics — auth-scope (gh CLI priority + account mapping + batch scope refresh + 404 checklist), commit-message-discipline (commit message authoring + amend refresh + PUBLIC English enforcement), dependencies (blocked-by/sub-issues via GraphQL), epic-bundle (deferred findings → Epic + sub-issues), expand (expand-vs-split mid-work), identity-auth (gh account map + scope refresh + GH_TOKEN fallback), merge (CI/review gates + no autonomous push), plan-to-issue (MD → issue body), pr (PR with test plan), push-guards (branch/push-reject/force-push/main-push), register (dup check + strategy), review (structured comments), review-apply (deferred feedback apply), sanitize (PUBLIC repo personal data scan), upstream-issue (external OSS feature/bug). Use when: "plan to issue", "issue register", "create PR", "PR body", "code review", "merge PR", "PR squash", "sanitize", "PII", "expand PR", "blocked by", "epic bundle", "upstream issue", "review apply", "sub-issue", "gh auth", "force push", "push reject", "branch change forbid", "auth scope", "account mapping", "scope refresh", "commit message", "PUBLIC repo English".


GitHub Flow

Convert plans, research, and implementation results into GitHub issues and PRs.

Topics

Topic Description Guide
auth-scope gh CLI priority + account mapping + batch scope refresh + org-repo 404 checklist auth-scope.md
commit-message-discipline Commit message authoring, message update on amend, PUBLIC repo English enforcement, git operation type continuity, verb selection (.md as source code) commit-message-discipline.md
dependencies Manage native Issue Relationships (blocked-by/blocking) via addBlockedBy/removeBlockedBy GraphQL mutations dependencies.md
epic-bundle Bundle deferred review findings across multiple PRs into one Epic tracking issue (checklist + native sub-issues + epic label) epic-bundle.md
expand Decide expand-vs-split when new findings emerge mid-work and update title/body expand.md
identity-auth Owner-based gh account mapping for commit author identity + gh auth scope refresh + GH_TOKEN env fallback for org repo 404 identity-auth.md
merge CI success and AI review check then merge with commit cleanup, including pre-merge blockedBy verification merge.md
plan-to-issue Convert plan/research MD to GitHub issue body or comments plan-to-issue.md
pr Create PR with structured body, test plan, and optional visual attachments pr.md
push-guards Branch-change ask + push rejection ask + force-push CI status check + main/master push restriction + shared-branch direct-push restriction push-guards.md
register Evaluate duplicates and decide registration strategy (new issue vs comment vs sub-issue) register.md
review Review PR code and post structured review comments review.md
review-apply Apply deferred [REVIEW_FEEDBACK] items from fix_plan to code, update PR Summary review-apply.md
sanitize HARD STOP scan for personal data before posting to PUBLIC repos sanitize.md
upstream-issue Register feature requests/bug reports on external open-source repos with duplicate check + draft + sanitize upstream-issue.md

Topic Dependencies

github-flow (issue/PR workflow)
  ├─→ plan-to-issue (issue body content)
  ├─→ epic-bundle (deferred findings across PRs → one Epic issue)
  │     ├─→ uses plan-to-issue (Epic body) + register (dup check) + dependencies (sub-issues)
  │     └─→ receives from: consolidate next step (auto-suggest when deferred findings accumulate)
  ├─→ register (evaluate duplicates and decide strategy)
  ├─→ pr (PR body content + visual attachments)
  ├─→ review (post structured review comments)
  ├─→ expand (mid-work scope expansion)
  ├─→ dependencies (Issue Relationships: blocked-by/blocking)
  │     └─→ used by merge step 5 (pre-merge blockedBy check)
  ├─→ merge (CI/Review/Test Plan/blockedBy verification → squash+merge)
  ├─→ review-apply (deferred [REVIEW_FEEDBACK] → code fix → Summary update)
  │     └─→ receives from: consolidate Step 7 (deferred registration)
  ├─→ sanitize (HARD STOP scan before posting to PUBLIC repos)
  └─→ upstream-issue (external repo feature request/bug report with duplicate check + draft + sanitize)
  • dependencies → merge: dependencies adds blockedBy relationships. merge.md step 5 queries the same field to gate merge until predecessors are CLOSED
  • plan-to-issue → dependencies: when a plan has frontmatter chain: declaring a sequential issue order, dependencies applies it to GitHub
  • All topics → sanitize: any text published to PUBLIC repos (issue body, PR body, comments, review text) must pass sanitize HARD STOP first

Applicability

This skill applies automatically when git remote get-url origin contains github.com. For non-GitHub remotes (GitLab, Bitbucket, etc.), this skill does not apply.

Core Rules

1. Verification Plan Required

Every issue body and PR body must include a verification/test plan section. This is shared with code-workflow's plan step.

2. No Internal Paths in Issues/PRs

.ralph/docs/, .ralph/fix_plan.md, .omc/ and other internal working paths must never appear in GitHub issue body, comments, or PR body. These are local-only artifacts.

Instead of: "See .ralph/docs/generated/plan-180.md" Write: The actual content inline, or "See the implementation plan comment below"

訪問小蔥技能站7w4.net,解鎖更多實用的AI技能外掛。

3. Body vs Comment Selection

Content Type Target Reason
Implementation plan (confirmed) Issue body update Stable reference for the issue
Checklist (impl/verify) Issue body update Trackable via GitHub checkbox
Discussion items / open questions Issue comment Threaded, time-stamped, doesn't clutter body
Progress updates Issue comment Chronological record
Review feedback summary Issue comment Preserves review history

🤖 AI 評測

這是一個質量優秀的Skill,功能覆蓋非常全面,文件規範且規則清晰。它的安全檢查機制完善,能有效防止敏感資訊洩露,賬號身份管理也很嚴謹。對於需要在GitHub上管理issue和PR的開發者來說非常實用。不過由於規則較多,初次使用需要花點時間熟悉,整體複雜度較高。

📊 多維度評分

適應性4.6
規範性4.6
有效性4.7
可靠性4.5
可信度4.3

📁 包含檔案 (23 個)

📄 CHANGELOG.md 5.7 KB
📄 LICENSE 1 KB
📄 SKILL.md 6.4 KB
📄 _meta.json 130 B
📄 auth-scope.md 6.5 KB
📄 commit-message-discipline.md 8.3 KB
📄 dependencies.md 15.9 KB
📄 epic-bundle.md 8.6 KB
📄 expand.md 6 KB
📄 identity-auth.md 13.1 KB
📄 merge.md 40.4 KB
📄 plan-to-issue.md 13.8 KB
📄 pr.md 47.7 KB
📄 push-guards.md 17.1 KB
📄 register.md 7.3 KB
📄 review-apply.md 4.1 KB
📄 review.md 3.1 KB
📄 sanitize.md 18.4 KB
📄 scripts/check-test-plan.js 3.7 KB
📄 scripts/gh-as.sh 708 B
📄 scripts/review-as.sh 2.2 KB
📄 skill-card.md 2.5 KB
📄 upstream-issue.md 5.4 KB