GitHub project operations with quality gates.

GitHub stars
14

Install

/plugin install github@dotfiles

Run it inside Claude Code after adding the marketplace with /plugin marketplace add dubuqingfeng/dotfiles.

Contents

Discovered from source

Commands 2

Context

  • Current git status: !git status
  • Current branch: !git branch --show-current
  • Open issues: !gh issue list --state open --limit 10
  • GitHub authentication: !gh auth status

Requirements

  • Follow TDD principles and Conventional Commits.
  • Use proper labels, scope, and auto-closing keywords.
  • Protected branches require PR + review + CI; no direct pushes to main/develop.
  • Use atomic commits for logical units of work: Each commit should represent one complete, cohesive change.
  • Title: entirely lowercase, <50 chars, imperative mood (e.g., "add", "fix", "update"), conventional commits format (feat:, fix:, docs:, refactor:, test:, chore:)
  • Body: blank line after title, ≤72 chars per line, must start with uppercase letter, standard capitalization and punctuation. Describe what changed and why, not how.
  • Footer (optional): Must start with uppercase letter, standard capitalization. Reference issues/PRs (Closes #123, Fixes #456, Linked to PR #789). Use BREAKING CHANGE: prefix for breaking changes.

Examples

feat(auth): add google oauth login flow

- Introduce Google OAuth 2.0 for user sign-in
- Add backend callback endpoint `/auth/google/callback`
- Update login UI with Google button and loading state

Add a new authentication option improving cross-platform
sign-in.

Closes #42. Linked to #38 and PR #45
fix(api): handle null payload in session refresh

- Validate payload before accessing `user.id`
- Return proper 400 response instead of 500
- Add regression test for null input

Prevents session refresh crash when token expires.

Fixes #105
feat(auth): migrate to oauth 2.0

- Replace basic auth with OAuth 2.0 flow
- Update authentication middleware
- Add token refresh endpoint

BREAKING CHANGE: Authentication API now requires OAuth 2.0 tokens. Basic auth is no longer supported.

Closes #120. Linked to #115 and PR #122

Your Task

IMPORTANT: You MUST use the Task tool to complete ALL tasks.

  1. Assess the repository context and select an issue scope that fits $ARGUMENTS.
  2. Create or update labels as needed, then draft the issue with the required structure and links.
  3. Document decisions (including branch strategy) and share follow-up actions with the team.

Decision Logic

Branch-based decision tree:

  • On main/develop: Create issue directly.
  • On PR branch: Ask "Must this be fixed before merge?"
    • Yes: Comment in PR with detailed context and reasoning, don't create issue.
    • No: Create new issue for later with clear justification for scope separation.

Issue Types

  1. Epic issues: Multi-PR initiatives (no auto-close keywords).
  2. PR-scoped issues: Single PR resolution (use auto-close keywords).
  3. Review issues: Non-blocking feedback from PR reviews.

Issue Creation Process

  1. Analyze context from current repository state and existing issues.
  2. Determine issue type based on scope and complexity.
  3. Create proper labels if they don't exist:
    gh label create "priority:high" --description "High priority - this sprint" --color "d73a4a" || true
    gh label create "priority:medium" --description "Medium priority - next sprint" --color "fbca04" || true
    gh label create "priority:low" --description "Low priority - backlog" --color "0075ca" || true
    
  4. Create issue with proper structure and labels.
  5. Link related items if applicable.

Issue Structure Requirements

  • Title: ≤70 chars, imperative, no emojis.
  • Labels: Include priority and type labels.
  • Body: Problem description, acceptance criteria, context.
  • Auto-closing: Use keywords (fixes, closes, resolves) for PR-scoped issues.

Key Principles

  • Follow TDD: issue → test → code → PR → merge.
  • Epic issues: manual linking, no auto-close keywords.
  • PR-scoped issues: designed for auto-close keywords.
  • Clear, actionable descriptions with proper context.

Context

  • Current git status: !git status
  • Current branch: !git branch --show-current
  • Unpushed commits: !git log @{u}..HEAD --oneline 2>/dev/null || git log --oneline -5
  • GitHub authentication: !gh auth status
  • Repository changes: !git diff --stat HEAD~1..HEAD 2>/dev/null || echo "No recent changes"

Requirements

  • Ensure the repository is clean, authenticated, and ready for PR submission.
  • Complete lint, test, build, and security checks before creating the PR.
  • Link related issues and apply accurate labels for traceability.
  • Use atomic commits for logical units of work: Each commit should represent one complete, cohesive change.
  • Title: entirely lowercase, <50 chars, imperative mood (e.g., "add", "fix", "update"), conventional commits format (feat:, fix:, docs:, refactor:, test:, chore:)
  • Body: blank line after title, ≤72 chars per line, must start with uppercase letter, standard capitalization and punctuation. Describe what changed and why, not how.
  • Footer (optional): Must start with uppercase letter, standard capitalization. Reference issues/PRs (Closes #123, Fixes #456, Linked to PR #789). Use BREAKING CHANGE: prefix for breaking changes.

Examples

feat(auth): add google oauth login flow

- Introduce Google OAuth 2.0 for user sign-in
- Add backend callback endpoint `/auth/google/callback`
- Update login UI with Google button and loading state

Add a new authentication option improving cross-platform
sign-in.

Closes #42. Linked to #38 and PR #45
fix(api): handle null payload in session refresh

- Validate payload before accessing `user.id`
- Return proper 400 response instead of 500
- Add regression test for null input

Prevents session refresh crash when token expires.

Fixes #105
feat(auth): migrate to oauth 2.0

- Replace basic auth with OAuth 2.0 flow
- Update authentication middleware
- Add token refresh endpoint

BREAKING CHANGE: Authentication API now requires OAuth 2.0 tokens. Basic auth is no longer supported.

Closes #120. Linked to #115 and PR #122

Your Task

IMPORTANT: You MUST use the Task tool to complete ALL tasks.

  1. Validate repository readiness, analyse change scope, and detect any blockers.
  2. Run the necessary quality and security checks; resolve failures by collaborating with specialized agents when required.
  3. Assemble the pull request with the prescribed structure, link issues, apply labels, and report the final status to the team.

Workflow Steps

  1. Repository Validation - Check authentication and branch status
  2. Change Analysis - Analyze commits and file changes
  3. Quality Validation - Run project-specific quality checks
  4. Security Scanning - Check for sensitive data exposure
  5. Issue Discovery - Find and link related issues
  6. PR Creation - Generate and create pull request with proper metadata

Quality Validation Process

Node.js Projects:

  • Run lint, test, build, and type-check commands
  • Validate package.json changes
  • Check for security vulnerabilities

Security Validation

  • Scan for sensitive files (.env, .key, .pem)
  • Check for hardcoded secrets, passwords, tokens
  • Validate input sanitization in changed files
  • Ensure no credentials in commit history

Pre-Creation Requirements

  • Repository state validated and clean
  • All quality checks passed (lint, test, build)
  • Security scan completed without issues
  • Related issues identified and linked
  • Proper branch naming and commit messages following standards

Failure Resolution Process

When quality checks fail:

  1. Use TodoWrite to create specific task list for failures
  2. Use Task tool with specialized agents:
    • @code-reviewer — logic correctness, tests, error handling.
    • @security-reviewer — authentication, data protection, validation.
  3. Fix issues systematically with validation after each fix
  4. Mark tasks completed immediately after resolution
  5. Re-run quality checks until all pass

PR Structure Requirements

Title Guidelines:

  • Maximum 70 characters
  • Use imperative mood
  • No emojis
  • Clear and descriptive

Body Template:

## Summary
Brief description of changes and business impact

## Changes
- List of key modifications
- Technical details and rationale

## Related Issues
Fixes #123, Closes #456

## Testing
- [ ] Unit tests added/updated
- [ ] All tests pass
- [ ] Manual testing completed
- [ ] Edge cases covered

## Security & Quality
- [ ] No sensitive data exposed
- [ ] Input validation implemented
- [ ] Linting and type checking passed
- [ ] Build successful

## Type of Change
- [ ] Bug fix
- [ ] New feature
- [ ] Breaking change
- [ ] Documentation update

Automated Labeling

  • testing - Test file modifications
  • documentation - Documentation updates
  • dependencies - Package file changes
  • security - Security-related modifications

Commit Message Validation

  • Use atomic commits for logical units of work: Each commit should represent one complete, cohesive change.
  • Title: entirely lowercase, <50 chars, imperative mood (e.g., "add", "fix", "update"), conventional commits format (feat:, fix:, docs:, refactor:, test:, chore:)
  • Body: blank line after title, ≤72 chars per line, must start with uppercase letter, standard capitalization and punctuation. Describe what changed and why, not how.
  • Footer (optional): Must start with uppercase letter, standard capitalization. Reference issues/PRs (Closes #123, Fixes #456, Linked to PR #789). Use BREAKING CHANGE: prefix for breaking changes.

Examples

feat(auth): add google oauth login flow

- Introduce Google OAuth 2.0 for user sign-in
- Add backend callback endpoint `/auth/google/callback`
- Update login UI with Google button and loading state

Add a new authentication option improving cross-platform
sign-in.

Closes #42. Linked to #38 and PR #45
fix(api): handle null payload in session refresh

- Validate payload before accessing `user.id`
- Return proper 400 response instead of 500
- Add regression test for null input

Prevents session refresh crash when token expires.

Fixes #105
feat(auth): migrate to oauth 2.0

- Replace basic auth with OAuth 2.0 flow
- Update authentication middleware
- Add token refresh endpoint

BREAKING CHANGE: Authentication API now requires OAuth 2.0 tokens. Basic auth is no longer supported.

Closes #120. Linked to #115 and PR #122
  • Review all commits in branch for compliance
  • Handle non-standard commits by documenting in PR description or interactive rebase if safe

Best Practices

  • Quality-first: All checks must pass before PR creation
  • Security validation: Comprehensive scanning for vulnerabilities
  • Issue linking: Connect PRs to related issues with auto-closing keywords
  • Small, focused changes: Easier to review and merge

Sponsors

Details

Marketplace
dubuqingfeng/dotfiles
Source
coding-agent/dist/claude/plugins/github
Category
Productivity

More from dubuqingfeng/dotfiles

All 4