菜单
Use when cleaning up a specific note or before promoting it — runs atomicity, link, and title checks. Load with `nn skills get nn-refine`.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
| name | nn-refine |
| description | Use when cleaning up a specific note or before promoting it — runs atomicity, link, and title checks. Load with `nn skills get nn-refine`. |
| when_to_use | After nn show <id> when you want to clean up a specific note, or before considering a note for promotion. Invoke with /nn-refine. |
Single-note hygiene: atomicity check, link suggestions, promotion eligibility, and title check.
Invoke after nn show <id> when you want to clean up a specific note. Run this skill on any draft note before considering it for promotion, or on any note that has grown stale.
Does the note body contain more than one independent claim?
nn show <id>
If yes — the note is not atomic. Propose a split:
nn new --title "<claim 2>" --type <type> --content "<extracted body>" --no-editnn link <new-id> <original-id> --annotation "split from" --type refinesnn update <original-id> --content "<remaining body>" --no-editA note is atomic when removing any sentence would leave only one coherent claim.
Run the link suggester to surface candidate connections:
nn suggest-links <id> [--limit 20]
Review candidates and propose nn link or nn bulk-link commands. Every link requires --annotation and --type. See nn-link-suggester for the full workflow.
A note is eligible for promotion when:
nn backlinks <id> to check)draft or reviewedIf eligible, propose:
nn promote <id> --to reviewed # draft → reviewed (errors on concurrent conflict)
nn promote <id> --to permanent # reviewed → permanent (errors on concurrent conflict)
Or use direct assignment:
nn update <id> --status reviewed --no-edit
nn update <id> --status permanent --no-edit
Does the title name the single claim in the body? A good title is a complete, falsifiable assertion or a precise concept label.
If not, propose:
nn update <id> --title "Better title that names the claim" --no-edit
nn show <id>
nn suggest-links <id> [--limit N]
nn new --title "..." --type <type> --content "..." --no-edit
nn link <from> <to> --annotation "..." --type TYPE
nn bulk-link <from> --to <id> --annotation "..." --type TYPE [--to <id> ...]
nn backlinks <id> [--json]
nn promote <id> --to reviewed|permanent # errors on concurrent modification conflict
nn update <id> [--title "..."] [--content "..."] [--status STATUS] --no-edit
nn list --long --json
nn suggest-links was run and candidate links were reviewedUse when you need to look up an nn command, flag, or usage pattern. Load with `nn skills get nn-guide`.
Use when after nn new or nn update to discover notes that should be linked to the modified note. Load with `nn skills get nn-link-suggester`.
Use when ending a session to consolidate captures, assess promotion eligibility, and update the daily page. For weekly review use --weekly; for daily page only use --daily; for lightweight mid-session capture use --partial. Load with `nn skills get nn-session-debrief`.
Use when asked to organise, capture, or link notes in the Zettelkasten. Load with `nn skills get nn-workflow`.
Use when about to take any action that introduces new information not already in the conversation. Load with `nn skills get nn-capture-discipline`.
Use when running a hygiene pass across multiple notes at once — drafts, orphans, long notes, or a topic cluster. Load with `nn skills get nn-refine-workflow`.