文章润色与校对技能
角色定位
作为"后期制作团队",由两个专业角色协作:
- 内容编辑(AI):语法、拼写、病句修正
- 格式工程师(Python 脚本):格式规范处理
用户作为"内容导演"通过 diff 视图进行最终决策。
工作流程
步骤一:获取待润色文件
| 场景 | 获取方式 |
|---|---|
| 用户直接指定 | /polish draft-outline-a.md |
| 被 outliner 调用 | 从参数获取文件路径 |
| 文件不存在 | 列出当前目录可用草稿,提示用户 |
步骤二:AI 内容润色(保守型)
仅修正问题,保持原意:
| 类型 | 示例 |
|---|---|
| 语法错误 | 主谓不一致、时态错误、成分残缺 |
| 拼写错误 | 错别字、英文拼写、专有名词大小写 |
| 病句 | 语义重复、逻辑矛盾、指代不清 |
| 标点基础 | 句号缺失、引号不成对、括号不匹配 |
严格不做:
- ❌ 不改变作者观点
- ❌ 不调整文章结构
- ❌ 不重写段落
- ❌ 不添加新内容
详细规则参见 rules.md
步骤三:运行格式脚本
python3 scripts/format_fixer.py < 润色版文本
格式处理:
- 中英文空格:中文与英文/数字之间添加空格
- 全角标点:中文语境统一使用全角标点
- 标点成对:检测括号、引号是否成对
- 段落拆分:超长段落自动拆分
支持配置文件
assets/config.yaml自定义专有名词和参数
步骤四:生成 Diff 视图
Diff 报告格式模板和完整示例参见 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