All-my-ai-needs orbit-session-diary

Use local Codex/Claude JSONL logs as evidence, then produce a human-written daily diary summary and write it into Obsidian. Keep directory filtering (for example rag-flow/rag-recall) and avoid mechanical script-style output.

install

source · Clone the upstream repo

git clone https://github.com/codingSamss/all-my-ai-needs

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/codingSamss/all-my-ai-needs "$T" && mkdir -p ~/.claude/skills && cp -r "$T/platforms/hermes/skills/note-taking/orbit-session-diary" ~/.claude/skills/codingsamss-all-my-ai-needs-orbit-session-diary-583967 && rm -rf "$T"

manifest: platforms/hermes/skills/note-taking/orbit-session-diary/SKILL.md

source content

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

自动读取当天会话：

```
~/.codex/sessions/YYYY/MM/DD/*.jsonl
```
```
~/.claude/projects/**/*.jsonl
```

默认排除

rag-flow

rag-recall

（可在

references/excludes.json

扩展）。

默认日记路径为：
```
01_日记/YYYY-MM/YYYY-MM-DD.md
```
（按月份归档）。
若用户未显式提供路径，默认写入上述配置路径，不需要二次询问路径确认。
先运行脚本提取“原始会话索引”（
```
output-mode=evidence
```
），索引里必须包含
```
session_id / cwd / jsonl 文件路径 / 原话片段
```
。
助手必须回看关键
```
jsonl
```
原文后再人工归纳，直接写入日记正文（主线、主题聚合、结果汇总、关联项目）。
自动区块
```
write-auto
```
仅用于附录或对账，不能替代正文，也不能用来替代原始会话回看。

最终产出（强制）

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

正文结构模板

# YYYY-MM-DD 周X

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

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

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

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

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

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

质量约束

禁止把脚本 evidence 区块原样粘贴为正文。
禁止正文堆命令流水账、绝对路径列表、工具调用明细。
禁止使用“关键词标签/主题分布”直接驱动正文结论。
主题必须体现“决策 -> 动作 -> 结果”的闭环，而不是平铺事件。
正文分点默认使用精简书面语：先给 1 句总述，再保留 2 条左右最关键子点；能删的背景、铺垫、感受、过程细枝末节一律删掉。
除非当天确有强证据链需要保留，否则不要出现 3 条以上子点；优先把多句并成一句结果表达。
一级要点标题必须直接说清“对象 + 动作/结果”，禁止空泛修辞、姿态化总结、抓不住对象的抽象表述。
标题命名优先级：
1. 若是工具/平台增补或升级，直接写“新增/安装/接入/验证了什么工具”，例如：
```
新增 CodexBar 并确认能力边界
```
  。
2. 若是方案讨论但未落地，直接写“讨论/对齐了什么问题”，例如：
```
讨论 llm-wiki 的回流边界
```
  。
3. 若是已经落地到文档/仓库/知识库，直接写“落地了什么产物”，例如：
```
新增 purpose.md 并切到 analysis-first ingest
```
  、
```
all-my-ai-needs 切换为 platform-first
```
  。
默认少写“轻量结论 / 路线收敛 / 能持续维护 / 进入某种状态”这类二阶评价；除非后面紧跟具体对象与落地产物，否则不用。
写作前优先对比同周日记风格，保持语气与结构连续。
写作前必须执行“模板对齐检查”：读取目标月份最近 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 "/Users/suqi3/obVault/sams-vault" \
  --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
```
回看 + 模板写作”，不再依赖自动分类统计。