SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场work-log-claude

work-log-claude

办公与效率

查看项目

更新于 10-16 09:19

技能介绍

用途

Work Log Claude 用于根据 AI 辅助工具（Claude Code / Codex）的对话纪录与 git 历史，自动产生具有语义摘要的工作日志。适合需要回顾每日工作、整理週报或即时查询工作内容的开发者。

主要能力

  1. 时间范围查询：支援 today、yesterday、this-week、this-month 或指定 YYYY-MM-DD 日期，也可用两个日期指定区间。
  2. 专案过滤：可通过 --project <name> 只统计指定专案。
  3. 多种输出模式：--output 可选 terminal、file、obsidian、all，预设为 all。
  4. AI 摘要：由执行 skill 的 Claude Code 自身产生，不呼叫外部 API。
  5. Git 资料整合：每个专案最多收集 50 笔 commit，使用 --stat 而非完整 diff。
  6. 工时报表：产生工时统计与每日表格。

使用方式

指令格式： /work-log-claude <时间范围> [结束日期] [--project <name>] [--output <mode>]

范例： /work-log-claude today /work-log-claude yesterday --output terminal /work-log-claude this-week --project qdm-base /work-log-claude 2026-03-01 2026-03-11 --output file

执行流程

Step 1：读取设定 读取 skill 目录下的 config.yaml，取得时区（预设 Asia/Taipei）、输出目录（预设 docs/work-logs）、Obsidian vault 路径、Obsidian 子资料夹、预设输出模式（预设 all）、claude_home（预设 ~/.claude）、codex_home（预设 ~/.codex）。若设定档不存在则使用预设值。

Step 2：解析参数 提取 TIME_RANGE（必填）、END_DATE（可选）、--project 与 --output。

Step 3：执行 Parser 用 Bash 执行 Python parser，产生含 git 资料的 JSON： SKILL_DIR="$HOME/.claude/skills/work-log-claude" PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.work_log_parser
TIME_RANGE
[END_DATE]
--timezone "TIMEZONE"
[--project "PROJECT"]
--claude-home "$HOME/.claude"
--codex-home "$HOME/.codex"
2>/dev/null > /tmp/wl_report.json

Step 4：AI 摘要 读取 /tmp/wl_report.json，关注 projects（short_name、git_commits、duration_minutes、session_count）与 summary（total_duration_minutes、project_count）栏位。读取 prompts/summarize.md，依模板产生摘要并写入 /tmp/wl_summary.md。

Step 5：格式化并输出 terminal 模式： SKILL_DIR="$HOME/.claude/skills/work-log-claude" PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.formatters terminal < /tmp/wl_report.json > /tmp/wl_formatted.md 依序显示 AI 摘要与格式化内容（工时统计 + 每日表格）。

file 模式： FILENAME="YYYY-MM-DD.md" # 或 YYYY-MM-DD--YYYY-MM-DD.md 对范围查询 OUTPUT_PATH="docs/work-logs/$FILENAME" PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.formatters full_report < /tmp/wl_report.json > /tmp/wl_formatted.md 组合摘要与格式化内容写入 $OUTPUT_PATH，使用 wl_formatted.md 的标题行，不重复。

obsidian 模式： OBSIDIAN_PATH="$OBSIDIAN_VAULT/$OBSIDIAN_FOLDER/YYYY-MM-DD.md" mkdir -p "$(dirname "$OBSIDIAN_PATH")" PYTHONPATH="$SKILL_DIR" python3 -m wl_parser.formatters obsidian < /tmp/wl_report.json > /tmp/wl_formatted.md 组合 frontmatter + AI 摘要 + formatted 内容写入 $OBSIDIAN_PATH。

all 模式：依序执行 terminal → file → obsidian，可重用同一份 /tmp/wl_report.json。

Step 6：回报结果 告知使用者终端摘要已显示、Markdown 档已写入路径、Obsidian 笔记已写入路径。

适用场景

  • 每日工作回顾
  • 每週工作报表整理
  • 即时查询某段时间的工作内容
  • 依专案统计工时与 commit
  • 将工作日志输出到文件或 Obsidian

限制与注意事项

  • 首次使用需确认 config.yaml 的 obsidian_vault 路径正确。
  • Codex 支援仅整合 session thread 标题，不解析 SQLite。
  • 所有时间以 config.yaml 的 timezone 显示，预设 Asia/Taipei（UTC+8）。
  • Git 资料每个专案最多收集 50 笔 commit，使用 --stat 而非完整 diff。
  • AI 摘要由执行 skill 的 Claude Code 自身产生，不呼叫外部 API。
  • 其余如价格、平台支援等资讯暂未提供。