【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载本篇以 yomiyasu 仓库评测语料库中的一份真实样例——数据库定期维护通知的改写前后文本tests/corpus/yomiyasu_rewritten/04_slack_announce_sonnet_default.md——为主轴逐段拆解该 Agent Skill 如何把 LLM 生成的日语通知文体改写为自然、可读、立场清晰的日语。读完本文你将掌握 yomiyasu 对お知らせ決まり类文档的核心改写手法主述明确化、段落重组、装飾記号排除、文末与立场统一并学会用仓库自带的 yomiyasu_lint.py 与 yomiyasu_diff.py 验证改写结果。一、这份文档在语料库中的定位仓库的tests/corpus/下按五类分组保存了同一批写作场景的多个变体文件名规则为序号_场景_模型_语气目录含义tests/corpus/raw_aiLLM 直接生成的原始文本未推敲tests/corpus/blacklist_aiLLM 生成后仅做了禁止词替换类处理的文本tests/corpus/yomiyasu_rewritten应用 yomiyasu 完整改写后的文本tests/corpus/human人类撰写的参考文本tests/corpus/edge_cases比喩動詞等边界用例04_slack_announce_sonnet_default.md属于04 号场景Slack 频道维护通知由 Claude Sonnet 以 default默认语气生成。关联文档是其中的yomiyasu_rewritten 版本即 yomiyasu 的最终输出同场景还保留了 raw_ai 原文、blacklist_ai 变体 以及带_bl后缀的改写变体便于三方对照。全部评测汇总记录在 tests/corpus/benchmark_results.json 中。二、改写后的完整文本关联文档全文关联文档的正文如下这是一份典型的決まりお知らせ立场文档——由基础设施团队向频道读者发布维护安排与行动请求【重要】データベース定期メンテナンスに伴うサービス一時停止のお知らせ インフラチームは今週末にデータベースの定期メンテナンスを実施し、作業中は本番サービスを一時停止します。業務に影響がある方はご確認ください。 日時は10月4日日02:00から06:00までの予定です。作業が早く終われば、停止時間は短くなります。 対象は本番環境の全サービスで、管理画面とAPIも含みます。停止中はログインとデータの参照、更新ができません。ステージング環境は通常どおり使えます。 作業内容は、ストレージの最適化、インデックスの再構築、マイナーバージョンの適用です。データを削除したり移行したりする作業はありません。 次の3点をお願いします。停止時間帯に予定しているバッチ処理やデプロイは、前後の日程へ移してください。お客様への案内が必要な場合は、カスタマーサポートチームへ事前に共有してください。未保存のデータが残らないよう、10月3日土中に入力内容を保存してください。 インフラチームは、作業の開始時と完了時にこのチャンネルへ投稿します。復旧後に不具合を見つけた場合は、このスレッドに返信するか、#infra-supportへ連絡してください。作業が想定より長引く場合も、このチャンネルで随時お知らせします。 ご不便をおかけしますが、ご協力をお願いします。 インフラチーム这份文本在信息上与 AI 原文完全同构维护主体インフラチーム、时间10月4日02:00〜06:00、对象范围本番全服务、作业内容存储优化/索引重建/小版本、三点请求、通知渠道与联系方式、署名。没有任何新增事实也没有删减必要信息——这正是 yomiyasu 的情報の不増補原则见 SKILL.md 第 1 节。三、逐段对比从 AI 原文到改写后将关联文档与其 AI 原文tests/corpus/raw_ai/04_slack_announce_sonnet_default.md逐段对照可以看到改写并非换词而是发生在主述结构、段落组织与文末立场层面。3.1 开头补主语、理顺因果AI 原文今週末にデータベースの定期メンテナンスを実施します。作業中は本番サービスを一時停止するため、業務への影響がある方はご確認ください。yomiyasu 改写インフラチームは今週末にデータベースの定期メンテナンスを実施し、作業中は本番サービスを一時停止します。業務に影響がある方はご確認ください。这里做了两处关键调整补主语句首补上「インフラチームは」。AI 原文通篇省略动作主体日语虽常省主语但在公告类文书中谁执行维护是核心信息。SKILL.md「主語と目的語の明確化」一节规定从原文与上下文能确定的主体应在必要位置明示。通知末尾的署名「インフラチーム」为补足提供了原文依据不属于凭空创作。因果句改为并列顺接原文「実施します。…一時停止するため、…ご確認ください」用「ため」把结果与请求硬绑在一起读来有把读者行动归因于维护动作的拧巴感。改写为「実施し、…一時停止します」——先述事实决まり/予定再独立提出「業務に影響がある方はご確認ください」的请求两句各司其职。这符合 SKILL.md「文の働き説明・依頼・予定を区別し、働きに合わない文末だけを直す」的规则。3.2 时间表达去装饰、统一格式AI 原文日時は10月4日(日)【02:00〜06:00】の予定です。改写后日時は10月4日日02:00から06:00までの予定です。三处细节对应 SKILL.md「装飾記号の排除と太字の表示」与「文長と読点の調整」半角括号(日)统一为全角日消除混排删除【02:00〜06:00】这类装饰性方括号——它不承载额外信息属于 LLM 常见的强调式排版〜改为02:00から06:00まで的自然叙述让起止时间以普通人写公告的方式表达而不是保留表格符号残留。3.3 请求部分消解予告句、箇条書き转地の文AI 原文お願いしたいことは3点あります。 ・停止時間帯に予定しているバッチ処理やデプロイは、前後の日程へ移してください。 ・お客様への案内が必要な場合は、カスタマーサポートチームへ事前に共有してください。 ・作業前に未保存のデータが残らないよう、10月3日(土)中に入力内容の保存を済ませてください。改写后次の3点をお願いします。停止時間帯に予定しているバッチ処理やデプロイは、前後の日程へ移してください。お客様への案内が必要な場合は、カスタマーサポートチームへ事前に共有してください。未保存のデータが残らないよう、10月3日土中に入力内容を保存してください。这是全文改写力度最大的一处同时体现了三条规则「予告だけの文」的消解「お願いしたいことは3点あります」是一句不携带内容的空壳预告SKILL.md「段落と文の論理構造」第 2 条明确要求处理这类句子。改写为「次の3点をお願いします」——预告与请求合并为一句而3点的权重数量提示保留在述语「お願いします」中读者依然知道接下来是三件事。箇条書き → 地の文三个・项目被转为连续的三句地の文。SKILL.md 规定只有並列関係が明確で読みやすい箇条書き才保留这里三项请求逻辑并列但总量仅三句转成地の文后以「〜してください」统一收束不破坏并列关系同时消除了 LLM 高频的列表化痕迹。三条请求的语气依頼原样保留没有把「してください」换成别的语气——这正是「言い切りの強さ」保持的体现。动词直接化「入力内容の保存を済ませてください」→「入力内容を保存してください」。SKILL.md「主語と目的語の明確化」指出动作名词化加「〜を行う」式表达不如「对象动词」直接自然这里同理「保存を済ませる」回退为动词「保存する」动作与对象直接相接。同时「作業前に」被删除——这个时间限定已由前段停止時間帯的语境涵盖属于冗余修饰的清理而非信息削减。3.4 后半段条件句补主语、空白整理AI 原文作業の開始時と完了時は、このチャンネルに投稿します。復旧後に不具合を見つけた場合は、このスレッドに返信するか、#infra-support へ連絡してください。想定より長引く場合も、このチャンネルで随時お知らせします。改写后インフラチームは、作業の開始時と完了時にこのチャンネルへ投稿します。復旧後に不具合を見つけた場合は、このスレッドに返信するか、#infra-supportへ連絡してください。作業が想定より長引く場合も、このチャンネルで随時お知らせします。首句补主语「インフラチームは」通知中谁在开始/完成时投稿由签名可确定补上后动作主体清晰「に投稿します」→「へ投稿します」的助词微调让去向更明确。「想定より長引く場合も」补上「作業が」让条件的主语显式化读者不必回读上一句才能推断什么会变长。这对应 SKILL.md「修飾・条件・並列の関係」——条件句的挂靠对象必须能一眼追踪。#infra-support へ去掉半角空格SKILL.md 规定英单词或数值前后的空白仅在元格式/指定风格要求时保留此处空格的删除不是机械规则而是因为#infra-support是频道标识符与后文的「へ」之间无需空格。3.5 一处容易被忽略的严谨化AI 原文停止中はログインやデータの参照、更新ができません。改写后停止中はログインとデータの参照、更新ができません。助词や列举中的一部分改为と全部列举。原文用「や」会让人以为登录和数据操作只是不可用功能中的一部分而实际公告要表达的是登录、数据参照、更新全部不可用。改成「と」后列举范围精确闭合避免读者误读存在其他可用操作——这是 SKILL.md「操作と結果の対応」的典型应用哪些操作在什么条件下不可用必须能让读者区分清楚。同样严谨化的还有作业内容说明原文「データの削除や移行はありません」有歧义是没有数据还是没有删除/迁移操作改写为「データを削除したり移行したりする作業はありません」用动词明确不存在的是哪种作业消除了名词化造成的指代模糊。四、改写背后的规则体系这份样例对应了 SKILL.md 的哪些条款关联文档不是孤立的范文而是 SKILL.md 规则的执行产物。它涉及的条款可以归纳为四组意味の保持最优先规则改写前后主张何时停、停什么、做什么、读者要做什么、比重三点请求的并列关系、言い切りの強さ「予定です」「できます」「してください」的强弱均未改变、文の働き事实说明用「〜します」请求用「〜してください」全部保持一致。SKILL.md 明确其他原则只在不动这四点的范围内适用。文書の立場と文末本文属于決まり立场向读者传达规则/安排的公告动作主体是遵循指示的读者与制定方略的写手。改写遵循该节要点書き手側的予定与实动作「インフラチームは…投稿します」保留「〜します」对读者的请求保持「〜してください」没有把请求弱化为「〜しましょう」或强化为义务表达。段落と文の論理構造原文的三条请求以箇条書き承载改写后转为地の文并在开头用「次の3点をお願いします」承接——既消除了无内容的预告句也保持了3点的数量提示同时「作業前に」这类可由语境推断的冗余被清理。装飾記号の排除【02:00〜06:00】的装饰方括号与〜范围记号被替换为自然叙述半角括号统一为全角#infra-support前后的多余空格被整理。若要进一步阅读仓库还提供了更细的规则语料references/slop-catalog.mdAI 特有语汇/构式目录、references/domains/business.md业务文书的领域特化规则以及 references/gemini-syntax.md构文转换原则。五、用仓库自带工具验证改写结果SKILL.md 的 Step 3 / Step 4 规定改写后应运行两个静态检查工具均为 Python 标准库实现无需第三方依赖5.1 yomiyasu_lint.pyAI 臭与格式静态检查python3 scripts/yomiyasu_lint.py tests/corpus/yomiyasu_rewritten/04_slack_announce_sonnet_default.md该脚本源码见 scripts/yomiyasu_lint.py从 markdown_visibility.py 解析 Markdown 结构后检查AI 特有的比喩動詞、过度的太字/箇条書き、絵文字、文末コロン、同一文末连发以及bold_not_rendered按 GFM 与 CommonMark 规则模拟 ** 是否能正确渲染为太字。输出如 AIっぽさ 検査レポート (スコア: 100/100) ・文字数: 574 | 行数: 9 ・太字頻度: 1,000字あたり 0.0 個 (推奨: 2.0以下 / 警告: 3.0超) ・箇条書き比率: 0.0% (推奨: 15%以下 / 警告: 25%超) ------------------------------------------------------------ [PASS] 設定された検査ルールによる指摘はありません。支持--strict有警告则退出码 1可接入 CI/预提交钩子与--json两种模式。5.2 yomiyasu_diff.py改写前后的语义差分检查python3 scripts/yomiyasu_diff.py \ tests/corpus/raw_ai/04_slack_announce_sonnet_default.md \ tests/corpus/yomiyasu_rewritten/04_slack_announce_sonnet_default.md \ --stance決まり脚本实现见 scripts/yomiyasu_diff.py它把改写前后的文本做六类对比言い回し种类的增减依頼/勧誘/義務/評価/可能等通过MARKERS正则表统计、新增/消失的词汇、箇条書き→地の文等结构变化、文头接续词与予告だけの文、文末种类与文档立场的一致性按勧め/決まり/説明三种立场分别设旗标、太字渲染问题。--stance決まり时脚本会专门检查决まり类文档中是否混入了勧め〜ましょう或評価〜が重要です文末。对该样例原文与改写后均为敬体统一、无勧誘/評価混入脚本给出的检查点主要落在请求句均为依頼「〜してください」、实动作说明均为「〜します」这一正当分布上。需要强调的是diff 脚本输出的是复核候选而非裁决——它提示哪些地方需要人确认不能自动判定语义等价最终判断仍须回到 SKILL.md Step 4 的人工通读。六、评测数据静态满分不等于无需改写查看 tests/corpus/benchmark_results.json 中该场景的评测记录会发现一个值得注意的事实文件naive_matcheslookaround_findingsscoreraw_ai/04_slack_announce_sonnet_default.md00100blacklist_ai/04_slack_announce_sonnet_default.md00100yomiyasu_rewritten/04_slack_announce_sonnet_default.md00100也就是说这份 AI 原文在静态 lint 指标上已经是 100 分——它没有比喩動詞、没有过度的太字/箇条書き、没有絵文字。而 yomiyasu 依然对其进行了全面改写。这恰恰印证了项目设计文档 README.md 与 evals/comparison_benchmark.md 反复强调的立场静的検査で指摘がないことも、意味の保持・読みやすさの確認は区別してください。静态检查无指摘不等于已确认意义保持与可读性。AI 臭不止于禁止词命中。这份样例的 AI 痕迹藏在主述省略、空壳预告句、装饰方括号、名词化动作、条件句主语缺省这些语义与结构层面而 lint 脚本只能捕捉表层的正则命中。这也是 yomiyasu 与禁止语替换路线的根本区别——后者对应语料库blacklist_ai目录只做表层替换无法处理这类结构性不自然。七、如何在仓库中复现与本场景联动通读规则从 SKILL.md 开始唯一规则入口配合 references/domains/business.md 的業務文書领域规则即可复现本文档的改写判断依据。复现改写把 tests/corpus/raw_ai/04_slack_announce_sonnet_default.md 的文本交给已安装 yomiyasu 的编码 Agent安装方式见 README.md 的npx skills add nanaism/yomiyasu并在提示中注明社内 Slack へのお知らせとして読みやすくして即可。验证输出依次运行上文yomiyasu_lint.py与yomiyasu_diff.py --stance決まり再对照关联文档的人工终稿观察改写思路的异同。参考同类同目录下04_slack_announce_sonnet_casual.md、04_slack_announce_sonnet_formal.md及其_bl变体展示了同一场景在不同语气下的改写差异可作为批量比对素材。结语一份 15 行的 Slack 维护通知在 yomiyasu 的改写中经历了主语补全、空壳预告句消解、箇条書き转地の文、装饰符号清除、助词精确化、条件句主语显式化六类手术而信息量与请求强度分毫未动。这份样例的价值在于它示范了 yomiyasu 最核心的方法论AI 生成日语的不自然主要不在词汇而在结构改写的边界由意味の保持与情報の不増補两条铁律划定一切技巧都在此范围内生效。配合 yomiyasu_lint.py 与 yomiyasu_diff.py 的静态验证这份工作流可以完整复制到任何社内公告/维护通知类日语文书的推敲中。赞分享【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载相关推荐yomiyasu 实战拆解把 AI 生成的 Slack 维护公告推敲成自然日语yomiyasu 实战拆解把 AI 生成的 Slack 维护公告推敲成自然日语 导读 本文以 yomiyasuよみやす开源仓库中一份真实的推敲语料—— 0yomiyasu 实战把 AI 生成的 Slack 维护公告推敲成自然日语yomiyasu 实战把 AI 生成的 Slack 维护公告推敲成自然日语 这篇技术文章以 yomiyasuよみやす仓库中保存的 Slack 维护公告推敲yomiyasu 实战拆解AI 生成的 Slack 维护周知文如何被推敲成自然日语附语料对比与工具验证yomiyasu 实战拆解AI 生成的 Slack 维护周知文如何被推敲成自然日语附语料对比与工具验证 导读 本文以 yomiyasu 仓库语料库中的一份上一篇Hermes WebUI 远程访问完全指南SSH 隧道、Tailscale 与手机端安全接入下一篇MongoDB 数据加载器集成测试指南基于 Docker 与 workspace/datalake 架构的 Data Formulator 验证方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考