# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

定期的なタスク - 定期的なタスク
-----------------------------------------

定期的なシステムは、期限が来ると自動的にタスクを作成します。
メンテナンス (ジョブを実行する) とは異なり、定期的では生成のみが行われます。
クロードまたはユーザーへのタスクのリマインダー。

ハンドラー: Hub/quirting.py
サービス: ハブ/_services/quirting/
GUI: なし (CLI のみ + /daemon ページに統合)
デーモン: はい (デーモンは 5 分ごとにチェックします - gui/daemon_service.py)


コマンド
-------

  bach --recurring              すべての繰り返しタスクを表示
  bach --recurring list         (エイリアス)
  bach --recurring check        期限のタスクを作成
  bach --recurring trigger ID   手動でタスクをトリガー
  bach --recurring done ID      完了としてマーク (last_run 更新)
  bach --recurring enable ID    タスクをアクティブ化
  bach --recurring disable ID   タスクを非アクティブ化


定義: 3 つのハンドラー システム
--------------------------------

  ┌─────────────────────────────┐
  │ 定期的 │
  ---------------------------------------------------------------------- ─--------------------------------------------------------┤
  │ リマインダーとしてタスクを作成します │
  │ 間隔ベース (日) │
  │ クロード/ユーザーが編集する場合 │
  │ ハンドラー: Hub/quiring.py │
  │ サービス: Hub/_services/quiring/ │
  │ GUI: なし (CLI のみ) │
  │ デーモン: はい (daemon_service.py 経由で 5 分ごとにチェック) │
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┘

  ┌─────────────────────────────┐
  │ メンテナンス (docs/help/maintenance.txt) │
  ---------------------------------------------------------------------- ─--------------------------------------------------------┤
  │ シェル/Python コマンドをオフに実行します │
  │ 時間制御 (cron/インターバル) │
  │ クロードの関与なしで │
  │ ハンドラー: Hub/daemon.py │
  │ サービス: gui/api/daemon_api.py + DB │
  │ GUI: /daemon (存在します) │
  │ デーモン: YES (独自プロセス) │
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┘

  ┌─────────────────────────────┐
  │ プロンプトジェネレーター (docs/help/prompt-generator.txt) │
  ---------------------------------------------------------------------- ─--------------------------------------------------------┤
  │ クロードセッションにプロンプトを送信します │
  │ 手動または自動 │
  │ エディタ付きテンプレートシステム │
  │ ハンドラ：（開発中） │
  │ サービス: Hub/_services/prompt_generator/ │
  │ GUI: /prompt-generator (計画中) │
  │ デーモン: はい (session_daemon.py) │
  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┘

いつ何に使うの?
----------------

  次の場合に繰り返しを使用します。
  - クロードは覚えておくべきだ
  - タスクにはインテリジェンス/分析が必要です
  - 柔軟なタイミング (次のセッション時)

  次の場合にメンテナンスを使用します。
  - スクリプトは自動的に実行される必要があります (バックアップ、スキャンなど)。
  - 知性や決断は必要ありません
  - 時間は重要です (例: 夜の 3:00)

  次の場合にプロンプト ジェネレーターを使用します。
  - クロードセッションは自動的に開始されます
  - プロンプトテンプレートを使用できます
  - 時限クロードの作業が必要です


現在定期的に発生しているタスク
------------------------

  ATI エージェントのタスク:
  ----------------
  1. self_check (14d)
     バッハのセルフチェック: SKILL.md とレッスンを確認してください

  2. オンボーディング_スキャン (7d)
     新しいツールを確認します: bach ati onboard --check

  3. code_quality (30d)
     コードの品質をチェックします: すべてのツールの c_method_analyzer

  システムタスク:
  -------------
  4. バックアップチェック (7d)
     BACH バックアップの確認: BACH バックアップのステータス

  5. メモリクリーンアップ (30日)
     メモリ アーカイブをチェックします: 古いエントリをアーカイブします

  6. 統合チェック (30日)
     追跡分析を実施する
     ワークフロー: スキル/ワークフロー/システム接続分析.md

  文書化タスク:
  ---------------------
  7. ロードマップ_レビュー (14d)
     ROADMAP.md のレビュー: 完了したタスクにマークを付け、優先順位を確認します

  8. wiki_author (21d)
     Wiki 作成者: エージェントの知識のギャップを特定して埋める
     ワークフロー: skill/workflows/wiki-author.md

  9. ヘルプ_フォレンジック (14d)
     フォレンジックの支援: 実際とターゲットを確認し、逸脱がある場合は修正します
     ワークフロー: スキル/ワークフロー/help-forensic.md

10. doc_freshness (60d)
      ドキュメントの鮮度: bach --maintain docs report


設定
-------------

  ファイル: Hub/_services/quirting/config.json

  タスクごとの形式:
  {
    "タスク名": {
      "有効": true、
      「間隔日」: 30、
      "target": "tasks"、// または "ati_tasks"
      "priority": "P3", // target=task のみ
      "priority_score": 50, // target=ati_tasks のみ
      "effort": "medium", // target=ati_tasks のみ
      "task_text": "説明...",
      "last_run": "2026-01-22T21:30:00"
    }
  }


デーモン統合
------------------

BACH デーモン サービス (gui/daemon_service.py) は自動的にチェックします
定期的なタスクの期限は 5 分ごとです。

さらに、以下を手動で確認することもできます。
- `bach --startup` は期限が迫っているタスクを表示します
- `bach --quiring check` はそれらを実際のタスクとして即座に作成します


新しい定期的なタスクを追加
--------------------------------

1。 config.json を編集します:
   Hub/_services/quirting/config.json

2.新しいエントリを追加します。
   "私のタスク": {
     "有効": true、
     「間隔日」: 14、
     "ターゲット": "タスク",
     "優先度": "P3",
     "task_text": "私のタスクについて説明してください"
   }

3.テスト:
   bach --recurring list


技術的な詳細
------------------

  ハンドラー: Hub/quirting.py
  サービス: Hub/_services/quirting/quirting_tasks.py
  構成: Hub/_services/quiring/config.json
  デーモン モジュール: gui/daemon_service.py (5 分ごとにチェック)

重要: 定期的なタスクは BACH デーモンによって自動的にチェックされます。
(5分ごと)。 「bach --quiring check」を使用した手動チェックは次のとおりです。



関連項目
----------

  bach --help wartung           メンテナンス ジョブ (シェル コマンド、GUI が利用可能)
  bach --help prompt-generator  プロンプト管理 (GUI 予定)
  bach --help tasks             タスク システム
  bach --help startup           セッションの開始 (期限のタスクを表示)
