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 只有在明確要求時才產生。

主報告只保留：

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

附錄只保留：

• ### 專案證據附錄
• 每個專案的狀態、commit 證據、代表檔案、必要補充

debug 才包含：

• ### Token 消耗
• ### 工具使用
• ### Commit 明細
• ### Session 明細
• ### Codex Sessions

若要直接用 formatter CLI：

SKILL_DIR="$PWD/.agents/skills/work-log-codex"
PYTHONPATH="$SKILL_DIR" uv run python -m wl_parser.formatters report --summary-file /tmp/wl_summary.md < /tmp/wl_report.json > /tmp/wl_report.md \
  || PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.formatters report --summary-file /tmp/wl_summary.md < /tmp/wl_report.json > /tmp/wl_report.md

PYTHONPATH="$SKILL_DIR" uv run python -m wl_parser.formatters appendix < /tmp/wl_report.json > /tmp/wl_appendix.md \
  || PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.formatters appendix < /tmp/wl_report.json > /tmp/wl_appendix.md

Step 6: 寫檔與回報

預設輸出到：

• 單日：docs/work-logs/YYYY-MM-DD.md
• 區間：docs/work-logs/YYYY-MM-DD--YYYY-MM-DD.md
• 附錄：docs/work-logs/YYYY-MM-DD.appendix.md 或 docs/work-logs/YYYY-MM-DD--YYYY-MM-DD.appendix.md
• Debug：docs/work-logs/YYYY-MM-DD.debug.md 或 docs/work-logs/YYYY-MM-DD--YYYY-MM-DD.debug.md

回覆使用者時：

• 先給 ### 當日總結 與 ### 逐專案摘要 的精華
• 再告知 report 與 appendix 的寫入路徑
• 不要先丟工具統計或 session 明細；這些只放到 debug

Commands

快速產出檔案（deterministic fallback，適合測試；最佳品質仍用上面的多段 AI 流程）：

uv run python .agents/skills/work-log-codex/scripts/generate_work_log.py --range today \
  --mode report+appendix \
  || python3 .agents/skills/work-log-codex/scripts/generate_work_log.py --range today

自訂日期區間：

uv run python .agents/skills/work-log-codex/scripts/generate_work_log.py \
  --range 2026-03-02 \
  --end-date 2026-03-11 \
  --mode report+appendix \
  || python3 .agents/skills/work-log-codex/scripts/generate_work_log.py \
  --range 2026-03-02 \
  --end-date 2026-03-11

Output Rules

• 優先做「給人看的工作日誌」，不是稽核報告
• 主報告只放摘要、統計與每日摘要；證據另放 appendix，audit 另放 debug
• git_commits 是完成項目的主證據，session_hints 是語意補充
• 如果沒有 commit，不要硬寫成交付，但要先檢查 session_summaries 能不能支撐更具體的研究/規劃主題
• 每個專案摘要以條列為主，控制在約 500 字內
• 除非使用者要求，回覆時不要先展開 Token 消耗 或 工具使用

References

• Read prompts/project_summary.md before做逐專案摘要
• Read prompts/final_summary.md before做總結段落
• Read references/sources.md when changing ingestion behavior
• Read references/report-schema.md when changing report layout