WATCHLIST.md は何をしますか?
リポジトリローカルの WATCHLIST.md に先送りのフォローアップチェックを記録するための軽量エージェントスキル。デーモンや cron は不要で、AIエージェント用の構造化された保留チェックメモのみを提供します。
概要
WATCHLIST.md は、プロジェクトルートに配置されるシンプルなマークダウンファイルで、保留中のチェックやフォローアップタスクをリストアップします。AIエージェントはこのファイルを参照して、次に行うべきアクションを判断できます。
使用方法
-
プロジェクトのルートディレクトリに
WATCHLIST.mdを作成します(まだ存在しない場合)。 -
以下の形式でエントリを追加します:
- [ ] 期限切れのAPIキーを確認する - [ ] プルリクエスト #42 のマージ後にテストを実行する - [ ] 依存関係の脆弱性レポートをレビューする -
AIエージェントに「ウォッチリストを確認して」と依頼すると、エージェントが
WATCHLIST.mdを読み取り、未解決の項目を提示します。 -
項目が完了したら、
[x]に変更して完了を示します。
ルール
- エントリはシンプルで実行可能に保つこと。
- エントリには日付スタンプを付けてもよい(例:
- [ ] 2025-01-15: 本番データベースのバックアップを検証する)。 - AIエージェントは
.gitignoreにWATCHLIST.mdが含まれていないことを確認する必要があります。 - AIエージェントは、ファイルを操作する前に
WATCHLIST.mdの書式が壊れていないか検証する必要があります。
例
# ウォッチリスト
- [ ] 本番環境のログでエラーレートが上昇していないか確認する
- [x] フロントエンドの依存関係を更新する(完了)
- [ ] 2025-02-01: 新しいAPIエンドポイントのドキュメントをレビューする
注意事項
- このスキルは、Claude Code、Cursor、Codex など、任意のAIエージェントと互換性があります。
- デーモンやcronは必要ありません。ファイルベースのシンプルな仕組みです。
- チーム全体で共有する場合は、変更をコミットしてプッシュすることを忘れないでください。