Przejdź do treści
Biblioteka skilli
Produktywność osobista · Pisanie

log

/log

Zapisuje i odczytuje dziennik pracy: postęp sesji, przypomnienie o kodzie bez commita i podsumowanie dnia.

Licencja
Apache-2.0
Ostatnia zmiana repozytorium
01.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 01.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

  1. 定位
  2. 模式判断
  3. 写入模式(默认)
  4. 写完日志后 — 检查未提交代码(默认开启)
  5. 读取模式(/log read)
  6. 纪律
Sekcje z nagłówków SKILL.md, w oryginale · 174 linii, 506 słów
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

RepozytoriumWynikLicencja
Ta strona · yuan-ai-cloud/yuanliaofan-harness100Apache-2.0
dtiger1889-ops/claude-harness-toolbox100MIT
SritejCanchi/learning-log100MIT
MaiBP/professional-twin96MIT
Cruna-Noise-To-Signal/cruna-plugins90Apache-2.0
guillaume-piron-dev/you-decide90Apache-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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.