ru-text
为 AI 代理提供的俄语文本质量技能:清理机器味、规范排版、执行编辑标准并给出 0–10 评分。
- Star 数
- ★ 289
- 最近更新
- 10 天前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 53/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code
- 开始前需要
- 典型场景
- 内容团队让代理起草俄语文章后,先跑一遍 ru-text 清掉"Отличный вопрос!"式开场与虚假对照再发布。
- 主要局限
- 仅针对俄语,其他语种完全用不上。
- 源码审查
- 53/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
ru-text 是一个面向 AI 代理的俄语校对技能,核心用途是清理大模型生成的"神经垃圾"(neuroslop)、统一排版、消除公文体,并按信息风格与编辑规范修整文本。它由 10 份按需加载的参考手册组成,累计 2000 多个语言原子(规则、"差 → 好"对照、词条与例外)。使用方式是在 Claude Code、Codex/ChatGPT、Cursor、GitHub Copilot、Gemini CLI 等宿主中安装技能,代理在写作时静默应用排版规则,在用户要求时给出带引文和规则依据的修改清单。它还提供五维度 0–10 分评分(scoring.md),并可说明自身未衡量的项目,如事实准确性、受众匹配与作者声音。技能不做网络请求,不采集数据,也不会在未经请求时改写用户文件。
技能在代理会话启动时加载:常驻上下文只有一个 4 KB 文件(排版表加停用词开头),其余手册按需读取。用户说"校对"时,它读取全部语料,返回修改后的文本与逐条清单,每条附引文和所依据的规则。它检查排版(引号、破折号、不间断空格、数字分组、缩写、百分号紧贴数字、省略号空格)、17 类机器文本特征(如"好问题!"、自夸简洁、宣称诚实、空洞开场、虚假对照),并区分合法语境(引文、法律套话、确实三项的三段式)。公文体被还原为动词与责任主体,但不会编造姓名。UX 文本按"按钮命名动作、错误说明发生了什么与下一步"处理;商务邮件按"主题先说事"处理。评分模式调用 scoring.md 的五个维度并给出 0–10 分,最高档"Эталонный"与"Хороший"不会授予仍是聊天记录或为搜索引擎而写的文本。Claude Code 另有 /ru-text:ru-check 与 /ru-text:ru-score 两个命令,前者配置为 model: sonnet、effort: medium。
- 内容团队让代理起草俄语文章后,先跑一遍 ru-text 清掉"Отличный вопрос!"式开场与虚假对照再发布。
- 产品经理编写俄语界面文案,用 ux-writing.md 的规则校对按钮标签、错误提示与空状态。
- 商务人士写完俄语邮件,让代理"вычитай",得到改后文本和修改依据清单,逐条决定是否接受。
- 编辑在发布前要求"Оцени этот текст по ru-text",得到 0–10 分与逐行可核查的引文和规则。
- 开发者把 ru-text 装进 Claude Code 或 Codex 作为常驻技能,让代理自己写俄语文档时静默应用排版规则。
- 译文或外来文本需要保留原貌时,技能只提意见不修改引用与代码片段。
如何安装或部署这个 Agent?
最简方式是让代理自行安装,把下面这句话发给它:
Установи навык https://github.com/talkstream/ru-text глобально и вызывай его, когда работа идёт над качеством русского текста: вычитка, типографика, очистка от нейрослопа, редактура, UX-тексты, деловая переписка — или по прямому упоминанию ru-text.也可以用命令行安装器。装入项目的全部三个技能:
npx skills add talkstream/ru-text只装 ru-text 一个技能到自己的目录:
npx skillsbd add talkstream/ru-text/ru-textChatGPT 用户可直接在插件目录中打开 ru-text 卡片并点击"+",无需上述命令。安装后需开启新会话,代理才会加载技能。
如何使用这个 Agent?
先开新会话,然后给代理一段真实文本并说"вычитай",正常返回应为修改稿加修改清单。在 Claude Code 中可直接用命令:
/ru-text:ru-check评分时:
/ru-text:ru-score其余平台用自然语言即可,例如"Оцени этот текст по ru-text"。可用 /model opus 切换模型。停用方式:Claude Code 用 /plugin,其他平台删除技能目录。更新没有自动机制,需在 GitHub 上 Watch → Custom → Releases 接收版本通知后手动更新。
这个 Agent 有哪些优点和局限?
- 每条修改都附引文与规则依据,可逐条核查和反驳,不是黑箱改写。
- 常驻上下文仅 4 KB,10 份参考手册按需加载,对上下文预算友好。
- 对 17 类机器文本特征都写了合法语境例外(引文、法律套话、真实三项),减少误报。
- 明确边界:不改作者声音、不动引用与代码、不静默改写文件、不做网络请求。
- 覆盖范围超出普通校对,包含 UX 文案、商务邮件、落地页与文档结构。
- 语料规模由
tools/extract-atoms.sh脚本计算,避免手写数字漂移。
- 仅针对俄语,其他语种完全用不上。
- 没有自动更新机制,需自行关注 Releases 并手动重装;Claude Code 社区市场版本可能落后数月。
- 规则是作者对俄语排版与编辑标准的个人理解,并非官方标准,可能有争议。
- 快速自检模式刻意不评判机器文本特征(例外只存在于完整手册中),因此日常静默清理不如显式校对彻底。
- 在 Claude Code 中 ru-check 命令绑定 Sonnet,若不可用需手动切到 Opus。
- 尚无浏览器扩展和 Telegram 机器人,README 中列为未来计划。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| ru-text 当前 | 53 · 缺口较多 | — | ★ 289 | 10 天前 | Shell | ChatGPT · Codex · Claude Code |
| Patina 多语言文本润色器 | 83 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 384 | 1 个月前 | JavaScript | Codex · Claude Code |
| OH Story — 网文写作全流程 Skill 包 | 75 · 表现良好 | Agent 插件 / 技能免费 + 模型费 | ★ 8.3k | 1 天前 | Python | Codex · Claude Code |
| OpenDraft 学术论文起草引擎 | 81 · 表现良好 | 命令行工具免费 + 模型费 | ★ 523 | 1 天前 | Python | Codex · Claude Code · OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 与 SECURITY.md 声明该技能为纯静态 Markdown、无网络请求、不收集数据,且明确“不静默改写文件、仅在用户直接要求时编辑”,用户确认与数据流透明度有据可依(2)。但敏感数据处理仅停留在“不收集数据”的断言,未见对用户粘贴文本如何留存/日志化的具体说明(1);依赖安全方面仅见 CI 对 actions/checkout 的 SHA 固定,未见对 npx skills/skillsbd 等安装链的完整性校验(1);外部效应与回滚仅靠“删除技能目录/`/plugin`”一句话,缺少版本回退或变更撤销的具体机制(1);来源归属在 README 与 sources.md 中有明确署名与免责声明(2)。
README 自述曾出现版本号、目录条目数(97 vs 92)漂移,现已用 tools/check-version.sh、check-dogfood.sh 等 CI 门禁约束,自洽性有机制支撑(2)。但依赖可用性仅靠“交给 agent 一句话安装”与第三方 npx 工具,未固定版本或校验来源(1);失败信息方面仅提示“没有清单说明技能未加载”,缺少具体错误码或诊断路径(1)。
README 明确列出 Claude Code、Codex、Cursor、Copilot 等多平台,并给出按场景(校对、评分、UX 文案、商务信函)的触发措辞,受众与场景覆盖充分(2);能力边界明确声明不评判事实准确性、受众契合、作者声音、原创性(2);触发精度通过安装句与“直接点名 ru-text”双重条件控制,并允许用户收窄/放宽(2);环境适配给出 Claude Code 命令与其它平台“用词即可”的差异说明(2)。
信息架构清晰:README、INSTALL、CHANGELOG、sources、10 个 reference 文件分层(2);安装说明详尽,含一句话安装、npx 命令、ChatGPT 插件卡片与更新路径(2);命名稳定性存在风险——README 自述“版本号曾在两个 README 中错位、目录条目数漂移”,说明命名/数字曾不稳定,虽有门禁但历史问题可见(1);示例与 FAQ 丰富,含五句反例与改写对照(2);已知局限明确列出未测量维度与“一次性安装无更新机制”(2);MIT 许可证完整(2);版本与 CHANGELOG 有 2.10 变更摘要(2);维护责任为单一维护者、best-effort,且发布者身份未经 FollowAgents 验证,故仅给 1。
输出可用性高:每次修改给出片段与规则依据,评分 0–10 附引用与规则,可逐行核对(2);边际价值明确——针对俄语排版、官腔与 17 种“神经垃圾”特征,填补通用 agent 的空白(2);成本收益方面 README 自述常驻 4KB、按需加载 reference,但“说 вычитай 就读整个语料”可能带来较大上下文开销,且未给出量化对比(1)。
claim_traceability 较强:README 给出 tools/extract-atoms.sh 计数命令、10 个 reference 文件路径、sources.md 归属(2);但跨源佐证有限——多数规则仅由作者自述与二手书目支撑,未见独立第三方校验或对照测试(1);事实与推断分离较好:明确区分“规则”与“作者理解”、声明来源作者未背书、评分不涵盖事实准确性(2)。
- 发布者身份未经 FollowAgents 验证,维护为单一维护者 best-effort,长期更新与安全响应无 SLA。
- 安装依赖第三方 npx 工具(skills/skillsbd),未见版本固定或完整性校验,供应链风险需自行评估。
- README 自述曾出现版本号与目录条目数漂移,命名/数字稳定性有历史问题,虽有 CI 门禁仍应核对实际版本。
- 一次性安装无自动更新机制,需手动关注 releases 并重装,旧版本可能长期滞留。
- 评分仅覆盖语言质量,不评判事实准确性、受众契合与原创性,不应作为内容正确性的依据。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2.10.10 ru-text 2.10.10
发布说明摘录
Fixed - editorial-punctuation.md, «When comma before "что" is NOT needed»: the stacked-conjunctions row said «without "то"» while its explanation said «when "то" follows», so a literal reading dropped the required comma in «Я знаю, что, если он придёт, всё решится». The row is now two: no comma between «что» and «если» when «то» follows, a comma when it does not. Contributed by @MaxRyabov (#31). …在 GitHub 查看 ↗ -
v2.10.9 ru-text 2.10.9
发布说明摘录
Changed - .claude-plugin/plugin.json carries documentationUrl, supportUrl, privacyPolicyUrl and termsOfServiceUrl again (removed in 2.10.6). Anthropic's directory fills the listing's Documentation, Support, Privacy policy and Terms of service from these fields (Claude Code plugins reference, «Directory listing fields»); its policy check still reports them as unrecognized and says they can stay.在 GitHub 查看 ↗ -
v2.10.8 ru-text 2.10.8
发布说明摘录
Internal - docs/roadmap-v3-grammar.md gains a backlog entry, not yet ranked: gapping across numerals that govern different forms — «на 44 года; в худшем темпе — на 18» needs «на 18 лет». The corpus has no rule for it yet; D.2 checks agreement only where the noun is written, and I.2 covers the same mechanism for verbs. The entry's closed trigger requires the omitted noun to inflect, so an invariable unit such as «ГБ» («156 ГБ … 153») does not fire it.在 GitHub 查看 ↗