task-tracker

タスクトラッカー

action-item-extractor スキルによって管理される、タスクリストの中心となる todos.md を管理します。 タスクが追加された後に、タスクの表示、更新、監視を行うには、このスキルを使用します。

設定

デフォルトのパス（環境に合わせて編集してください）：

TODOS_FILE: ~/todos.md

---

操作

1. 項目の一覧表示

未完了の ToDo を表示します。必要に応じて担当者で絞り込めます。

手順：

1. todos.md を読み込みます
2. ## Open の下にある - [ ] に一致するすべての行を抽出します
3. 担当者のフィルターが指定されている場合は、**{Owner}** を含む行のみを返します
4. 出力を次の形式にします：

   Open todos [for {Owner}]:
   1. [{Owner}] {Task} — due: {deadline} (source: {source})
   ...
   

5. 該当する項目がない場合：「未完了の ToDo はありません［{Owner} 向け］。」

使用例：

• 「未完了の ToDo をすべて表示」
• 「Alice がやるべきことは何ですか？」
• 「Bob のタスクを一覧表示」

---

2. 項目の完了

ToDo を完了済みにします。

手順：

1. todos.md を読み込みます
2. 番号（一覧表示の出力にあるもの）、担当者＋キーワード、またはタスクの正確なテキストで該当する項目を特定します
3. 複数の項目が該当して曖昧な場合は、候補を表示してユーザーに確認します
4. - [ ] を - [x] に変更し、_(completed: {today's date})_ を追加します
5. 行を ## Open から ## Done に移動します
6. 更新したファイルを書き込みます
7. 次のように確認します：「完了にしました：{task}」

使用例：

• 「Alice のデザインタスクを完了にして」
• 「項目 2 を完了して」
• 「完了：プロジェクト提案書」

---

3. 担当者別の照会

特定の人のすべての ToDo（未完了と完了済み）を表示します。

手順：

1. todos.md を読み込みます
2. ## Open と ## Done の両方から、**{Owner}** に一致するすべての行を抽出します
3. 出力を次の形式にします：

   Todos for {Owner}:
   
   Open:
   - {Task} (due: {deadline})
   
   Done:
   - {Task} (completed: {date})
   

4. 該当する項目がない場合：「{Owner} の ToDo は見つかりません。」

---

定期アラート

スケジュールされた実行のたびに、期限切れまたは期限が近いタスクを確認します。

手順：

1. todos.md を読み込みます
2. 具体的な期限が設定された未完了項目（TBD ではないもの）ごとに、次を確認します：
   • due date < today の場合：期限超過として通知します
   • due date <= today + 2 days の場合：期限間近として通知します
3. 該当する項目がある場合は、アラートを送信します：

   ⚠️ Task Alert:
   Overdue ({N}):
   - [{Owner}] {Task} — was due {date}
   Due soon ({N}):
   - [{Owner}] {Task} — due {date}
   

4. 該当する項目がない場合：アラートは不要です。何もせず終了します

ヒント： このスキルが定期的に実行されるようエージェントを設定すると、 手動で指示しなくても期限超過のアラートが自動的に送信されます。

---

エラー処理

• ファイルが見つからない場合： todos.md がまだ存在しないことをユーザーに通知します。action-item-extractor を実行するか、タスクを手動で追加するよう案内します
• 完了時に一致する項目が曖昧な場合： 該当する項目を表示し、どれを選ぶかユーザーに確認します
• 期限が設定されていない場合（すべて TBD）： スケジュールされたチェックでは、アラートを出さずに終了します
• todos.md の形式が不正な場合： ユーザーに通知し、クリーンなテンプレートで上書きするか、修復を試みるか確認します