work-log-codex

Work Log Codex

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

使用時機

Use this skill when the user wants to:

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

流程

這個 skill 的最佳路徑是 有界 parser -> 專案層任務摘要 -> 最終整合 -> 分層 formatter。

1. 解析時間範圍

支援：

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

可選輸入：

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

2. 執行有界 parser

使用 uv Python 3.14。parser 會在 stderr 顯示讀取與分析進度；stdout 只輸出 JSON。 在共用主機上一次只跑一個 parser。多個相鄰週次使用一個合併日期範圍，完成後再分週整理， 不要平行掃描同一批工作階段。

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

資料收集器只保留日期範圍內事件，並壓縮分析所需的 raw 欄位。若 stderr 長時間停在同一 階段、超出目前任務的時間或記憶體門檻，停止該次執行並保留量測，不要以多個 parser 重試。

3. 逐專案摘要

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

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

每個專案各做一次摘要，將相關 commit 與工作階段合併成 2 至 5 個任務。每個任務固定使用：

- **一行重點：** <一句可獨立閱讀的工作重點>
  - **重點脈絡：** <300 字以內，說明起因、處理、結果與證據邊界>
  - **來源：** <正式文件路徑及／或 repo@commit>

摘要規則：

• 優先從 git_commits 理解實際交付主題
• 用 session_summaries 補足未提交、研究、規劃中的工作
• session_hints 只當快速導覽，真正判讀以 session_summaries 為主
• 合併 related commits，不要逐 commit 轉寫
• 沒有 commit 或正式文件時，明確標成研究／規劃，來源寫「工作階段摘要（無 Git commit）」
• 來源必須直接支持相鄰主張；不要把原始 session JSONL 當成正式完成證據
• 每段重點脈絡以 Unicode 字元數量測，不超過 300 字
• Token 成本不是主要限制；必要時可以逐專案、多次呼叫 AI 做摘要，不要為了省 token 犧牲語意品質

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

4. 生成最終摘要前段

讀取：

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

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

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