Implement comprehensive content moderation and community protection

- Added Code of Conduct with clear behavioral standards
- Created Contributing guidelines with submission requirements
- Implemented structured issue templates (bug reports, features, new agents, moderation)
- Disabled blank issues to enforce template usage
- Added automated content moderation via GitHub Actions:
  * Real-time scanning for hate speech, threats, and profanity
  * Automatic closure/locking of critical violations
  * Moderation alerts for maintainer review
- Set up welcome system for new contributors with community guidelines
- Enabled GitHub Discussions as alternative to issues for general questions
- Closed and locked existing hate speech issue #30
- Blocked offending user account

This creates a multi-layered defense against inappropriate content while
maintaining an open, welcoming environment for legitimate contributors.
This commit is contained in:
Seth Hobson
2025-08-01 16:42:41 -04:00
parent bb90279a91
commit ea5644ab9b
9 changed files with 882 additions and 0 deletions

207
.github/workflows/content-moderation.yml vendored Normal file
View File

@@ -0,0 +1,207 @@
name: Content Moderation
on:
issues:
types: [opened, edited]
issue_comment:
types: [created, edited]
pull_request:
types: [opened, edited]
pull_request_review_comment:
types: [created, edited]
jobs:
moderate-content:
runs-on: ubuntu-latest
permissions:
issues: write
pull-requests: write
contents: read
steps:
- name: Check for inappropriate content
id: content-check
uses: actions/github-script@v7
with:
script: |
// Define inappropriate content patterns
const hateWords = [
// Racial slurs (censored for detection)
'n[i1]gg[e3]r', 'n[i1]gg[a4]', 'ch[i1]nk', 'sp[i1]c', 'k[i1]k[e3]',
'w[e3]tb[a4]ck', 'b[e3][a4]n[e3]r', 'g[o0][o0]k', 'r[a4]gh[e3][a4]d',
// Homophobic/transphobic slurs
'f[a4]gg[o0]t', 'tr[a4]nn[y1]', 'd[y1]k[e3]',
// Religious/ethnic slurs
'j[e3]w', 'r[a4]gh[e3][a4]d', 'c[a4]m[e3]lj[o0]ck[e3]y',
// General offensive terms
'r[e3]t[a4]rd', 'sp[a4]st[i1]c'
];
const profanity = [
'f[u*]ck[i1]ng?', 'sh[i1]t', 'b[i1]tch', 'c[u*]nt', 'p[i1]ss',
'd[a4]mn', 'h[e3]ll', 'cr[a4]p', '[a4]ss', 'b[a4]st[a4]rd'
];
const threats = [
'k[i1]ll y[o0]u', 'd[i1][e3]', 'murd[e3]r', 'h[a4]rm y[o0]u',
'hurt y[o0]u', 'destroy y[o0]u', 'end y[o0]u'
];
// Get content based on event type
let content = '';
let contentType = '';
let itemNumber = 0;
if (context.eventName === 'issues') {
content = context.payload.issue.title + ' ' + context.payload.issue.body;
contentType = 'issue';
itemNumber = context.payload.issue.number;
} else if (context.eventName === 'issue_comment') {
content = context.payload.comment.body;
contentType = 'issue comment';
itemNumber = context.payload.issue.number;
} else if (context.eventName === 'pull_request') {
content = context.payload.pull_request.title + ' ' + context.payload.pull_request.body;
contentType = 'pull request';
itemNumber = context.payload.pull_request.number;
} else if (context.eventName === 'pull_request_review_comment') {
content = context.payload.comment.body;
contentType = 'PR comment';
itemNumber = context.payload.pull_request.number;
}
if (!content) return;
const normalizedContent = content.toLowerCase()
.replace(/[^a-z0-9\s]/g, '')
.replace(/\s+/g, ' ');
// Check for violations
let violation = null;
let severity = 'low';
// Check hate speech (highest severity)
for (const word of hateWords) {
const regex = new RegExp(word, 'i');
if (regex.test(normalizedContent)) {
violation = 'hate speech';
severity = 'critical';
break;
}
}
// Check threats (high severity)
if (!violation) {
for (const threat of threats) {
const regex = new RegExp(threat, 'i');
if (regex.test(normalizedContent)) {
violation = 'threats';
severity = 'high';
break;
}
}
}
// Check excessive profanity (medium severity)
if (!violation) {
let profanityCount = 0;
for (const word of profanity) {
const regex = new RegExp(word, 'gi');
const matches = normalizedContent.match(regex);
if (matches) profanityCount += matches.length;
}
if (profanityCount >= 3) {
violation = 'excessive profanity';
severity = 'medium';
}
}
// Set outputs
core.setOutput('violation', violation || 'none');
core.setOutput('severity', severity);
core.setOutput('content-type', contentType);
core.setOutput('item-number', itemNumber);
if (violation) {
console.log(`⚠️ Detected ${violation} (${severity} severity) in ${contentType} #${itemNumber}`);
}
- name: Handle critical violations
if: steps.content-check.outputs.violation != 'none' && steps.content-check.outputs.severity == 'critical'
uses: actions/github-script@v7
with:
script: |
const itemNumber = ${{ steps.content-check.outputs.item-number }};
const contentType = '${{ steps.content-check.outputs.content-type }}';
const violation = '${{ steps.content-check.outputs.violation }}';
if (contentType === 'issue') {
// Close and lock the issue immediately
await github.rest.issues.update({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: itemNumber,
state: 'closed'
});
await github.rest.issues.lock({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: itemNumber,
lock_reason: 'off-topic'
});
// Add moderation comment
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: itemNumber,
body: `🚫 **This issue has been automatically closed and locked due to a Code of Conduct violation.**\n\n**Violation**: ${violation}\n\n**This action was taken because the content violates our community standards. Repeated violations may result in being blocked from this repository.**\n\n📖 Please review our [Code of Conduct](.github/CODE_OF_CONDUCT.md) and [Contributing Guidelines](.github/CONTRIBUTING.md).`
});
}
- name: Handle high severity violations
if: steps.content-check.outputs.violation != 'none' && steps.content-check.outputs.severity == 'high'
uses: actions/github-script@v7
with:
script: |
const itemNumber = ${{ steps.content-check.outputs.item-number }};
const contentType = '${{ steps.content-check.outputs.content-type }}';
if (contentType === 'issue') {
// Add warning label and comment
await github.rest.issues.addLabels({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: itemNumber,
labels: ['moderation-review']
});
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: itemNumber,
body: `⚠️ **Content Warning**: This ${contentType} has been flagged for moderation review due to potentially inappropriate content.\n\nPlease ensure all content follows our [Code of Conduct](.github/CODE_OF_CONDUCT.md). A maintainer will review this shortly.`
});
}
- name: Notify maintainers
if: steps.content-check.outputs.violation != 'none'
uses: actions/github-script@v7
with:
script: |
const violation = '${{ steps.content-check.outputs.violation }}';
const severity = '${{ steps.content-check.outputs.severity }}';
const contentType = '${{ steps.content-check.outputs.content-type }}';
const itemNumber = ${{ steps.content-check.outputs.item-number }};
// Create a moderation alert issue
await github.rest.issues.create({
owner: context.repo.owner,
repo: context.repo.repo,
title: `[MODERATION ALERT] ${violation} detected in ${contentType} #${itemNumber}`,
body: `🚨 **Automated Moderation Alert**\n\n**Details:**\n- **Type**: ${violation} (${severity} severity)\n- **Location**: ${contentType} #${itemNumber}\n- **Action taken**: ${severity === 'critical' ? 'Automatically closed and locked' : 'Flagged for review'}\n\n**Next steps:**\n- [ ] Review the flagged content\n- [ ] Take additional action if needed\n- [ ] Consider blocking repeat offenders\n\n**Links:**\n- [View ${contentType} #${itemNumber}](https://github.com/${context.repo.owner}/${context.repo.repo}/${contentType === 'issue' ? 'issues' : 'pull'}/${itemNumber})\n\nThis alert was generated automatically by the content moderation system.`,
labels: ['moderation', 'automated-alert']
});
console.log(`📧 Created moderation alert for ${violation} in ${contentType} #${itemNumber}`);

