work-log-codexlisted
Install: claude install-skill ValorVie/custom-skills
# 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`。
```bash
SKILL_DIR="$PWD/.codex/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` 補足未提交、研究、規劃中的工作
- `