---
name: polisher
description: 中文文章润色与校对技能。支持语法拼写修正、格式规范化（中英文空格、全角标点、标点成对）、段落拆分，通过 diff 视图让用户确认修改。触发场景：(1) 用户说"润色"、"校对"、"检查格式"、"polish" (2) 被 outliner 完成初稿后调用 (3) 中文文本格式规范化需求
---

# 文章润色与校对技能

## 角色定位

作为"后期制作团队"，由两个专业角色协作：

1. **内容编辑（AI）**：语法、拼写、病句修正
2. **格式工程师（Python 脚本）**：格式规范处理

用户作为"内容导演"通过 diff 视图进行最终决策。

## 工作流程

### 步骤一：获取待润色文件

| 场景 | 获取方式 |
|-----|---------|
| 用户直接指定 | `/polish draft-outline-a.md` |
| 被 outliner 调用 | 从参数获取文件路径 |
| 文件不存在 | 列出当前目录可用草稿，提示用户 |

### 步骤二：AI 内容润色（保守型）

**仅修正问题，保持原意：**

| 类型 | 示例 |
|-----|------|
| 语法错误 | 主谓不一致、时态错误、成分残缺 |
| 拼写错误 | 错别字、英文拼写、专有名词大小写 |
| 病句 | 语义重复、逻辑矛盾、指代不清 |
| 标点基础 | 句号缺失、引号不成对、括号不匹配 |

**严格不做：**
- ❌ 不改变作者观点
- ❌ 不调整文章结构
- ❌ 不重写段落
- ❌ 不添加新内容

> 详细规则参见 [rules.md](references/rules.md)

### 步骤三：运行格式脚本

```bash
python3 scripts/format_fixer.py < 润色版文本
```

**格式处理：**
1. 中英文空格：中文与英文/数字之间添加空格
2. 全角标点：中文语境统一使用全角标点
3. 标点成对：检测括号、引号是否成对
4. 段落拆分：超长段落自动拆分

> 支持配置文件 `assets/config.yaml` 自定义专有名词和参数

### 步骤四：生成 Diff 视图

Diff 报告格式模板和完整示例参见 [diff-format.md](references/diff-format.md)

**简要格式：**
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📝 润色对比报告：{文件名}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【内容修改】N处
【格式修正】N处

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
是否确认保存？[确认/调整部分/取消]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 步骤五：用户确认与保存

| 用户指令 | 处理方式 |
|---------|---------|
| "确认" | 保存为 `polished-{原文件名}` |
| "调整X" | 重新处理指定部分 |
| "取消" | 不保存，退出 |
| "只看格式" | 仅展示格式修改 |
| "只看内容" | 仅展示内容修改 |

原文件保持不变。

## 特殊参数支持

| 参数 | 功能 |
|-----|------|
| `--format-only` | 仅执行格式处理，跳过 AI 内容润色 |
| `--content-only` | 仅执行 AI 内容润色，跳过格式处理 |
| `--paragraph N` | 仅润色第 N 段 |

## 与其他技能协作

**被 outliner 调用：**
```
outliner → "调用 /polish draft-outline-a.md"
polisher → 执行润色流程
返回 → outliner 继续后续流程
```

**调用 beary-style：**
用户要求"检查 Beary 风格"时，润色完成后可调用 beary-style 技能。

## 技术实现

- **SKILL.md**：本文件
- **scripts/format_fixer.py**：格式处理脚本（支持 `--json` 输出）
- **assets/config.yaml**：可配置专有名词和参数
- **references/**：详细规则和示例

更多示例参见 [examples.md](references/examples.md)