work-log-codex

Work Log Codex

根據本機的 Codex 與 Claude Code session 紀錄，產生可讀、可保存的工作日誌。

When To Use

Use this skill when the user wants to:

• 針對 今天、昨天、本週 或自訂日期區間整理工作日誌
• 想知道某段時間做了哪些專案、主要交付與研究內容
• 想把對話紀錄與 git 歷史整理成可讀的 Markdown 日誌
• 想輸出到 docs/work-logs/ 或 Obsidian

Workflow

這個 skill 的最佳路徑不是單次摘要，而是 parser -> project-level AI summary -> final synthesis -> layered formatter。

Step 1: 解析時間範圍

支援：

• today
• yesterday
• this-week
• this-month
• YYYY-MM-DD
• YYYY-MM-DD YYYY-MM-DD

可選輸入：

• --project <name>：只看單一專案
• --output / --format：控制輸出方式

Step 2: 執行 parser

優先用 uv run python，失敗再 fallback python3。

SKILL_DIR="$PWD/.agents/skills/work-log-codex"
PYTHONPATH="$SKILL_DIR" uv run python -m wl_parser.work_log_parser \
  TIME_RANGE \
  [END_DATE] \
  --timezone "Asia/Taipei" \
  [--project "PROJECT"] \
  --claude-home "$HOME/.claude" \
  --codex-home "$HOME/.codex" \
  --emit-project-dir /tmp/wl_projects \
  > /tmp/wl_report.json \
  || PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.work_log_parser \
  TIME_RANGE \
  [END_DATE] \
  --timezone "Asia/Taipei" \
  [--project "PROJECT"] \
  --claude-home "$HOME/.claude" \
  --codex-home "$HOME/.codex" \
  --emit-project-dir /tmp/wl_projects \
  > /tmp/wl_report.json

Step 3: 逐專案 AI 摘要

不要直接把整份 /tmp/wl_report.json 全讀進上下文。優先讀：

• /tmp/wl_projects/manifest.json
• 每個 project bundle JSON
• prompts/project_summary.md

每個專案各做一次摘要：

• 優先從 git_commits 理解實際交付主題
• 用 session_summaries 補足未提交、研究、規劃中的工作
• session_hints 只當快速導覽，真正判讀以 session_summaries 為主
• 合併 related commits，不要逐 commit 轉寫
• 沒有 commit 時才寫成研究/探索
• Token 成本不是主要限制；必要時可以逐專案、多次呼叫 AI 做摘要，不要為了省 token 犧牲語意品質

將每個專案摘要暫存到 /tmp/wl_project_<name>.md。

Step 4: 生成最終摘要前段

讀取：

• /tmp/wl_report.json 的 summary
• 所有 /tmp/wl_project_<name>.md
• prompts/final_summary.md

產出 /tmp/wl_summary.md，內容必須只有：

• ### 當日總結
• ### 逐專案摘要

Step 5: formatter 組裝

預設輸出是 report + appendix 兩個檔案；debug 只有在明確要求時才產生。

主報告只保留：

• ### 當日總結
• ### 逐專案摘要
• ### 工時統計
• ### 每日摘要