View File

@@ -0,0 +1,105 @@
name: Welcome New Contributors
on:
issues:
types: [opened]
pull_request:
types: [opened]
jobs:
welcome:
runs-on: ubuntu-latest
permissions:
issues: write
pull-requests: write
steps:
- name: Check if first-time contributor
id: check-contributor
uses: actions/github-script@v7
with:
script: |
const author = context.payload.sender.login;
// Check if this is their first contribution
const { data: issues } = await github.rest.search.issuesAndPullRequests({
q: `repo:${context.repo.owner}/${context.repo.repo} author:${author}`,
sort: 'created',
order: 'asc',
per_page: 2
});
const isFirstTime = issues.items.length <= 1;
core.setOutput('is-first-time', isFirstTime);
core.setOutput('author', author);
console.log(`User ${author} is ${isFirstTime ? 'a first-time' : 'a returning'} contributor`);
- name: Welcome first-time contributors
if: steps.check-contributor.outputs.is-first-time == 'true'
uses: actions/github-script@v7
with:
script: |
const author = '${{ steps.check-contributor.outputs.author }}';
const isIssue = context.eventName === 'issues';
const number = isIssue ? context.payload.issue.number : context.payload.pull_request.number;
const welcomeMessage = `👋 **Welcome to the Claude Code Agents project, @${author}!**
Thank you for your ${isIssue ? 'issue submission' : 'pull request'}! We appreciate your interest in contributing to our collection of specialized subagents.
## 📋 Community Guidelines
Before we proceed, please take a moment to review our community standards:
- 📖 **[Code of Conduct](.github/CODE_OF_CONDUCT.md)** - Our community standards and behavioral expectations
- 🤝 **[Contributing Guidelines](.github/CONTRIBUTING.md)** - How to contribute effectively
- 💬 **[GitHub Discussions](https://github.com/${context.repo.owner}/${context.repo.repo}/discussions)** - For questions and general discussion
## 🛡️ Community Values
We maintain a **respectful, inclusive, and professional environment**. Our community does not tolerate:
- Hate speech, discrimination, or harassment
- Personal attacks or inflammatory language
- Spam, trolling, or off-topic content
- Any content that violates our Code of Conduct
## ✅ What Makes a Great Contribution
${isIssue ? `**For Issues:**
- Clear, specific problem descriptions
- Steps to reproduce (for bugs)
- Constructive feature requests with use cases
- Professional, respectful language` : `**For Pull Requests:**
- Well-documented changes
- Following existing code style
- Clear commit messages
- Addressing a specific issue or improvement`}
## 🚀 Next Steps
A maintainer will review your ${isIssue ? 'issue' : 'pull request'} soon. Please feel free to:
- Add any additional context if needed
- Respond to questions from maintainers
- Join our [Discussions](https://github.com/${context.repo.owner}/${context.repo.repo}/discussions) for general questions
Thank you for helping make this project better! 🎉`;
if (isIssue) {
await github.rest.issues.createComment({
owner: context.repo.owner,
repo: context.repo.repo,
issue_number: number,
body: welcomeMessage
});
} else {
await github.rest.pulls.createReview({
owner: context.repo.owner,
repo: context.repo.repo,
pull_number: number,
body: welcomeMessage,
event: 'COMMENT'
});
}
console.log(`Welcomed first-time contributor @${author}`);