Menü
记录 Agent 会话日志。捕获用户原始 prompt、LLM 理解摘要和执行上下文摘要，用于追溯和复盘。
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fügen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prüfen und installieren.
Basierend auf der SOC-Berufsklassifikation
| name | session-log |
| description | 记录 Agent 会话日志。捕获用户原始 prompt、LLM 理解摘要和执行上下文摘要，用于追溯和复盘。 |
基于 Markdown 文件 + SQLite 双轨存储的 Agent 会话日志工具。
.md 文件写入 docs/session-logs/（人类可读、可 Git 追踪）。docs/session_log.db（程序化检索）。sync 命令重建 DB。start 记录用户的原始 prompt 和 LLM 对需求的理解。finish 补充执行上下文摘要、涉及的文件和最终状态。show 查看 MD 原文，list/search 从 DB 快速检索。sync 将 MD 变更同步到 DB。每个 session 生成一个 docs/session-logs/<session_id>.md，结构如下：
---
session_id: 20260314-a34418a4
status: completed
tags: refactor,modular
started_at: 2026-03-14T00:59:20
finished_at: 2026-03-14T01:05:30
---
# Session: 20260314-a34418a4
## Prompt
帮我把 visualization.py 拆分成模块化结构
## Understanding
用户希望将 visualization.py 按职责拆分为独立子模块
## Summary
创建了 chart_builder.py, layout_engine.py, theme_manager.py 三个模块
## Related Files
- `src/chart_builder.py`
- `src/layout_engine.py`
所有操作通过 session_log.py 脚本完成。
创建 MD 文件并同步到 DB，返回 session_id：
python3 .agents/skills/session-log/scripts/session_log.py start \
--prompt "用户的原始输入" \
--understanding "LLM 对 prompt 的简要理解" \
--tags "refactor,modular"
更新 MD 文件的摘要和状态，同步到 DB：
python3 .agents/skills/session-log/scripts/session_log.py finish <session_id> \
--summary "执行上下文摘要" \
--files "src/a.py,src/b.py" \
--status completed
优先展示 MD 原文，无 MD 文件时回退到 DB：
python3 .agents/skills/session-log/scripts/session_log.py show <session_id>
python3 .agents/skills/session-log/scripts/session_log.py list --limit 10
按标签、状态、时间范围或关键词过滤：
python3 .agents/skills/session-log/scripts/session_log.py search \
--tag "refactor" --status completed --since "2026-03-01"
手动编辑 MD 文件后，重新解析并更新 DB：
python3 .agents/skills/session-log/scripts/session_log.py sync
当你需要按用户 prompt 片段从本机 Codex CLI JSONL 会话里定位最近一次相关会话，并导出为可读的 user/assistant Markdown 对话稿时使用。
使用 draw.io CLI 绘制项目架构依赖图，支持中英文标签，导出 SVG/PNG/PDF 预览，并将图片插入 Markdown 文档。
管理和读取工作区目录文档。使用该技能可了解文件/目录用途、读取 agent 专用备注，或在创建/修改文件后更新文档。
自动工作工具箱入口。用于按需加载架构设计、重构迁移、质量门禁和会话留痕能力；默认只读取本入口，再根据任务打开对应 references 或下游 skill。
管理模块间语义层级依赖关系。注册模块、声明依赖方向、定义接口契约，支持环检测、跨层违规检查和并行开发分组。
用于大规模重构。冻结 old db 作为基线观察，使用 new db 持续建设新结构，并通过 migration_plan.md 管理旧模块到新模块的迁移设计、进度和退出条件。