AGENT SKILL

doc-review

Use when a document for people to read has been fact-checked and polished and is one step from being pushed or published — the last gate before `git push` — or when the user asks for a final review (终审).

License 许可
MIT
最近更新
2026-11-14
Stars
★ 76
Forks
17

01 前言 Front Matter

name
doc-review
description
Use when a document for people to read has been fact-checked and polished and is one step from being pushed or published — the last gate before `git push` — or when the user asks for a final review (终审).

03 SKILL.md 正文

doc-review

Stage 3, the last gate before push. Verdict: SHIP or FIX-FIRST.

Who runs it: a different model

The reviewer must be a different model from the one that wrote the document. In Claude Code, dispatch a subagent on a different model than this session's; or run codex-review if it is installed. Same-model self-review does not count. If this session may not spawn subagents, ask the user for permission first.

Run the precheck first

{{PRECHECK_PATH}} <file.md>

Mechanical problems should not take a person's attention.

Seven checks

  1. Fact spot-check. Re-verify the 3-5 claims that carry the most weight (numbers, IDs, order). Do not redo the whole fact-check.
  2. Metadata. Frontmatter or other required fields match this repo's schema.
  3. Punctuation. Chinese documents: full-width commas, no en-dash, 「——」 allowed.
  4. Tone. Plain and restrained; no hype, no corporate jargon.
  5. Contrast constructions. For each "not A, but B", ask whether the reading A can be traced to a source: a review comment, an earlier version, another document's conclusion, a misleading signal in data. If not, it is a blocker. This stage is the only gate for this rule.
  6. Scope. Content that belongs to another document is linked, not rewritten. A reversed decision is written as a net result ("PR #A decided X"), not as a story ("first A, then B overturned A").
  7. Leaks (public repositories). Product names, private repository names, internal URLs, local paths, personal emails. Any hit is a blocker.

Output

SHIP       no blockers; push
FIX-FIRST  blockers, each with location and fix; review again after fixing

Blockers go to zero before the push. Non-blocking suggestions can go in the PR body.

Next

The push step in doc-publish.

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