# Sessions > 一条命令出 session 现状 + ROI 全景 HTML（包装 cc_sessions.py index + regen_dev_roi.py，输出规范 /debrief 风 HTML，含 vault nav + KPI clickable + per-project 表）。用户说「列会话 / session 现状 / 会话 ROI / sessions / /sessions / 看下 session / 清理候选」时触发 - Skill: `zengtianli/sessions` (Agent Skill) - Install (CLI): `npx skillmds@latest add zengtianli/sessions` - Raw SKILL.md: https://api.skillmd.com/api/skills/zengtianli/sessions/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: zengtianli (https://skillmd.com/u/zengtianli) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/zengtianli/sessions --- # /sessions — Session 现状 + ROI 一站式 HTML ## 核心用途一站式查看 `~/.claude/projects/**/*.jsonl` 现状（数量、cwd、stale 程度、ROI），自动产规范富 HTML 给用户看。**不要手工写 session 清单**，走本 skill。 ## 执行 3 步 1. **刷索引**：`uv run python3 ~/Dev/tools/dev/scripts/tools/cc_sessions.py index` → 写 runtime 索引 session_index.json 到 ~/.claude/projects/（全 jsonl 扫一遍） 2. **生成 HTML**：`uv run python3 ~/Dev/tools/dev/scripts/tools/regen_dev_roi.py` → 重生 `~/Dev/wiki/handoffs/dev/dev-sessions-roi.html` 3. **打开**：`open ~/Dev/wiki/handoffs/dev/dev-sessions-roi.html` ## 不重复执行的判定若 `dev-sessions-roi.html` mtime < 5 分钟 **且** 无新 jsonl session 加入（`find ~/.claude/projects -name '*.jsonl' -newer dev-sessions-roi.html | head -1` 空）→ 跳过步骤 1+2，直接 `open`。 ## HTML 必含（验收点） per [[user-facing-output-is-html]] [[html-must-be-vault-citizen]] [[every-number-card-must-be-clickable]]： - **vault nav 顶栏** + 侧边 aside 入口（_index / handoffs / topics） - **KPI 卡 clickable**：session 总数、stale > 30d、top ROI、清理候选数 — 每个数字 `` 指向锚点 - **per-project 表**：cwd 路径 + session count + last_ts + topic（完整 36 位 UUID 可粘贴 `claude -r `） - **Top ROI 段**：按 turns × signal_density desc - **Stale 清理候选**：stale_days desc，列出可归档 - **底部 backlinks** + footer 时间戳 ## 验收 - audit dead link = 0 - `