polisher

📁 hansonyyds/beary-skills 📅 8 days ago
3
总安装量
3
周安装量
#57439
全站排名
安装命令
npx skills add https://github.com/hansonyyds/beary-skills --skill polisher

Agent 安装分布

amp 3
gemini-cli 3
github-copilot 3
codex 3
kimi-cli 3
opencode 3

Skill 文档

文章润色与校对技能

角色定位

作为”后期制作团队”,由两个专业角色协作:

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

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

工作流程

步骤一:获取待润色文件

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

步骤二:AI 内容润色(保守型)

仅修正问题,保持原意:

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

严格不做:

  • ❌ 不改变作者观点
  • ❌ 不调整文章结构
  • ❌ 不重写段落
  • ❌ 不添加新内容

详细规则参见 rules.md

步骤三:运行格式脚本

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

格式处理:

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

支持配置文件 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