Skip to content

SKILL.md

Latest commit

 

History

History
147 lines (104 loc) · 4.35 KB

SKILL.md

File metadata and controls

147 lines (104 loc) · 4.35 KB
Raw
name digest-auto
description EpisodicRAG 健全性診断と階層推奨

digest-auto - 健全性診断と階層推奨スキル

EpisodicRAG システムの現在の状態を分析することで、 まだらボケ（未処理 Loop/プレースホルダー/欠番）を検出し、 生成可能なダイジェスト階層を判別するスキルです。 まだらボケの早期検出・予防のため、定期的に実行することを推奨します。

目次

用語説明

📖 パス用語（plugin_root / base_dir / paths）・ID桁数・命名規則は 用語集 を参照

実装時の注意事項

UI メッセージはコードブロックで囲む。 VSCode拡張では単一改行が空白に変換されるため、 対話型メッセージは三連バッククォートで囲む必要があります。

📖 共通の実装ガイドライン（パス検証、閾値検証、バリデーション、エラーハンドリング）は _implementation-notes.md を参照してください。

まだらボケとは

📖 まだらボケの定義・発生パターン・記憶定着サイクル・対策は 用語集 を参照

実行フロー

⚠️ 重要: 以下のTodoリストをTodoWriteで作成し、順番に実行すること

TodoWrite items:
1. システム状態取得 - digest_auto.pyを実行
2. 結果解釈 - JSONを解析して問題を特定
3. ユーザー報告 - テキストで状態を報告
4. 推奨アクション提示 - /digestや/digest {level}を推奨
Step 実行内容 使用スクリプト/処理
1 システム状態取得 python -m interfaces.digest_auto --output json
2 結果解釈 Claude が JSON を解析
3 ユーザー報告 Claude がテキストで報告
4 推奨アクション提示 /digest や /digest {level} を推奨

配置先: scripts/interfaces/digest_auto.py

CLI が返す状態と対応

digest_auto は設定読み込みから推奨アクション提示までを内部で完結させる。Claude が決めるのは、 返ってきた状態にどう応じるかだけ。

CLI が返す状態 推奨アクション
初期セットアップ未完了（config 不在） @digest-setup を実行
ShadowGrandDigest 未作成 @digest-setup を実行
未処理 Loop 検出 /digest を実行（即終了）
プレースホルダー検出 /digest を実行（即終了）
欠番検出（gaps） 不足ファイルの追加を案内（処理は継続）

出力例

status は error / warning / ok の 3 値。以下は各 1 例で、実際の構造は CLI 出力を そのまま読む。

error（即終了）

{
  "status": "error",
  "error": "Config file not found",
  "action": "Run @digest-setup"
}

warning（処理継続）

{
  "status": "warning",
  "issues": [
    {"type": "unprocessed_loops", "count": 1, "files": ["L00001"]}
  ],
  "recommendations": ["Run /digest to process unprocessed loops"]
}

ok（推奨アクション）

{
  "status": "ok",
  "issues": [],
  "generatable_levels": [
    {"level": "weekly", "current": 7, "threshold": 5, "ready": true}
  ],
  "recommendations": ["Run /digest weekly to generate Weekly Digest"]
}

テキスト出力（--output text）

python -m interfaces.digest_auto --output text
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 EpisodicRAG システム状態
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✅ 生成可能なダイジェスト

  ✅ Weekly (7/5 Loops)
     → `/digest weekly` で生成できます！

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

EpisodicRAG by Weave | GitHub