doc-polish
Use when a document for people to read has passed fact-check and its wording needs a pass before publishing — the prose reads like model output, corporate or marketing tone, or the user asks to polish it (润稿). Not for drafts whose facts are still moving.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 76
- Forks
- 17
01 前言 Front Matter
- name
- doc-polish
- description
- Use when a document for people to read has passed fact-check and its wording needs a pass before publishing — the prose reads like model output, corporate or marketing tone, or the user asks to polish it (润稿). Not for drafts whose facts are still moving.
03 SKILL.md 正文
doc-polish
Stage 2 of the finishing pipeline. Change wording, never facts.
Prerequisite: doc-fact-check has run and its findings are fixed.
Who runs it
The current session. The finished context is already here; sending the whole document elsewhere gains nothing.
- Chinese prose →
human-writingskill. English prose →humanizerskill. - The writing rules in this repo win over the skill's own bans (keep 「——」 and colons in technical documents; full-width commas in Chinese).
- Conservative mode for technical content: code, commands, paths, tables, English terms and parallel list items are not rewritten for variety.
Commit the draft first
The polish diff must be reviewable on its own, separate from fact changes.
Read sentence by sentence
Read the body from start to end and judge each sentence on its own. No search-and-replace, no replace-all: the cut lists are criteria, not a dictionary, and the same word is a term in one sentence and a violation in the next. The precheck's mechanical checks are the only pattern-based ones.
Contrast constructions: flag, don't fix
List every "not A, but B" with its location and hand the list back to the author. Judging one needs to know whether anyone actually read A that way; that fact is outside the sentence. doc-review is the gate.
Tone
Plain and restrained. No hype, no slogans, no filler. Plans for the future stay, marked as plans. Whether numbers are right is fact-check's job.
Afterwards
Run {{PRECHECK_PATH}} <file.md>, then doc-review. Never run polish and review in parallel.
04 同仓库更多 Skills
doc-review
Use when reviewing docs in this repo (team version).
zh-hant-converter
Use when Simplified Chinese text needs a Traditional Chinese version — internal team docs converted with opencc s2hk, or a product's Simplified Chinese UI copy mirrored into its Traditional Chinese locale — or when the user says 转繁, 同步繁体, or "convert to zh-Hant".
cleaning-dev-caches
Use when this Mac's disk is nearly full, or the user asks to clear re-downloadable caches (「清缓存」「硬盘满了」, "clear caches") — Homebrew, npm / pnpm / yarn / bun / uv / pip, Gradle, Playwright browsers, Edge and VS Code updater caches, simulator dyld caches, unused Rust toolchains. Not for build output (cleaning-dev-build-artifacts) or personal files.
cleaning-dev-build-artifacts
Use when this Mac's disk is nearly full, or the user asks to clean build output — Rust target/ dirs or Claude Code worktrees (.claude/worktrees) under {{DEV_ROOT}} (「清编译产物」「清 target」「清 worktree」「硬盘满了」, "clean build artifacts"). Not for package-manager or app caches (cleaning-dev-caches) or personal files.
ios-keyboard-page-shift
Use when, on iPhone Safari or an iOS WebView, a page or a full-screen app shell (top bar, scrolling list, bottom input) moves up when a text field is focused and stays up after the keyboard closes, leaving the top bar off-screen, the input mid-screen and an empty band below it, or when an earlier fix for that symptom did not hold.
codex-review
Use when the user asks to review a branch, PR or diff with codex ("review this with codex", 用 codex 审一下, "codex review PR N"). Runs `codex exec` from the shell with a hand-written, repo-aware prompt; falls back to one OpenRouter GPT call only when codex is out of quota. Covers the invocation contract and the failure modes that make codex look dead or silently produce no report.