AGENT SKILL

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-writing skill. English prose → humanizer skill.
  • 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

etherfunlab
etherfunlab/workflow

doc-review

Use when reviewing docs in this repo (team version).

★ 76
etherfunlab
etherfunlab/workflow

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".

★ 76
etherfunlab
etherfunlab/workflow

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.

★ 76
etherfunlab
etherfunlab/workflow

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.

★ 76
etherfunlab
etherfunlab/workflow

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.

★ 76
etherfunlab
etherfunlab/workflow

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.

★ 76