log
/log
Zapisuje i odczytuje dziennik pracy: postęp sesji, przypomnienie o kodzie bez commita i podsumowanie dnia.
- Autor
- yuan-ai-cloud ↗
- Repozytorium
- yuanliaofan-harness ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 01.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 01.11.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Zapisuje i odczytuje dziennik pracy: postęp sesji, przypomnienie o kodzie bez commita i podsumowanie dnia.
Wyzwalacze z opisu
Oryginalny opis (EN)
工作日志读写。/log 写入当前会话进展(默认);/log read 读取今日或最近日志查看进展。session 结束写日志、开工查 handoff 时使用;触发词"更新工作日志"=写入模式。写完自动检查未提交代码。不适用于:跨会话长期记忆(用户级 memory 系统)、版本级复盘(走 /reflect version)。
Jak działa
- 定位
- 模式判断
- 写入模式(默认)
- 写完日志后 — 检查未提交代码(默认开启)
- 读取模式(/log read)
- 纪律
Podgląd SKILL.md
---
name: log
description: 工作日志读写。/log 写入当前会话进展(默认);/log read 读取今日或最近日志查看进展。session 结束写日志、开工查 handoff 时使用;触发词"更新工作日志"=写入模式。写完自动检查未提交代码。不适用于:跨会话长期记忆(用户级 memory 系统)、版本级复盘(走 /reflect version)。
---
# 工作日志读写
## 定位
`memory/YYYY-MM-DD.md` 形成完整协作记录。**写**(默认)和**读**(`/log read`)合并在同一 skill 内 — v0.82 整合(原 readlog 已并入)。
> **路径约定(可参数化)**:日志目录默认 `memory/`,可按你仓库的约定整体替换;下文「主仓 / worktree 分流」一节仅适用于多 worktree 团队,单树仓库忽略即可。
## 模式判断
- 默认或参数为空 / "write" → **写入模式**
- 参数为 "read" / "查" / "看" → **读取模式**
---
## 写入模式(默认)
### 目标文件(v0.98-opt 优化四 — 日志沉主干)
**日志永远写主仓的 `memory/`,NEVER 写进 worktree**(worktree 的 memory 随 `git worktree remove` 蒸发 = E4,日志是最重要的过程原材料;且 H2 hook 会直接拦 worktree 内的 memory 写)。
- **判定在哪棵树**:`git rev-parse --git-common-dir` —— 输出 `.git`(相对)= 在主仓;绝对路径 `.../.git` = 在 worktree。**主仓根 = 该 common-dir 的父目录**。
- **在主仓** → 写 `<主仓>/memory/{当天日期}.md`。
- **在 worktree** → 用**绝对路径**写 `<主仓>/memory/{当天日期}-<线名>.md`(**per-line 文件**,`<线名>`=worktree 目录名如 `maas`/`charlie-opt`)。per-line 文件消灭"多线同写一个日期文件"的合并冲突(E4 第二隐患)。
- 主仓 `memory/` 是日志唯一真相源;worktree 会话 MUST 落绝对路径到主仓,NEVER 落自己 cwd。
- **月度归档**:根层只留**当月+上月**日志;写入时发现更早的 `memory/YYYY-MM-*.md` 散文件 → 顺手 `mv` 进 `memory/archive/`(验收包/handoff 等子目录不动)。防再积压:2026-10-03 保养时根层曾积 229 个散文件、07/08 两月 157 个未归档。
### 文件不存在(当天第一个 session)
创建文件,写入完整 session 记录:
```markdown
# YYYY-MM-DD 工作日志
### Session 1(简短标题)
**做了什么**: ...
**Context**: ...
**改了哪些文件**(如有代码变更):
- `path/to/file`(新建/修改)— 一句话说明
**关键决策**(如有):
1. ...
**遗留**(如有):
- ...
---
## Handoff
**当前状态**: 一句话概括现在在哪
**下一步**: 接下来该做什么
**注意事项**: 需要留意的坑或未完成项
```
### 文件已存在,当前 session 未记录
追加新 session(Session N+1),更新 Handoff 部分。
### 文件已存在,当前 session 已记录(同一 session 多次 /log)
增量更新当前 session 的内容(追加新进展,不重写已有内容),更新 Handoff 部分。
### 内容提取
从当前会话的上下文中提取:
- 做了什么(核心动作,不是过程流水账)
- 为什么做(Context/背景)
- 改了什么(文件变更列表,来自 git diff 或会话记忆)
- 关键决策及理由
- 遗留问题
- Handoff 信息
### 风格要求
- 参考 `memory/` 下已有日志的风格保持一致
- **做了什么**用一段话概括,不要列步骤流水账
- **关键决策**只记非显而易见的选择及理由
- **遗留**只记需要后续处理的项,已完成的不记
- Handoff 要具体到可操作,不要"继续开发"这种废话
---
## 写完日志后 — 检查未提交代码(默认开启)
`/log` 是检查 commit 漂移的最自然时机:日志已经 enumerate 了今天改了哪些文件,顺手扫 commit 是零成本增量。v0.82 实证:7 小时 v0.84 设计工作全部 untracked,直到 /log 才发现。
### 触发逻辑
写完日志后跑 `git status --short`:
- **clean** → 跳过,不输出任何内容
- **有未提交变更** → 报告文件列表 + 询问是否 commit
### 输出格式
```
📝 日志已写入 memory/YYYY-MM-DD.md
⚠️ 检测到未提交变更(N 个文件):
M memory/YYYY-MM-DD.md
?? path/to/new-file
...
是否提交?(草拟 message:"<本次 session 标题>")
全部提交 / 选择部分 / 跳过
```
### Commit message 草拟
基于本次 session 标题草拟,遵循 git 提交协议(结尾带 Co-Authored-By 尾注,模型署名以当前会话为准)。例如 Session 11 标题"v0.84 LLM Context Protocol 设计 + Core Constitution v1.0"→ 草拟:
```
docs(v0.84): LLM Context Protocol ADR-013 + Core Constitution v1.0 起草
Co-Authored-By: <当前会话运行时给出的模型署名> <noreply@anthropic.com>
```
用户可接受草拟 / 编辑 message / 拒绝(只报告不 commit)。
### 安全护栏(MUST)
- **MUST 排除**: `.env*` / `*.pem` / `credentials*` / `node_modules/` / build 产物 — 即使用户选"全部提交"也不带这些
- **NEVER 自动 `git add -A`** — 按文件具体加(`git add path/to/file`)
- **NEVER 在脏 git state**(rebase / merge / cherry-pick in progress)时操作 — 检测到 MUST 跳过此步,提示用户先解决
- **NEVER 自动 push 代码** — 代码变更只 commit,push 留给用户手动决定;**例外:日志文件(`memory/`)是 trunk 资产,MUST 提交到主仓并 push**(优化四:落主仓才永久)。worktree 会话经限定路径:`git -C <主仓> add memory/<file> && git -C <主仓> commit -- memory/<file> && git -C <主仓> push origin main`(限定路径不卷别的会话 staged 改动;`<主仓>`=`git rev-parse --git-common-dir` 的父目录)
- **MUST 在跑 commit 前再次确认 git status 与报告一致**(防止用户编辑期间状态变化)
### 用户拒绝 / 跳过
- 用户选"跳过" → 不动 git tree,只报告状态作提醒
- 用户在 /log 命令里说"不用 commit"或类似意图 → 跳过此步,不重复询问
- 用户已经手动 commit 过(写 log 时已 commit) → git status clean,自动跳过
---
## 读取模式(`/log read`)
### 逻辑
1. 获取当天日期
2. 如果 `memory/{当天日期}.md` 存在,读取它
3. 否则,找到 `memory/` 下最近的一个 `YYYY-MM-DD.md` 文件并读取
4. 输出日志内容,在开头标注日期
### 输出格式
```markdown
## 工作日志 — YYYY-MM-DD
[日志内容]
```
如果日志不是当天的,在标题后加注:
```markdown
## 工作日志 — YYYY-MM-DD(最近一篇,非今日)
[日志内容]
```
---
## 纪律
- NEVER 编造未发生的工作内容 — 只记录当前会话实际做的事
- NEVER 删除已有 session 的内容 — 只追加或增量更新
- NEVER 省略 Handoff 部分 — 这是读取模式的入口
- 同一 session 多次 /log 时,保持 session 编号不变,在原 session 内追加
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · yuan-ai-cloud/yuanliaofan-harness | 100 | Apache-2.0 |
| dtiger1889-ops/claude-harness-toolbox | 100 | MIT |
| SritejCanchi/learning-log | 100 | MIT |
| MaiBP/professional-twin | 96 | MIT |
| Cruna-Noise-To-Signal/cruna-plugins | 90 | Apache-2.0 |
| guillaume-piron-dev/you-decide | 90 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki f3c33f6cbef1 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90session-log
Tworzy lub aktualizuje dziennik sesji z decyzjami, zmianami i postępem, dokumentując to, co zrobiono podczas pracy. - 95obsidian-tracker-session-log
Zapisuje przebieg bieżącej sesji w projekcie Obsidian jako wpis dziennika. - 90handoff
Przygotowuje podsumowanie sesji: postęp, status zadań i to, co jest gotowe na następną sesję. - 100save
Zatrzymuje pracę w czystym miejscu: robi commit zmian, zapisuje dziennik i notatkę przekazania do nowej sesji. Przydaje się przy przerwie w pracy albo zmianie sesji. - 100session-log
Zapisuje raport z sesji jako stronę HTML, wyciąga decyzje, dopisuje kontekst z vaulta i podaje polecenie rename. - 100session-close
Zapisuje na koniec sesji notatki przekazania, dziennik, pamięć i notatki do nauki w vaultcie Obsidian, w folderze projektu.