---

name: dev-logs-guide description: ".dev-logsディレクトリの構造と活用方法。ライフログ、パイプライン実行、スキル使用状況の一元管理。「ログ確認」「.dev-logs」「パイプライン監視」などの作業に使う。" metadata: {"clawdbot":{"requires":{}}}

.dev-logs ガイド

けいたの開発活動を一元的にログ収集するディレクトリ。

ディレクトリ構造

~/.dev-logs/
├── .state/                    # パーサー状態管理
│   ├── openclaw-parser.json   # 処理済みセッション一覧
│   ├── codex-parser.json      # Codex処理状態
│   └── screen-capture-state.json
│
├── pipeline/                  # パイプライン実行ログ
│   ├── all.jsonl              # 全パイプラインの統合ログ
│   ├── scan-projects.jsonl    # プロジェクトスキャン
│   ├── scan-project-details.jsonl
│   ├── vitals-scan.jsonl      # Vitals健康診断
│   ├── daily-report-generate.jsonl
│   ├── daily-report-analyze.jsonl
│   └── competitor-ui-analysis.jsonl
│
├── screen-capture/            # OCRログ（日別）
│   └── YYYY-MM-DD.jsonl       # スクリーンキャプチャ+OCR結果
│
├── skill-usage/               # スキル使用状況
│   └── events.jsonl           # OpenClawスキル発火イベント
│
└── prompts/                   # (将来用)

データ形式

各ログファイルのJSONスキーマは references/data-formats.md を参照。

• pipeline/all.jsonl — パイプライン実行イベント（timestamp, pipeline, event, status等）
• screen-capture/YYYY-MM-DD.jsonl — OCRキャプチャ（timestamp, window, text）
• skill-usage/events.jsonl — スキル発火イベント（timestamp, skill, event, duration等）

環境変数

product-hubが参照する環境変数:

変数名	デフォルト	説明
PH_DEV_LOGS_DIR	~/.dev-logs	ベースディレクトリ
PH_OCR_LOG_DIR	.dev-logs/screen-capture	OCRログ
PH_PIPELINE_LOG_DIR	.dev-logs/pipeline	パイプラインログ

活用例

よく使うクエリは references/query-examples.md を参照。

• 今日のパイプライン実行状況
• エラーになったパイプライン
• スキル使用頻度
• 特定日のOCRログ検索

関連スキル

• lifelog-analyzer — OCRログ+セッションログを分析
• daily-report — 日報生成（HTML/MD）
• lifelog-feedback — フィードバックループ分析
• content-generator — コンテンツネタ抽出

生成元

• screen-capture: ~/Dev/product-hub/packages/screen-capture/capture.py
• pipeline: ~/Dev/product-hub/scripts/lib/pipeline-observability.js
• skill-usage: OpenClawスキル発火時に自動記録

⚠️ よくある落とし穴

• JSONL ファイルを通常の JSON としてパース: .jsonl は1行1JSONオブジェクトの形式であり、ファイル全体を JSON.parse() すると失敗する。jq -s で配列化するか、1行ずつパースすること
• パーサー状態ファイル（.state/）の手動編集: openclaw-parser.json 等の状態ファイルを手動で編集すると、ログの二重処理やスキップが発生する。状態リセットが必要な場合はファイル削除で初期化する
• OCRログの日付ズレ: screen-capture/YYYY-MM-DD.jsonl のファイル名はローカル日付だが、内部の timestamp はISO形式で記録されている場合がある。日付フィルタリング時はタイムゾーンを考慮すること
• パイプラインログのサイズ肥大: pipeline/all.jsonl は全パイプラインの統合ログで、際限なく増え続ける。定期的に古いエントリをアーカイブまたは削除する運用が必要