From 12f7037ca430b25e05df84f0ca1c92de3e6d40c9 Mon Sep 17 00:00:00 2001 From: kqito <29191111+kqito@users.noreply.github.com> Date: Mon, 22 Sep 2025 11:48:47 +0900 Subject: [PATCH 1/3] chore: format --- README-ja.md | 16 ++++++++-------- README.md | 4 ++-- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/README-ja.md b/README-ja.md index 5e48953..4df3000 100644 --- a/README-ja.md +++ b/README-ja.md @@ -1,15 +1,15 @@ # reminder-lint -`reminder-lint`はあらゆる言語や設定ファイルに対応した、コードリマインドツールです。 +`reminder-lint`はあらゆる言語や設定ファイルに対応した、コードリマインドツールです。 -[GitHub Actionsで使用する](https://github.com/CyberAgent/reminder-lint#GitHub-Actions) +[GitHub Actionsで使用する](https://github.com/CyberAgent/reminder-lint#GitHub-Actions) [ローカル環境にインストールする](https://github.com/CyberAgent/reminder-lint#Install) ## コンセプト -`reminder-lint`は、コード上のTODOコメントを消し去ることを目標に開発されています。 -コードを書きながら、後回しにしたい処理には通常TODOコメントを残しますが、`reminder-lint`では規約に沿ったコメントを残すことで、時間が経過してもTODOコメントの消し忘れに気づくことができます。 +`reminder-lint`は、コード上のTODOコメントを消し去ることを目標に開発されています。 +コードを書きながら、後回しにしたい処理には通常TODOコメントを残しますが、`reminder-lint`では規約に沿ったコメントを残すことで、時間が経過してもTODOコメントの消し忘れに気づくことができます。 ## コメントのSyntax -デフォルトでは、`reminder-lint`はカレントディレクトリ配下のファイルを再帰的に操作し、正規表現`remind:\W?`にマッチする行を探索します。 +デフォルトでは、`reminder-lint`はカレントディレクトリ配下のファイルを再帰的に操作し、正規表現`remind:\W?`にマッチする行を探索します。 正規表現にマッチした行のうち`%Y/%m/%d`表記にマッチする日付を探し、記述された日付が現在時刻を超過している場合に，終了コード1とともにプロセスを終了します。 具体的には、TODOコメントの代わりに、以下のようにコメントを記述します。 ```rust @@ -87,7 +87,7 @@ jobs: uses: CyberAgent/reminder-lint@0.1.2 with: args: run - + - name: Notify if: ${{ steps.run.outputs.stdout != '' }} uses: slackapi/slack-github-action@v2.0.0 @@ -116,7 +116,7 @@ jobs: ``` ## カスタマイズ -チームによっては、リマインドコメントの記法を変更したり、時刻単位でのリマインドタイミングを指定したいケースが想定されます。 +チームによっては、リマインドコメントの記法を変更したり、時刻単位でのリマインドタイミングを指定したいケースが想定されます。 `reminder-lint`は設定ファイルをサポートしており、これらの記法をカスタマイズして利用することが可能です。 `init`を実行すると、`remind.yml`ファイルや`.remindignore`ファイルが作成されます。 @@ -160,7 +160,7 @@ if perfect_feature_enabled { ## TODOからのマイグレーション -既にあるTODOコメントを処理していくために、`reminder-lint`を利用して段階的にコードベースのTODOの削除を進めることができます。 +既にあるTODOコメントを処理していくために、`reminder-lint`を利用して段階的にコードベースのTODOの削除を進めることができます。 1. 最初は、`comment_regex: (?i)TODO`を設定し、既存のTODOコメントをリマンド対象にします。 2. 日付が含まれていないTODOコメントをリマインドするか、プロジェクトによって設定ファイルで挙動を変更します(`remind_if_no_date`)。 3. 削除したいTODOのリマインド日を決めて、TODOコメントに日付を含めるように修正します。 diff --git a/README.md b/README.md index 7411a94..aca5cd1 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # reminder-lint `reminder-lint` is a code reminder tool that supports all languages and configuration files. -[Use with GitHub Actions](https://github.com/CyberAgent/reminder-lint#GitHub-Actions) +[Use with GitHub Actions](https://github.com/CyberAgent/reminder-lint#GitHub-Actions) [Install in local environment](https://github.com/CyberAgent/reminder-lint#Install) ## Concept @@ -88,7 +88,7 @@ jobs: uses: CyberAgent/reminder-lint@0.1.2 with: args: run - + - name: Notify if: ${{ steps.run.outputs.stdout != '' }} uses: slackapi/slack-github-action@v2.0.0 From 9fe95e3f92a26e0c74ed4d4e630a28fbdfce5a5b Mon Sep 17 00:00:00 2001 From: kqito <29191111+kqito@users.noreply.github.com> Date: Mon, 22 Sep 2025 11:48:56 +0900 Subject: [PATCH 2/3] chore: update version of reminder-lint --- README-ja.md | 4 ++-- README.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README-ja.md b/README-ja.md index 4df3000..8bdd9a0 100644 --- a/README-ja.md +++ b/README-ja.md @@ -60,7 +60,7 @@ jobs: uses: actions/checkout@v4 - name: Run - uses: CyberAgent/reminder-lint@0.1.2 + uses: CyberAgent/reminder-lint@latest # ハッシュバージョンで固定することを推奨します with: args: run ``` @@ -84,7 +84,7 @@ jobs: - name: Run id: run continue-on-error: true - uses: CyberAgent/reminder-lint@0.1.2 + uses: CyberAgent/reminder-lint@latest # ハッシュバージョンをピン留めすることを推奨します with: args: run diff --git a/README.md b/README.md index aca5cd1..301d402 100644 --- a/README.md +++ b/README.md @@ -61,7 +61,7 @@ jobs: uses: actions/checkout@v4 - name: Run - uses: CyberAgent/reminder-lint@0.1.2 + uses: CyberAgent/reminder-lint@latest # Recommended to specify with a full-length commit SHA with: args: run ``` @@ -85,7 +85,7 @@ jobs: - name: Run id: run continue-on-error: true - uses: CyberAgent/reminder-lint@0.1.2 + uses: CyberAgent/reminder-lint@latest # Recommended to specify with a full-length commit SHA with: args: run From 6c95f9cd4abaefa2abb62246aea4bd2148d315b8 Mon Sep 17 00:00:00 2001 From: kqito <29191111+kqito@users.noreply.github.com> Date: Mon, 22 Sep 2025 11:59:28 +0900 Subject: [PATCH 3/3] feat: describe validate subcommand --- README-ja.md | 30 ++++++++++++++++++++++++++++++ README.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 61 insertions(+) diff --git a/README-ja.md b/README-ja.md index 8bdd9a0..404cf9f 100644 --- a/README-ja.md +++ b/README-ja.md @@ -158,6 +158,36 @@ if perfect_feature_enabled { ただし、フォーマットを複雑にするほど、フォーマットに則っていないコメントが検査が漏れる可能性があるため、できるだけシンプルなフォーマットで運用することを推奨します。 +## リマインドコメントのバリデーション +`reminder-lint`はリマインドコメントに対してバリデーションを行うことができます。 + +例えば、`remind.yml`を以下のように設定することで、日付のフォーマットとアサインされたユーザー名のフォーマットを必須としてバリデーションすることが可能です。 + +```yml +comment_regex: remind:.* +search_directory: . +trigger: + datetime: "%Y/%m/%d" +validate: + datetime: + format: "%Y/%m/%d" + assignee: + format: "@(kqito|arabian9ts|dora1998)" +``` + +この状態で `reminder-lint validate` を実行すると、期待するフォーマットに則っていないリマインドコメントが検出され、終了コード1でプロセスが終了します。 + +```shell +./main.go:11 // remind: hoge: missing date and assignee +Missing `assignee` format: @(kqito|arabian9ts|dora1998) +Missing `datetime` format: %Y/%m/%d + +./main.go:14 // remind: 2024/05/02: missing assginee +Missing `assignee` format: @(kqito|arabian9ts|dora1998) + +./main.go:17 // remind: @arabian9ts missing date +Missing `datetime` format: %Y/%m/%d +``` ## TODOからのマイグレーション 既にあるTODOコメントを処理していくために、`reminder-lint`を利用して段階的にコードベースのTODOの削除を進めることができます。 diff --git a/README.md b/README.md index 301d402..ce265b2 100644 --- a/README.md +++ b/README.md @@ -159,6 +159,37 @@ if perfect_feature_enabled { However, the more complex the format, the more likely it is that non-conforming comments will be missed during inspection. Therefore, it is recommended to use the simplest format possible. +## Validation of Reminder Comments +`reminder-lint` can validate reminder comments. + +For example, by configuring `remind.yml` as follows, you can validate the date format and assigned user name format as mandatory. + +```yml +comment_regex: remind:.* +search_directory: . +trigger: + datetime: "%Y/%m/%d" +validate: + datetime: + format: "%Y/%m/%d" + assignee: + format: "@(kqito|arabian9ts|dora1998)" +``` + +When you run `reminder-lint validate` in this state, reminder comments that do not follow the expected format will be detected, and the process will terminate with exit code 1. + +```shell +./main.go:11 // remind: hoge: missing date and assignee +Missing `assignee` format: @(kqito|arabian9ts|dora1998) +Missing `datetime` format: %Y/%m/%d + +./main.go:14 // remind: 2024/05/02: missing assginee +Missing `assignee` format: @(kqito|arabian9ts|dora1998) + +./main.go:17 // remind: @arabian9ts missing date +Missing `datetime` format: %Y/%m/%d +``` + ## Migration from pure TODOs You can use `reminder-lint` to gradually remove TODOs from your codebase that already exist. 1. Initially, set `comment_regex: (?i)TODO` to make existing TODO comments a reminder target.