--- name: gh-contrib description: "Create GitHub issues and PRs following contribution guidelines. Activate when user says 'contribute this', 'submit pr', 'open issue and pr', or wants to submit changes to upstream." --- # GitHub Contribution Workflow ## Prerequisites - Changes committed in a feature branch - Duplicates already verified by user ## Workflow ### 1. Check Contribution Guidelines Deploy explore agent to find contribution guidelines: - Look for CONTRIBUTING.md, README, issue/PR templates - Extract: title format, target branch, required labels ### 2. Detect Fork & Push ```bash git remote -v # identify fork remote git push -u ``` ### 3. Create Issue ```bash gh issue create --repo / \ --title "" \ --body "<body>" ``` ### 4. Create PR ```bash gh pr create --repo <owner>/<repo> \ --head <fork-user>:<branch> \ --base <target-branch> \ --title "<title>" \ --body "## Summary <description> Closes #<issue-number>" ``` ### 5. Comment on Issue ```bash gh issue comment <issue-number> --repo <owner>/<repo> --body "PR: #<pr-number>" ``` ## Default Conventions Use only if no contribution guidelines found: | Type | Issue Prefix | PR Prefix | | ------- | ------------ | --------- | | Feature | `[FEATURE]:` | `feat:` | | Bug | `[BUG]:` | `fix:` | | Docs | `[DOCS]:` | `docs:` | | Chore | `[CHORE]:` | `chore:` | ## Flow ``` changes committed -> push to fork -> open issue -> open pr -> comment on issue ```