ah-gemini-script-polisher
使用 Gemini 润色或创作中文口播稿,保留作者事实、观点和表达。用于用户要求 Gemini 写口播稿、让 Flash 润色、把 Codex 上下文交给 Gemini 写作、调用口播写作桥,或讨论此桥的架构。普通口播写作未指定 Gemini、通用 Gemini 研究和应用代码架构不触发。
SKILL.mdskills/ah-gemini-script-polisher/SKILL.md
GitHubGemini 口播稿润色桥
Codex 负责知道作者要说什么,Gemini 负责把它说得顺口。审核修正事实和原意,不把已经通过的稿件重写成 Codex 的语气。
工作流
1. 整理相关上下文
读取 写作包模板,从当前任务提取主题、受众、目的、长度、原稿、已确认事实、锁定原话和必要的风格片段。历史资料只查与本稿直接相关的部分;当次指令优先于旧稿和历史偏好。
有原稿时默认润色。有明确选题和充分素材但没有原稿时,用观点提纲和原始表达请求成稿;不要为走流程先造一篇完整初稿。已有写作规则按当前内容类型提炼,不给所有稿件强套同一结构。关键事实确实缺失时集中补问一次,不让 Gemini 编故事填空。
2. 选择模式和发送
执行 官网桥接操作。写作和润色选择 3.8 Flash;讨论此桥的架构选择 Pro。发送前核对页面可见的用户指定账号、实际模型和输入框全文。账号只在会话中核对,不保存到 skill、稿件和运行文件。
写作使用独立对话,同一任务的继续和修订复用原对话。只发送最小写作包,不发送整段历史、整个知识库、账号资料或敏感素材。既有授权支持当前普通稿件交给 Gemini;授权不能扩张为上传其他私人文件。
3. 等待和继续
- 先按实际任务类型判断。以下 5 分钟规则用于普通写作、润色和短架构答复;用户已授权的 Deep Research 等长任务按独立规则等待,不因本 skill 自动启用深度研究。
- 普通答复无正文响应时最多等待 5 分钟,即 300 秒;每次等待分成不超过 60 秒的短段,工作期间持续简短汇报。
- 正文持续增长时继续读取。正文停滞后从最后一次增长重新计时;动画、状态文字、思考提示和轮询次数不算正文增长。
- 无进展满 300 秒且结果仍未完整,就在同一对话发送一次精确的“继续”。界面正在生成且不能发送时,此时才停止,核对已停止,再发“继续”。
- 继续后最多再等待一个 300 秒无进展窗口;仍无响应就保留现场并报告阻塞,避免无限重复发送。用户新的继续指令可开启下一轮。
- 原始请求提交状态不确定时先回读原对话,不重发写作包。继续的提交状态不确定时只核对是否已有对应消息,不再点发送。
Deep Research 页面明确显示研究仍在进行时,即使尚无最终报告或 5 分钟没有新正文,也继续等待。允许等待超过 20 分钟,不把 20 分钟设成硬上限,不因普通答复的 300 秒规则停止研究或发送“继续”。每次等待仍分成不超过 60 秒的短段,并根据实际研究状态汇报。研究完成后读取完整报告,再核对建议;明确失败、取消或等待用户操作时按对应状态处理,不能把活动动画当成最终报告。
4. 提取完整正文
读取当前 Gemini 回答的真实文本,保留原始回答。写作返回应含本次 task_id、revision、正文首尾标识和最终完成标识。仅在生成已结束且当前回答完整时执行:
python3 <skill目录>/scripts/check_response.py --response <Gemini原始回答文件> --task-id <本次ID> --revision 1 --out <纯正文文件>
需要精确字数时加 --min-chars 和 --max-chars;计数为去除空白后的字符数。该脚本只检查响应边界和长度,不判断事实真伪、风格或实际模型。未通过时不把局部内容拼成完整稿。
5. 核对和交付
逐项对照写作包,检查主体、数字及单位、时间、否定、因果、承诺和证据边界;再检查观点、锁定原话、段落衔接和口播可读性。语言更顺不应把“尝试”写成“已经成功”,也不应把个人体验写成普遍事实。
没有具体缺陷就交付 Gemini 原文。发现缺陷时列明原句、事实依据和改法,在原对话给一次定点修订,增加 revision 并要求返回完整正文;每次修订沿用同样的 5 分钟规则。仍不合格则交付可用草稿并说明未通过项,不伪称定稿。
硬约束
- 未实际读取 Gemini 返回正文,不得声称 Gemini 已写作、润色或评审。
- 不把 Flash-Lite 冒称 3.8 Flash,不把自动降级的回答记成 Pro。目标模型不可用时报告,不擅自切换。
- 作者原意优先于修辞;不新增未经输入支持的经历、案例、数据、情绪或因果。
- 保留普通口语、适度重复和作者已经认可的表达,只修有证据的具体问题。
- 不保存密钥、账号、敏感值,不修改现有写作 skill,不自动发布或发送成稿。
输出格式
先给可直接念的完整口播正文,再简述必要修改、事实缺口、实际模型、是否发送继续和验收状态。模型身份只能记录页面可见标签与降级提示,不能由模型自述推断。
用户要求落盘时按指定任务目录连续编号保存;非 Markdown 原始响应和验证数据放工具目录。区分 草稿已返回、完整性通过、事实审核通过、用户认可。首版为试用版本,跑通一次不代表稳定提升写作效果。
已遇到的故障
| 实际情况 | 处理 |
|---|---|
| 中文输入“继续”被改变成其他字符 | 发送前全文回读,用文档支持的替代输入修正后再发 |
| Flash 将半篇稿和另一版完整稿拼在一起,第二个开始标识紧贴中文 | 检查所有标识出现位置,拒绝拼接正文,定点请求一篇完整新版本 |