Pull Request Commenter

Usage

Create .github/commenter.yml

Backend:
  where:
    path:
      matches: "backend/**/*"
  body: |
    :wave: You've changed Backend code, please:

    - [ ] Do this
    - [ ] And this
    - [ ] And that

Frontend:
  where:
    path:
      matches: "frontend/**/*"
  body: |
    :wave: You've changed Frontend code, please:

    - [ ] Do this
    - [ ] And this
    - [ ] And that

The keys are ignored, and for your own organizational use. We will find the first stanza where the PR's changed files matches any of the given paths and add a comment with the given body.

Create a Workflow

name: Checklists

on:
  pull_request:
    types: [opened]

jobs:
  comment:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/commenter@v1

Inputs

See action.yml.

Permissions

Running this action requires the following permissions:

permissions:
  contents: read
  pull-requests: write

These are required to be explicitly set for repositories with restricted default access for workflows or to allow a workflow run triggered by Dependabot pull requests, which are run as if they are from a forked repository and use a read-only GITHUB_TOKEN.

Additional Options

You can also match based on specific file changes by supplying the additions_or_deletions where-clause configuration key.

For example, if you wanted to comment on any changes that contain the word "unsafe" you could supply a YAML configuration like the following

UnsafeMentionedInCode:
  where:
    path:
      matches: "backend/**/*.hs"
    additions_or_deletions:
      contain:
        - unsafe
  body: |
    :wave: Hi, I see a mention of "unsafe" in Haskell code. If you removed it,
    good going! If you added it, please consider finding a safer alternative!

Use where.author.any to only comment on PRs that authored by specific users, and where.labels.any to only comment when specific labels are present. Keep in mind that all where conditions must be satisfied for a comment to be made:

CommentOnAutomatedUpdate:
  where:
    path:
      matches: "*/**/yarn.lock"
    author:
      any:
        - dependabot[bot]
    labels:
      any:
        - Frontend
  body: |
    This is an automated update to the frontend lockfile. Please verify the
    integrity of the packages being updated.

Reading the Comment Body from a File

If body is omitted, a file named .github/commenter/{name}.md is read from the default branch for the comment contents. The .github/commenter/ prefix can be changed via inputs.body-file-prefix. The complete path, or just the name part, can be specified via the body-file and body-file-name attributes of the configuration, respectively.

Acknowledgements

This action was highly inspired by (and began as a copy of) @actions/labeler.

---

LICENSE | CHANGELOG