Menu
记录 Agent 会话日志。捕获用户原始 prompt、LLM 理解摘要和执行上下文摘要，用于追溯和复盘。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
当你需要按用户 prompt 片段从本机 Codex CLI JSONL 会话里定位最近一次相关会话，并导出为可读的 user/assistant Markdown 对话稿时使用。
使用 draw.io CLI 绘制项目架构依赖图，支持中英文标签，导出 SVG/PNG/PDF 预览，并将图片插入 Markdown 文档。
管理和读取工作区目录文档。使用该技能可了解文件/目录用途、读取 agent 专用备注，或在创建/修改文件后更新文档。
自动工作工具箱入口。用于按需加载架构设计、重构迁移、质量门禁和会话留痕能力；默认只读取本入口，再根据任务打开对应 references 或下游 skill。
管理模块间语义层级依赖关系。注册模块、声明依赖方向、定义接口契约，支持环检测、跨层违规检查和并行开发分组。
用于大规模重构。冻结 old db 作为基线观察，使用 new db 持续建设新结构，并通过 migration_plan.md 管理旧模块到新模块的迁移设计、进度和退出条件。
| 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