name: writing-polish
description: Coaches, drafts, polishes, and audits Chinese documents using 《怎样写作》(任仲然). Three modes: coach (帮我写/起草/拟稿/搭提纲), polish (润色/审稿/改稿, default for ambiguous triggers), audit (快速过/checkpoint). Triggers on 润色/审稿/改稿/帮我写/起草/拟稿/搭提纲/审一审/改一改/polish/review/proofread/帮我看看/去 AI 味/AI 感/去味/这段读着像 AI 写的/帮我去味/DOCX 修订. Does NOT trigger for translation, code review, English-only writing.
allowed-tools: Bash, Read, Edit, Write, Task
writing-polish v8.0
任仲然《怎样写作》+ 230 余条 AI 味红线 + clean-context 反馈式审校（Anthropic evaluator-optimizer 范式）。
“好文稿是改出来的。热写稿，冷改稿。”
Prerequisites：bash + python3.9+（macOS 自带）+ pandoc（仅 DOCX 模式 brew install pandoc）。scripts/scan-ai-taste.sh 已 chmod +x。
§0 速览：评价分两个世界
写作评价分两层，本技能严格区分（per-use 不打数值分，数值只在离线）：
| per-use 热路径（每次改稿都跑） | 离线 dev-eval（只在改规则时跑） |
|---|
| 目的 | 让这一篇变好 | 衡量本技能本身好不好 |
| 评价输出 | 自然语言可执行反馈 + 粗判闸门（够好了/要改/红线未清） | 数值逐维分（offline benchmark） |
| 落点 | scan-ai-taste.sh（L1 硬扫）+ agents/writing-reviewer.md（clean-context reviewer） | evals/offline-harness/ |
- 每篇改稿只用自然语言反馈：reviewer 指到具体句、说清 why、给改法；主对话据此串行改稿。不打 0-3 分、不写 trace、不取 max。
- reviewer 同时查正向实质轴：立意 / 结构与论据 / 材料·事实，不只查 AI 味；单边评测会导致单边优化（Anthropic 2026-01）。
§1 Mode 路由
1.1 触发词表
| Mode | 触发关键词 | 默认行为 | 输出 | 时长 |
|---|
| Coach | 帮我写 / 起草 / 拟稿 / 搭提纲 / 草稿 / draft / outline | 监督生成弧（立意→构思→提纲→材料→结构，逐段 checkpoint） | 提纲 + 段落范本 | 5-15 min |
| Polish | 润色 / 审稿 / 改稿 / polish / review / proofread | L1 硬扫 + ≥ 1 clean-context reviewer + 主对话串行改稿 | 修改稿 + 按焦点分组 NL 复盘 + verdict | 2-5 min |
| Audit | 快速过 / 扫一下 / 检查一下 / checkpoint | 脚本主导，零 reviewer | pass/fail + 红线分类 | 30s |
1.2 触发词歧义解析
歧义触发词“帮我看看”“改一改”→ 主对话先估字数（可用 scripts/word-count-check.sh）再给推荐 + 理由，30s 窗口可改：
| draft 字数 | 默认 | 理由 |
|---|
| < 500 字 | Audit | 短稿红线扫描足够，spawn reviewer 不划算 |
| 500-3000 字 | Polish | 标准润色，1 个全焦点 reviewer |
| > 3000 字 | Polish（分段） | 长稿升级 2-3 个按焦点分摊的 reviewer |
文案示例：“建议 Polish（800 字属标准档；将 spawn 1 个全焦点 reviewer）。30s 内回复 audit/coach 可改。”。用户已在触发词明示 mode → 跳过该步。
§2 Protocols
2.1 Coach Protocol（监督生成弧）
按 references/coach-checkpoints.md 走 立意→构思→提纲→材料→结构 五段，每段一个用户确认 checkpoint（默认可跳过，不强制）。要点：
- 准备：判体裁 → 读
references/genre-guide.md §<体裁> + references/writing-methodology.md + 选 assets/real-world-anchors/ 同体裁锚本。
- 立意 ✋：收敛到“一个”核心问题（拒“全而又全”）+ 小切口→大思路 + 列观察日志（3-5 条具体细节）。
- 提纲 ✋：粗纲 → 细纲（每段 1 行判断）+ 标注同级并列/递进。提纲早出手、初稿晚出手。
- 材料 ✋·事实敬畏：列素材清单，每条标三态：①可证实直接用 / ②未提供需追问（列清单问用户，不替写）/ ③不得编造。
- 成稿：用确认的提纲 + 素材填内容，结构服务内容，朴实克制。
- 收尾：成稿走一遍 Polish Protocol。
路由：“教我写作 / 练笔”→ references/writing-coaching-arc.md（摹仿→制造→创造 技能弧）；“帮我写这篇”→ 上述生产弧。
2.2 Polish Protocol（4 步，主对话照此执行）
step 1 — L1 hard gate
bash scripts/scan-ai-taste.sh --target <draft> --json
→ 读 exit_code / summary.red_line_violations_total / summary.categories
→ 红线命中入“待修清单”（不立即改）
step 2 — clean-context reviewer(s)（按 references/reviewer-routing.md 分焦点）
2.0 字数闸：draft < 500 字经明示触发词（润色/改稿）进入 Polish 是**合法边界**（§1.2 只把歧义词的短稿默认路由到 Audit，不拦明示润色）；此档**可省 reviewer**（L1 脚本 + 主对话自审即可），≥ 500 字才 spawn ≥ 1 reviewer
2.1 定 reviewer 数与各自 focus（按长度/体裁分摊焦点，见 routing 决策表）
2.2 每个 reviewer 用 Task 工具 spawn writing-reviewer 子代理（clean context），任务 prompt 注入：
draft 全文 + 该 reviewer 的 focus 列表 + constitution 对应体裁切片 + 当前日期 + 项目豁免清单
2.3 每 spawn 一行用户可见 [spawn writing-reviewer focus=立意+结构]；返回时 [verdict=要改]
2.4 reviewer 返回 <feedback>（按焦点分组 NL）+ <verdict>够好了|要改|红线未清</verdict>
2.5 失败 retry 1 次（2s 退避）；2 次失败记 missing-review → **不进 step 3 自动改稿，直接上报用户“reviewer 不可用、本次仅 L1 硬扫结果”**（不静默降级 = fix-the-tool-don't-fallback）
step 3 — 修改 draft（single-linear-writer，主对话串行，见 §4.5）
3.1 先备份：cp <draft> <draft>.polish-backup-$(date +%s).md
3.2 有序单维 sweep（先大后小，一轮走完不跳回）：
① 达意/立意（改到位）→ ② 空话与口水（空话可证伪测试 + 模糊副词）
→ ③ 结构与论据（层级/So-What 收口）→ ④ 标点与体裁 AI 味（红线 + 软信号）
sweep 深度按稿长分档（**独立于 §1.2 mode 路由表**，只管本 step 跑几维）：< 500 字只跑 ①④ 两维；≥ 500 字全 4 维。
3.3 reviewer 反馈在本轮 step 2 已一次性覆盖全焦点，step 3 据其分维改，**同一轮内不每维重 spawn reviewer**（避免 O(N²)；跨轮重 spawn 见 step 4.2）
3.4 行号倒序修改（避免 offset 漂移）；draft > 5000 字 → 分段串行
3.5 高影响操作（整段重写导语 / 删整节）走 checkpoint 征询用户，不设数字改动帽
3.6 事实层：reviewer 标“需追问/不得编造”的缺口 → 向用户追问，绝不替写；推断标前提（第四态）
step 4 — 验证 + 输出
4.1 回归复验走 scan 重跑（廉价确定性）→ 期望 red_line_violations_total = 0
4.2 仍有 reviewer verdict = 红线未清 / 要改（实质类）→ **回到 step 2 重 spawn 一个 clean-context reviewer（携改后稿、不告知轮次，见 constitution §7.1）产出新 verdict** → 据其再走 step 3；**最多 2 轮，仍不过上报用户**（禁把 Polish 套 /loop 自转，见 constitution §7 运行时护栏）
4.3 论点重的长稿：末轮在 reviewer 的**结构与论据焦点**下追加 steelman/kill-argument 视角（复用既有焦点、非新增焦点；detect-only，不单开 fresh-thread）
4.4 输出（格式见 §6）
2.3 Audit Protocol（2 步）
step 1: bash scripts/scan-ai-taste.sh --target <draft> --json
step 2: 输出 pass/fail + 红线分类列表；若 fail，末尾追问“切到 Polish 自动修复？”（不直接修，等确认）
2.4 DOCX 桥接（Polish/Audit 通用）
pandoc <input.docx> -t markdown -o /tmp/<name>.md
pandoc /tmp/<name>.md -t docx -o <output.docx> --reference-doc=<input.docx>
python3 scripts/docx-review-workflow.py <input.docx> <output.docx>
2.5 声音匹配（可选，仅 G6/G7）
用户要求“写得像我 / 贴我的风格 / 声音匹配”且体裁为 G6 随笔 / G7 自媒体时启用；G1-G5、G8 一律跳过（公文/报告的“声音”是体裁规范，不是个人声纹）。核心认知：不像 AI ≠ 像我，去黑词只是必要条件，“像我”要另外补，且声音层不覆盖任何红线。
- tier-1（默认，不落盘）：请用户贴 2-3 段旧作真迹 → 六维观察（句长节奏/用词偏好/标点习惯/段落组织/修辞倾向/语气人称，只取反复出现的习惯）→ 并入 Polish step 3 有序 sweep 作附加约束，不新增 reviewer。
- tier-2（可选，落盘复用）：画像写用户自己项目仓
.writing-voice/<genre>.md（插件不携带声纹）；人可读 md，不向量化、不嵌入检索。
协议全文见 references/voice-matching.md。
§3 红线 4 铁律速查
SSOT: references/anti-ai-taste-anchors.md §0-§3；scan-ai-taste.sh 字面执行。
- GB/T 15834 标点：弯引号
"" ''（U+201C/D/2018/9），禁 ASCII 直引号 / em-dash / 直角引号 / 半角括号紧贴英文术语
- 公文黑词：赋能 / 重塑 / 闭环 / 抓手 / 链路 / 颗粒度 / 拉通 / 跑通 / 复盘 / 对齐 / 三件套
- 元注释：作为一个 AI 助手 / 让我为您整理 / 希望对您有帮助 / 以上仅供参考
- 戏剧化叙事：三层防御 / 跑通 / 翻车 / 大刀阔斧 / 一战成名（IT 实物语境例外，scan ±2 行白名单）
§4 三大审查焦点 + 红线（NL，reviewer 据此分组反馈）
SSOT: references/constitution.md §0“四大审查焦点”+ §0.5“正向实质三焦点”。per-use 不打数值分。
| 焦点 | 好的样子 | 差的样子 |
|---|
| 立意 | 一文一主题、小切口大思路、有穿透力 | 全而又全、开篇堆大词、平淡正确 |
| 结构与论据 | 同级层次清楚、结构服务内容、论点到论据的链条连贯 | 僵化三段式、并列失衡、论证跳跃 |
| 材料·事实 | 货真价实、多样、有数据；事实三态分明 | 模糊副词堆砌、缺数据支撑、编造/含糊归因 |
| AI味·标点 | 平实克制、标点合规、语境一致 | 黑词密集、戏剧化隐喻、ASCII 标点、否定平行 |
事实敬畏三态（材料焦点核心）：① 已有材料可证实 → 用；② 用户未提供需追问 → 列清单问用户，不替写；③ 不得替用户编造。
§4.5 五权分立 + 单线程 writer
| 目录 | 职责 |
|---|
SKILL.md | protocol（操作序列） |
agents/writing-reviewer.md | clean-context reviewer 子代理（只评不改，返回 NL 反馈 + verdict） |
references/ | substance（评判依据 / 体裁 / 案例 / routing / 12 讲覆盖矩阵） |
scripts/ | gate logic（L1 regex / 字数 / 依赖检查） |
assets/ | 锚本（真实公文范本 + 任仲然 8 范例） |
evals/offline-harness/ | 离线数值评测（改规则时才用，不进 per-use 路径） |
Polish step 3 单线程 writer 铁律：改 draft 必由主对话串行，禁 spawn parallel writers（Cognition Walden Yan：actions carry implicit decisions，并行写产生不可 reconcile 的冲突）。reviewer 评分阶段可并行，writer 阶段串行。
§5 资源路由表（Mode → 必读，progressive disclosure）
完整资源路由 → references/resource-routing.md（按需加载）。任仲然 12 讲继承审计 → references/renzhongran-coverage-matrix.md。
§6 输出格式 + 修改哲学
Polish mode 输出（固定结构）
1. 修改稿（核心交付，markdown / docx）
2. 按焦点分组的 NL 复盘 + 总 verdict：
【立意】补强了一处… 【结构】切分了 2 处长段… 【材料/事实】1 处缺数据已向你追问… 【AI味/标点】改了 3 处黑词
→ verdict: 够好了
3. 修改概览（1 行）：“改了 3 处黑词、2 处长句切分、1 处立意补强”
4. 撤销命令：cp <draft>.polish-backup-<timestamp>.md <draft>
修改哲学 + 严守纪律
