agentsclimarketplace

Orbit session diary

Skill codingSamss/all-my-ai-needs/platforms/claude/skills/orbit-session-diary

Claude Code + Codex 双平台 AI dotfiles：统一管理 skills/agents/hooks，并一键同步到 ~/.claude 与 ~/.codex。

Install
npx -y skills add codingSamss/all-my-ai-needs --skill orbit-session-diary

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 11 stars11 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use local Codex/Claude JSONL logs as evidence, then produce a human-written daily diary summary and write it into Obsidian. Keep directory filtering (configurable per-project exclude list) and avoid mechanical script-style output.

SKILL.md

5.0 KB, as published. Nobody here has run it

Orbit Session Diary Skill

把当天 Codex + Claude 会话日志（jsonl）作为证据输入，供助手进行人工汇总并直接写入日记正文。重点是“人写总结”，不是脚本拼装内容。

Script Path

CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
SCRIPT="$CODEX_HOME/skills/orbit-session-diary/scripts/session_diary.py"

Default Behavior

  1. 自动读取当天会话：
    • ~/.codex/sessions/YYYY/MM/DD/*.jsonl
    • ~/.claude/projects/**/*.jsonl
  2. 排除目录在 references/excludes.json 配置（真实项目名由本地填写，不入仓）。
  3. 默认日记路径为：01_日记/YYYY-MM/YYYY-MM-DD.md（按月份归档）。
  4. 若用户未显式提供路径，默认写入上述配置路径，不需要二次询问路径确认。
  5. 先运行脚本提取“原始会话索引”（output-mode=evidence），索引里必须包含 session_id / cwd / jsonl 文件路径 / 原话片段。
  6. 助手必须回看关键 jsonl 原文后再人工归纳，直接写入日记正文（主线、主题聚合、结果汇总、关联项目）。
  7. 自动区块 write-auto 仅用于附录或对账，不能替代正文，也不能用来替代原始会话回看。

最终产出（强制）

调用本 skill 的最终交付必须是“已写入日记正文”的人工总结，格式要有叙事感与关联性，不是日志拼接。

正文结构模板

# YYYY-MM-DD 周X

> 今日主线：一句话说明当天主推进线。

## 今天做了什么
- [x] 3-6 条关键完成项（写结果，不写操作细枝末节）

## 主题聚合（核心）
### 主题 A：...
- 做了什么：...
- 输出了什么：...
- 得到什么结果：...
- 来源（可选）：...

### 主题 B：...
...

## 结果汇总
- 2-4 条“结果/影响/下一步”结论句

## 关联项目
- [[项目A]]
- [[项目B]]

质量约束

  • 禁止把脚本 evidence 区块原样粘贴为正文。
  • 禁止正文堆命令流水账、绝对路径列表、工具调用明细。
  • 禁止使用“关键词标签/主题分布”直接驱动正文结论。
  • 主题必须体现“决策 -> 动作 -> 结果”的闭环，而不是平铺事件。
  • 写作前优先对比同周日记风格，保持语气与结构连续。
  • 写作前必须执行“模板对齐检查”：读取目标月份最近 2-3 篇日记与 01_日记/_日记模板.md，确定 frontmatter 字段集合、章节命名与 callout 形式。
  • 若目标目录已有稳定样式，正文结构必须沿用该样式，不得擅自切换为本 skill 示例模板结构。
  • 自动区块只作证据附录，可保留但应简洁，不抢正文。
  • 写作前先看原始会话索引，并至少抽查每条主线 1 个 jsonl 文件。
  • 当天 涉及目录 >= 2 时，正文必须至少覆盖 2 条不同目录主线。
  • 若出现单目录占比过高，正文必须补写被遗漏目录/主题，不得只围绕当前会话。
  • 主题中出现具体知识库对象（如论文名/专题名/栏目名）时，必须补“来源”：
    • 优先 [[知识库文档名]]
    • 必要时补充相对路径（如 03_研究/...、05_资讯/...）
  • 写作后必须执行“交付门禁”：逐项核对 frontmatter 字段、标题层级、段落命名；任一不一致必须先修正再交付。

Commands

1) 提取当天证据（默认，不写文件）

python3 "$SCRIPT" --date "$(date +%F)"

2) 兼容旧参数（已废弃，等同默认行为）

python3 "$SCRIPT" --date "$(date +%F)" --dry-run

3) 仅在明确要求时写入自动区块

python3 "$SCRIPT" --date "$(date +%F)" --output-mode write-auto

4) 指定日期

python3 "$SCRIPT" --date 2026-02-26

5) 自定义 Vault 根目录

python3 "$SCRIPT" \
  --vault-root "$OBSIDIAN_VAULT_ROOT" \
  --date 2026-02-26

6) 调整数据来源

python3 "$SCRIPT" --sources codex
python3 "$SCRIPT" --sources claude
python3 "$SCRIPT" --sources codex,claude

Notes

  • 若用户明确要求“只总结某几个目录”，优先更新 references/excludes.json 后再执行。
  • 若用户指定不同日记区块标题，可用 --section-title 覆盖默认值 会话总结（自动）。
  • 日记正文必须由助手人工汇总生成，禁止直接复制脚本证据包到正文。
  • 同步写作时要参考同周其他日期风格，确保关联性与叙事连续性。
  • 若通过终端改动 .md，修改后需 touch "<file>"（路径含空格时必须加引号）触发 Obsidian 感知刷新。
  • 若用户反馈“写偏了”，先判断是成文偏差还是 evidence 偏差，再反向更新 skill 规则。
  • 如用户要求高准确模式，默认走“逐条 jsonl 回看 + 模板写作”，不再依赖自动分类统计。

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.