Skip to content

chore: add CI, issue/PR templates, and CONTRIBUTING.md - #108

Merged
titanwings merged 1 commit into
mainfrom
chore/community-infra
Apr 15, 2026
Merged

chore: add CI, issue/PR templates, and CONTRIBUTING.md#108
titanwings merged 1 commit into
mainfrom
chore/community-infra

Conversation

@titanwings

Copy link
Copy Markdown
Owner

Summary

Set up community-facing infrastructure so future PRs (e.g. #106 Confluence collector) can be reviewed against a consistent bar.

Changes

  • .github/workflows/ci.yml — GitHub Actions CI
    • python -m compileall tools/ — catches syntax errors in every tool
    • python -m unittest discover -s tests -p 'test_*.py' — no-op until a `tests/` directory exists, then picks up everything automatically
    • Ruff lint job (non-blocking, || true) — surfaces style/quality hints without failing PRs while we adopt
    • Matrix over Python 3.9 and 3.11; triggers on push to main and on PRs
  • .github/PULL_REQUEST_TEMPLATE.md — bilingual EN/CN template with a testing checklist, secrets reminder, and doc-update prompt
  • .github/ISSUE_TEMPLATE/ — bug / feature / question templates + config.yml that disables blank issues and links to Discord and the skill gallery
  • CONTRIBUTING.md — branch naming, Conventional Commits, dev setup, test expectations, security rules (no secrets, 0600 perms on credential files), i18n expectations

Testing

  • Locally compiled with python -m compileall tools/ — passes
  • CI will run on this PR — that's the real test
  • Templates render correctly in GitHub preview (verified via raw file structure)

Notes for reviewer

  • The tests/ directory doesn't exist yet on main. The CI handles this gracefully (prints a message, doesn't fail). Once PR feat: add reviewer generators and English skill assets #103 or any future PR adds tests, discovery activates automatically.
  • Ruff is intentionally non-blocking for now. Flip || true to hard-fail once the codebase is clean.
  • Branch protection rules (require CI pass, require 1 approval) are a separate GitHub Settings change, not in this PR.

Set up the community-facing infrastructure a maintained OSS project needs:

- GitHub Actions CI: py_compile on tools/, unittest discover (no-op until
  tests/ exists), and a non-blocking ruff lint job. Runs on push to main
  and on pull_request, matrix over Python 3.9 and 3.11.
- Pull request template with bilingual EN/CN prompts, a testing checklist,
  and a security reminder about secrets.
- Issue templates for bug, feature, and question, plus a config.yml that
  disables blank issues and links to Discord and the skill gallery.
- CONTRIBUTING.md covering branch naming, commit style (Conventional
  Commits), dev setup, test expectations, security rules (no secrets,
  0600 perms on credential files), and docs/i18n expectations.

This is prep work so future PRs (e.g. #106 Confluence collector) can be
reviewed against a consistent bar.
@titanwings
titanwings merged commit c3e9d8c into main Apr 15, 2026
3 checks passed
@titanwings
titanwings deleted the chore/community-infra branch April 15, 2026 02:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant