feat(ci): implement comprehensive GitHub automation workflows
Implemented full GitHub automation system from claude-code-skills-factory with project-specific configuration for claude-skills repository. ## New Workflows - **ci-quality-gate.yml**: Automated linting, testing, and security checks - **claude-code-review.yml**: Enhanced with kill switch and bypass mechanisms - **pr-issue-auto-close.yml**: Auto-close linked issues when PRs merge - **smart-sync.yml**: Bidirectional sync between issues and project board ## Configuration Files - **WORKFLOW_KILLSWITCH**: Emergency workflow disable capability - **branch-protection-config.json**: Branch protection settings - **commit-template.txt**: Standardized commit message template - **AUTOMATION_SETUP.md**: Complete setup and configuration guide ## Templates - **pull_request_template.md**: Enhanced with security and quality checklists ## Key Features ✅ AI-powered code reviews with Claude ✅ Automatic issue closure on PR merge ✅ Bidirectional issue ↔ project board sync ✅ Quality gates (YAML lint, Python syntax, security audit) ✅ Kill switch for emergency workflow disable ✅ Rate limit protection with circuit breakers ✅ 10-second debouncing to prevent sync loops ## Project Configuration - Repository: alirezarezvani/claude-skills - Project Number: 9 - Status: Ready for PROJECTS_TOKEN configuration ## Testing Workflows validated with yamllint and ready for deployment. See .github/AUTOMATION_SETUP.md for complete setup instructions.
This commit is contained in:
Reza Rezvani
209
.github/pull_request_template.md
vendored
209
.github/pull_request_template.md
vendored
@@ -1,183 +1,60 @@
|
||||
# Pull Request
|
||||
## Summary
|
||||
<!-- Brief description of what this PR accomplishes -->
|
||||
|
||||
## Description
|
||||
|
||||
**What does this PR do?**
|
||||
## Context
|
||||
<!-- Why these changes are needed. Link to issues, discussions, or explain the problem being solved. -->
|
||||
|
||||
A clear and concise description of the changes.
|
||||
|
||||
## Type of Change
|
||||
|
||||
Select the type of change:
|
||||
- [ ] New skill addition
|
||||
- [ ] Skill enhancement/improvement
|
||||
- [ ] Bug fix
|
||||
- [ ] Documentation update
|
||||
- [ ] Python script improvement
|
||||
- [ ] Refactoring/optimization
|
||||
- [ ] Other (specify)
|
||||
|
||||
## Related Issue
|
||||
|
||||
Fixes #(issue number)
|
||||
|
||||
Or: Related to #(issue number)
|
||||
|
||||
---
|
||||
|
||||
## Changes Made
|
||||
|
||||
### Skills Added/Modified
|
||||
|
||||
**Skill Name(s):**
|
||||
-
|
||||
|
||||
**What Changed:**
|
||||
- Added: (new capabilities, scripts, references)
|
||||
- Modified: (what was changed and why)
|
||||
- Removed: (what was deprecated/removed and why)
|
||||
## Changes
|
||||
<!-- High-level overview of what was modified -->
|
||||
|
||||
### Python Scripts
|
||||
|
||||
**New Scripts:**
|
||||
- `script_name.py` - Purpose and functionality
|
||||
|
||||
**Modified Scripts:**
|
||||
- `existing_script.py` - Changes made
|
||||
|
||||
### Documentation
|
||||
|
||||
**Files Updated:**
|
||||
- README.md - (what sections)
|
||||
- SKILL.md - (what changed)
|
||||
- Reference files - (which ones)
|
||||
|
||||
---
|
||||
-
|
||||
|
||||
## Testing
|
||||
<!-- Confirm all checks have passed -->
|
||||
|
||||
### Testing Performed
|
||||
- [ ] Local quality checks passed (Python syntax, markdown links)
|
||||
- [ ] All Python scripts tested and working
|
||||
- [ ] Skills validated with Claude (if applicable)
|
||||
- [ ] `ci-quality-gate` workflow will pass
|
||||
- [ ] Manual testing completed
|
||||
|
||||
- [ ] Tested with Claude AI (uploaded SKILL.md and verified activation)
|
||||
- [ ] Tested with Claude Code (loaded skill and ran workflows)
|
||||
- [ ] All Python scripts run without errors
|
||||
- [ ] Ran scripts with `--help` flag
|
||||
- [ ] Tested JSON output (if applicable)
|
||||
- [ ] All reference links work
|
||||
- [ ] No broken relative paths
|
||||
**Testing Details**:
|
||||
<!-- Describe what you tested and how -->
|
||||
|
||||
### Test Results
|
||||
|
||||
**Claude Activation:**
|
||||
- [ ] Skill activates when appropriate
|
||||
- [ ] Description triggers correctly
|
||||
- [ ] Keywords help discovery
|
||||
## Security
|
||||
<!-- Confirm security requirements met -->
|
||||
|
||||
**Python Scripts:**
|
||||
```bash
|
||||
# Commands run for testing
|
||||
python scripts/tool.py --help
|
||||
python scripts/tool.py test-input.txt
|
||||
```
|
||||
- [ ] No secrets, credentials, or API keys committed
|
||||
- [ ] No destructive commands in generated outputs
|
||||
- [ ] Path traversal vulnerabilities checked
|
||||
- [ ] Dependencies reviewed (if added)
|
||||
|
||||
**Results:**
|
||||
```
|
||||
[Paste test output or describe results]
|
||||
```
|
||||
## Documentation
|
||||
<!-- Confirm documentation updated -->
|
||||
|
||||
- [ ] README.md updated (if applicable)
|
||||
- [ ] CLAUDE.md updated (if applicable)
|
||||
- [ ] Inline code comments added for complex logic
|
||||
- [ ] CHANGELOG.md updated (if applicable)
|
||||
- [ ] Skill SKILL.md files updated (if applicable)
|
||||
|
||||
## Reviewers
|
||||
<!-- Tag reviewers who should look at this PR -->
|
||||
|
||||
- [ ] @
|
||||
|
||||
## Related Issues
|
||||
<!-- Link issues this PR addresses using keywords: Fixes, Closes, Resolves, Related to -->
|
||||
|
||||
Fixes #
|
||||
Closes #
|
||||
Related to #
|
||||
|
||||
---
|
||||
|
||||
## Quality Checklist
|
||||
|
||||
### SKILL.md Quality
|
||||
|
||||
- [ ] YAML frontmatter is valid
|
||||
- [ ] `name` matches directory name
|
||||
- [ ] `description` includes what, when, and keyword triggers
|
||||
- [ ] `license: MIT` included
|
||||
- [ ] `metadata` section complete (version, author, category, domain)
|
||||
- [ ] Keywords section added
|
||||
- [ ] SKILL.md length <200 lines (or justified if longer)
|
||||
- [ ] Clear quick start section
|
||||
- [ ] Core workflows documented
|
||||
- [ ] Examples included
|
||||
|
||||
### Python Scripts Quality (if applicable)
|
||||
|
||||
- [ ] Production-ready code (not placeholders)
|
||||
- [ ] CLI with `--help` support
|
||||
- [ ] Proper error handling
|
||||
- [ ] Clear docstrings
|
||||
- [ ] Type hints used
|
||||
- [ ] Standard library preferred
|
||||
- [ ] Dependencies documented
|
||||
- [ ] No hardcoded paths or credentials
|
||||
|
||||
### Documentation Quality
|
||||
|
||||
- [ ] All links work (no 404s)
|
||||
- [ ] Markdown formatting correct
|
||||
- [ ] No typos or grammar errors
|
||||
- [ ] Code blocks have language specified
|
||||
- [ ] Examples are realistic and complete
|
||||
- [ ] Screenshots included where helpful
|
||||
|
||||
### Repository Integration
|
||||
|
||||
- [ ] Domain-specific README.md updated (if new skill)
|
||||
- [ ] Main README.md updated (if new domain or major feature)
|
||||
- [ ] CLAUDE.md updated (if changes affect development)
|
||||
- [ ] CHANGELOG.md updated (in Unreleased section)
|
||||
|
||||
---
|
||||
|
||||
## ROI & Value
|
||||
|
||||
**Estimated Value of This Contribution:**
|
||||
|
||||
**Time Savings:**
|
||||
- Hours saved per month per user: (estimate)
|
||||
- Number of potential users: (estimate)
|
||||
|
||||
**Quality Improvements:**
|
||||
- Specific quality gains: (describe)
|
||||
- Measurable improvements: (quantify if possible)
|
||||
|
||||
**Why This Matters:**
|
||||
Brief explanation of the business/user value.
|
||||
|
||||
---
|
||||
|
||||
## Screenshots
|
||||
|
||||
If applicable, add screenshots to help explain your changes.
|
||||
|
||||
---
|
||||
|
||||
## Additional Notes
|
||||
|
||||
Any other information reviewers should know:
|
||||
- Implementation decisions made
|
||||
- Alternative approaches considered
|
||||
- Known limitations
|
||||
- Future enhancement ideas
|
||||
|
||||
---
|
||||
|
||||
## Contributor Checklist
|
||||
|
||||
**Before Submitting:**
|
||||
- [ ] I have read [CONTRIBUTING.md](../CONTRIBUTING.md)
|
||||
- [ ] I have followed the skill creation guidelines
|
||||
- [ ] I have tested thoroughly
|
||||
- [ ] I have updated all relevant documentation
|
||||
- [ ] I have added my changes to CHANGELOG.md (Unreleased section)
|
||||
- [ ] My code follows the repository's style guidelines
|
||||
- [ ] All new Python scripts are production-ready
|
||||
- [ ] I agree to the MIT License for my contributions
|
||||
|
||||
---
|
||||
|
||||
**Thank you for contributing to Claude Skills Library!** 🚀
|
||||
|
||||
Your contribution helps make world-class expertise accessible to everyone through Claude AI.
|
||||
**Type**: <!-- feat | fix | docs | refactor | chore | ci | test | perf | skill -->
|
||||
**Scope**: <!-- component affected (e.g., marketing-skill, workflows, agents, templates) -->
|
||||
|
||||
Reference in New Issue
Block a user