Communityコーディング&開発github.com

dd3ok/WATCHLIST.md

リポジトリローカルの WATCHLIST.md に先送りのフォローアップチェックを記録するための軽量エージェントスキル。デーモンや cron は不要で、AIエージェント用の構造化された保留チェックメモのみを提供します。

WATCHLIST.md とは?

このスキルは、開発者やAIエージェントが後日確認すべきタスクやチェック項目を、リポジトリ内のWATCHLIST.mdファイルに構造化された形式で記録できるようにします。デーモンやcronジョブを必要としないため、オーバーヘッドが最小限で、プロジェクト管理の複雑さを軽減します。主なユースケースとしては、一時的なTODO、外部依存の確認、コードレビュー後のフォローアップ、またはAIエージェントが中断されたタスクを再開するためのマーカーなどが含まれます。このスキルは、Claude Code、Cursor、Codexなどの標準的なファイルシステムアクセスを備えた任意のAIエージェントプラットフォームと互換性があります。仕組みとしては、単一のWATCHLIST.mdファイルを管理し、AIエージェントが必要に応じて新しいエントリを追加したり、完了したエントリをチェックしたり、ファイルを更新したりできるようにします。このアプローチは、シンプルさを保ちながら、分散したチームや長期間のプロジェクトで見落としがちな重要なアクション項目を見逃さないようにします。

対応~Claude Code~Codex CLI~Cursor
npx skills add dd3ok/WATCHLIST.md

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

WATCHLIST.md は何をしますか?

リポジトリローカルの WATCHLIST.md に先送りのフォローアップチェックを記録するための軽量エージェントスキル。デーモンや cron は不要で、AIエージェント用の構造化された保留チェックメモのみを提供します。

概要

WATCHLIST.md は、プロジェクトルートに配置されるシンプルなマークダウンファイルで、保留中のチェックやフォローアップタスクをリストアップします。AIエージェントはこのファイルを参照して、次に行うべきアクションを判断できます。

使用方法

  1. プロジェクトのルートディレクトリに WATCHLIST.md を作成します(まだ存在しない場合)。

  2. 以下の形式でエントリを追加します:

    - [ ] 期限切れのAPIキーを確認する
    - [ ] プルリクエスト #42 のマージ後にテストを実行する
    - [ ] 依存関係の脆弱性レポートをレビューする
    
  3. AIエージェントに「ウォッチリストを確認して」と依頼すると、エージェントが WATCHLIST.md を読み取り、未解決の項目を提示します。

  4. 項目が完了したら、[x] に変更して完了を示します。

ルール

  • エントリはシンプルで実行可能に保つこと。
  • エントリには日付スタンプを付けてもよい(例:- [ ] 2025-01-15: 本番データベースのバックアップを検証する)。
  • AIエージェントは .gitignore に WATCHLIST.md が含まれていないことを確認する必要があります。
  • AIエージェントは、ファイルを操作する前に WATCHLIST.md の書式が壊れていないか検証する必要があります。

例

# ウォッチリスト

- [ ] 本番環境のログでエラーレートが上昇していないか確認する
- [x] フロントエンドの依存関係を更新する(完了)
- [ ] 2025-02-01: 新しいAPIエンドポイントのドキュメントをレビューする

注意事項

  • このスキルは、Claude Code、Cursor、Codex など、任意のAIエージェントと互換性があります。
  • デーモンやcronは必要ありません。ファイルベースのシンプルな仕組みです。
  • チーム全体で共有する場合は、変更をコミットしてプッシュすることを忘れないでください。

関連スキル