---
name: lib-export
description: >
  Use when Wayne asks to capture the current session into the vault work log —
  triggers on "export", "导出", "总结一下", "记到工作记录", "export detail",
  "export result", "export log", "记录过程".
---

# lib-export — Session Export to Work Log

Export the current session into the work log. Two modes: result / detail.

**Vault**: `~/MyLibrary`
**Work log**: `工作记录/{Month}/{YYYY-M-D}.md`

## Flow

Steps are ordered and gated. Step 0 and Step 3 are **hard gates** — do not skip, do not eyeball.

### Step 0 — Compute today（4am 日界线）— HARD GATE
1. Run `date "+%Y-%m-%d %H:%M"`.
2. If **hour < 4**, today = 日历日期减一天（before 4am 算前一天）.
3. **Output the resolved target path** (`工作记录/{Month}/{YYYY-M-D}.md`) before doing anything else.
- Never write to the calendar date without running `date` and applying this rule.
- Existing file at target → read it. Missing → create with frontmatter (`created`, `date`, `tags: []`).

### Step 1 — Read the target work log
理解已有内容、style、已有的 `## sections`。Match density、换行、语言。

### Step 2 — Read relevant entity pages
`ls`/`grep _entities/` for entities this session touches。了解它们当前状态,以便正确归属。

### Step 3 — Placement & heading — HARD GATE
**Every new `## heading` MUST be a `[[wikilink]]`. Free-text `## heading` is forbidden.**

Placement is **judgment from the work log's current structure** (you hold it from Step 1), **not a fixed ladder**. Decide per section against these constraints — see [skill-conventions.md](references/skill-conventions.md) → Write side:
- **Reuse before create.** Matching `## [[entity]]` exists → write inside it; matching `###` child exists → append there. **Never open a second `## [[entity]]`** or duplicate a child `###`.
- **A child stays under its parent.** Content belonging under an existing `## [[parent]]`'s `###` stays there — don't promote it to top-level.
- **Mint `## [[new-entity]]` only** for a standalone, recurring, retrievable *thing* with no existing section. An unresolved wikilink is how entities are born — kebab-case canonical name.
- **Small / no clear subject** → inline under the relevant section, no new heading.

判断"挂已有 vs mint 新":反复出现、值得日后检索的独立 thing → mint;只是某 entity 的一条进展 → 挂下面;拿不准 → 挂已有 / inline(宁可不爆炸)。

### Step 4 — Write
直接 edit 工作记录。**只 append/insert,绝不 overwrite Wayne 已有内容。**
- AI 生成的 heading 打 `#AI总结` tag。
- 描述性小标题降级成 **bold lead 行**,不要占用 `##`(那是 entity 的位置)。
- 写进已有 `###` 时保持原标题,append 一段 `**Export 补充:** #AI总结`,别再造同名 `###`。

### Step 5 — Report new entities（不建页）
列出本次写下的、但 `_entities/` 里**还不存在页面**的 `## [[entity]]` headings。
- 这些保持为 unresolved link,**等下次 settle / lib-entity 被动 materialize**。
- **export 不创建 entity 页面,也不调用 lib-entity。** 只报告,让 Wayne 知道有新 entity 引用待落地。

## Two Modes

### Result mode（默认）— "export" / "导出" / "总结一下"
做了什么、结果是什么。Compact,结论导向。**不**描述过程。
- Include: decisions, results with numbers, features completed, key artifacts, TODOs。
- Exclude: process, dead ends, verbose explanations。

### Detail mode — "export detail" / "记录过程" / "export log"
怎么做的——过程、讨论、pivots、关键 quotes。记录思考演变,不只是终态。
- Include: 上面全部 + 讨论过程、设计演变、pushbacks、Wayne 的关键原话(5-10 条)。
- Exclude: routine tool calls, AI meta-commentary。
- **必须含 quotes**:`>` blockquote,Wayne 原话不改字,每条前用一句 context 引导,不能被淹没。

## Writing Rules

- **Match Wayne's style** — 紧凑,段落间不要多余空行。
- **最多一个 `###`** per export。其余用 inline、bullets、tables。
- **No fancy HTML**。
- **Language**: match session 的 中英混合。
- **Voice**: first person, casual。
- **Links**: vault 内 `[[wikilink]]`,vault 外 `[name](url/path)`。

## Red Flags — STOP

- 准备写一个**不是 `[[wikilink]]`** 的 `## heading` → STOP。resolve 成 entity、mint 新 entity wikilink,或降级 inline。自由文本 `##` 永不允许。
- 准备新开 `## [[entity]]` 但目标文件里已经有同一个 entity 的 `##` → STOP。append/insert 到已有 section。
- 准备新开 `## [[child-entity]]`，但它明显属于当前已有 parent `##` 下的 `###`/subtopic → STOP。放到 parent section 里的现有/新 `###`。
- **没跑 `date` 就用日历日期** → STOP。先 Step 0 算 4am 边界。
- 凌晨(hour < 4)却把内容写进了"今天"日历日期的文件 → 错文件,应是前一天。
- 想顺手"帮忙"创建 entity 页面 / 调 lib-entity → STOP。export 只写引用,建页是 settle/lib-entity 的事。
- 准备 overwrite 或重写 Wayne 已有的段落 → STOP。只 append/insert。

## Constraints

- Nothing substantive → say so, don't pad。
- Read before write — always。
- 新建文件也要先 Step 0 算对日期。