【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载代码评审反馈是 AI 生成最容易翻车的文体之一业务规则判定、SQL 与外部 API 调用混写在一个方法里评审意见既要讲清架构问题又要给出可执行的改造建议还得分清说明现状与提出要求两种文句功能。yomiyasu 在 tests/corpus/yomiyasu_rewritten/07_code_review_sonnet_formal_bl.md 中留下了一段正式文体formal的推敲样本本文以它为解剖对象结合 SKILL.md 的转换原则与 scripts/build_corpus.py 的语料生成机制完整还原AI 生成文 → yomiyasu 推敲文的改写过程并延伸到服务层、仓储层、网关层的分层设计原理帮助你既学会用 yomiyasu 处理此类文本也理解评审意见背后的架构常识。案例定位语料库中的代码评审反馈样本该样本属于仓库tests/corpus中8 个实务场景 × 3 种文体语料矩阵的第 07 号主题。在 scripts/build_corpus.py 中该主题的生成提示词是サービス層にDBアクセスや外部API呼び出しのビジネスロジックが混在しているコードに対する、責務分離を促すコードレビューのフィードバックコメント400字程度を作成してください。围绕同一主题语料库保存了三个版本形成完整的对照链目录文件角色tests/corpus/raw_ai07_code_review_sonnet_formal.md未加约束的 AI 原始输出tests/corpus/blacklist_ai07_code_review_sonnet_formal.md加入禁用 AI 味词汇指令后的输出tests/corpus/yomiyasu_rewritten07_code_review_sonnet_formal_bl.md对 blacklist 版应用 yomiyasu 推敲的结果本文关联文档文件名后缀_bl表示改写输入取自blacklist_aiformal表示系统提示词要求エンタープライズシステムのシニアアーキテクト。堅牢で形式的な文体。这是理解整篇文章的坐标系yomiyasu 处理的对象恰恰是已经被禁用词约束过的 AI 输出说明它的价值不在替换个别词汇而在重构句法与文脉。推敲后的目标文本关联文档全文以下为yomiyasu_rewritten/07_code_review_sonnet_formal_bl.md的完整内容是本文讨论的唯一主体本サービスクラスでは、業務ルールの判定、SQLの発行、外部APIの呼び出しを同じメソッドに書いています。この構成だと、業務ロジックを検証するためにDBや外部サービスを起動しなければならず、単体テストを書きにくくなります。外部APIの仕様やスキーマが変わるたびに、業務ロジックも修正する必要がある点も、保守上の問題です。永続化処理はリポジトリ層に、外部連携はゲートウェイ層に切り出し、サービス層はインターフェース経由でそれらを呼び出すように改めてください。こうすれば、モックを使って業務ロジックを単体テストできます。あわせて、トランザクション境界はサービス層で管理し、リトライやタイムアウトの制御は外部連携の実装側にまとめることを推奨します。翻译并拆解其技术要点这段评审反馈由三个层次组成现状指摘服务类Service クラス的同一方法内混写了业务规则判定、SQL 发布、外部 API 调用三种职责后果分析验证业务逻辑必须先启动 DB 和外部服务导致单元测试难写外部 API 规格或 Schema 每次变更都牵动业务逻辑修改带来维护负担改造建议持久化永続化处理迁往 Repository 层外部协作外部連携迁往 Gateway 层服务层通过接口インターフェース调用二者从而可用 Mock 进行单元测试同时推荐事务边界トランザクション境界留在服务层管理重试与超时控制收拢到外部协作实现侧。三版对比yomiyasu 到底改了什么将推敲结果与改写输入blacklist 版、未加约束的原始输出raw 版并排对照能精确看出每个转换动作。与 blacklist 版改写输入的对比blacklist 版原文为本サービスクラスでは、業務ルールの判定、SQLの発行、外部APIの呼び出しが同一メソッド内に記述されています。この構成では、業務ロジックの検証にDBや外部サービスの起動が必要となり、単体テストが困難です。また、外部APIの仕様変更やスキーマ変更が、業務ロジックの修正を伴う点も保守上の課題です。永続化処理はリポジトリ層に、外部連携はゲートウェイ層に分離し、サービス層はインターフェース経由でそれらを呼び出す構成へ改めてください。この分離により、モックを用いた業務ロジックの単体テストが可能となります。あわせて、トランザクション境界はサービス層で管理し、リトライやタイムアウトの制御は外部連携の実装側へ集約することを推奨します。逐处差异如下改写前blacklist 版改写后yomiyasu 版对应原则記述されています状态描述被动書いています动作描述主动主述对应、动作主体明确この構成では、〜となり、単体テストが困難です名词化堆叠この構成だと、〜しなければならず、単体テストを書きにくくなります动词谓语句サ変名詞の数珠つなぎを動詞述語へ戻す仕様変更やスキーマ変更が、業務ロジックの修正を伴う仕様やスキーマが変わるたびに、業務ロジックも修正する必要がある条件·触发关系具体化分離し、〜構成へ改めてください切り出し、〜呼び出すように改めてください动作具体化避免抽象名词この分離により、〜可能となりますこうすれば、モックを使って〜できます因果连词收拢去形式化集約することを推奨しますまとめることを推奨します比喩·生硬语平实化与 raw 版无约束 AI 输出的对比raw 版是未被任何约束干预的原始输出结构上采用三问题分列 提案的展开方式而 yomiyasu 版压缩为连续叙述。raw 版中責務の分離の観点から三つの問題があります这种只预告不落地的空泛句被直接消解依存性注入を採用すれば、テスト容易性と差し替え可能性も確保できます这句锦上添花的承诺也被删除因为原文并未要求写入 DI 的额外收益。这符合 SKILL.md 中情報を勝手に足さない不自行添加原文没有的信息的最高优先原则。改写手法逐条解析yomiyasu 七原则的落地README.md 记录了 yomiyasu 的 7 条转换原则本节以该样本逐条印证。1. 主述·修饰·条件的点检原句業務ロジックを検証するためにDBや外部サービスを起動しなければならず中动作主是隐性的测试者/开发者。yomiyasu 通过起動しなければならず保留了原文必要性的言说强度没有擅自补充開発者は这样的主语——因为原文并未明示主体。这与 SKILL.md 中原文や提供文脈から分かる主体を必要な位置で示し、元にない担当者を創作しない完全一致。2. 文的功能与文体保持这是本样本最精妙的一处。整段文本有两种文の働き句子功能说明型现状·后果句末为書いています書きにくくなります問題ですできます要求/建议型改造指令句末为改めてください推奨します。yomiyasu 完整保留了这种功能分层没有把説明句改成要求句也没有把〜してください的请求强度削弱为〜しましょう。对照 SKILL.md 中文書の立場と文末一节代码评审反馈属于勧め建议立场动作发出者是受评审的开发者因此改めてください与推奨します的组合是立场正确的。3. 拟人化整理原文中サービス層はインターフェース経由でそれらを呼び出す是架构概念的动作描述属于客观的系统行为叙述而非给概念赋予意志的拟人化因此 yomiyasu保留了サービス層は〜呼び出す的表述。这正是 SKILL.md 强调的边界道具や仕組みの働きを客観的に述べている文はそのまま残します。4. 比喩を平易な言葉へblacklist 版中集約するaggregate一词带有抽象隐喻色彩yomiyasu 改为まとめる归拢在保持集中管理含义的同时更口语化。类似的切り出し切出取代分離し分离把架构动作从名词化状态还原为具体操作。这些都是 references/domains/business.md 中比喩をふだんの言葉に直す的典型应用。5. 前置き·否定対比の役割確認raw 版的責務の分離の観点から三つの問題があります属于预告性前置yomiyasu 版直接删除因为后续内容并未按第一、第二、第三展开blacklist 版本就没有分列删除后主张与比重不受影响。这与前置きを削るのは、削っても主張や比重が変わらない場合だけ的原则严格吻合。6. 情報を勝手に足さない最明显的验证是 raw 版末句依存性注入を採用すれば、テスト容易性と差し替え可能性も確保できます。改写输入blacklist 版中没有这一句yomiyasu 版也没有补回。推敲过程没有把通过接口调用自行扩写成采用依赖注入杜绝了越权添加信息。7. 文長·読点·装飾の調整对照 README.md 的平均文長30〜45文字、1文の読点0〜2個目安本样本的单句长度适中以この構成だと、〜書きにくくなります为例全句约 45 字、1 个读点处于推荐区间永続化処理はリポジトリ層に、外部連携はゲートウェイ層に切り出し、〜改めてください通过成对的〜は〜に结构建立平行节奏读点起的是对照分组作用而非装饰。全文没有出现 em dash、装饰性文末冒号与多余加粗符合装飾記号の排除规则。技术实质这段评审反馈讲的分层架构是什么要让这篇文章不只停留在推敲层面还需把评审意见背后的工程原理讲透——这也是推敲结果质量的地基。服务层混写为何有害业务规则判定 SQL 发布 外部 API 调用同处一个方法意味着验证业务逻辑必须真实启动 DB 与外部服务。单元测试因此退化为集成测试环境搭建成本高、执行慢、外部依赖抖动会导致测试不稳定。这正是语料主题生成词中責務分離を促す的指向。Repository / Gateway / 接口三层拆解Repository 层负责永続化処理SQL 发布、ORM 操作把数据访问细节与业务规则隔离Gateway 层负责外部連携第三方 API 调用把外部协议、Schema 变化圈定在网关实现内部服务层只保留业务规则判定通过接口インターフェース声明对 Repository 与 Gateway 的依赖运行时注入具体实现。这样拆分后测试代码可以用 Mock 替身替换真实 Repository/Gateway业务逻辑的单元测试不再触碰 DB 与外部网络。这也是该样本中こうすれば、モックを使って業務ロジックを単体テストできます的完整论证链条。事务边界与重试/超时的归属样本末句给出了两条关键推荐トランザクション境界はサービス層で管理事务需要横跨多个仓储操作多表更新、补偿逻辑只有服务层能界定一个业务用例的边界因此事务应开在服务层而非埋在某个仓储方法内部リトライやタイムアウトの制御は外部連携の実装側にまとめる重试策略退避算法、最大次数与超时阈值只与外部 API 的稳定性有关属于 Gateway 的领域知识收拢到外部协作实现侧避免每个调用方各自实现导致策略漂移。这两条建议在语料生成提示词中并未逐条给出而是模型基于架构常识自然产出的yomiyasu 的职责是保证这些技术要点以准确、自然的日语传达而非发明或删改它们。语料库的构建机制这段文本从哪来tests/corpus不是手写语料而是由 scripts/build_corpus.py 通过 Claude CLI 按8 主题 × 3 文体矩阵程序化生成生成前会删除旧文件仓库只读使用时不运行raw_ai用RAW_PROMPT_PREFIX要求只输出正文 各主题提示词直接生成blacklist_ai在提示词末尾追加BLACKLIST_PROMPT_SUFFIX禁止使用手触り解像度地味に効く静かに壊れる時間を溶かす等 AI 味词汇scripts/build_corpus.pyyomiyasu_rewritten将 raw 版与 blacklist 版分别送入YOMIYASU_REWRITE_PROMPTscripts/build_corpus.py该提示词要求复现谁/什么/怎么的统语结构、把比喻动词展开为字面技术处置、剥除无据加粗、合并多余列表、消除否定对比、排除装饰符号等blacklist 版的输出以_bl后缀命名。由此可知本文关联文档是禁用词约束输出 × yomiyasu 推敲双阶段的结果它验证的是 yomiyasu 在词汇已被约束时仍能改善句法与文脉——这正是 README 所述従来のアプローチ禁止語の置き換えが抱えていた限界的对照实验。验证工具链如何客观检查这类推敲结果yomiyasu 仓库自带两个检查脚本可作为评审反馈文推敲后的客观度量手段。静态检查scripts/yomiyasu_lint.py执行方式仓库只读路径以仓库根目录为基准python3 scripts/yomiyasu_lint.py README.md python3 scripts/yomiyasu_lint.py article.md --strict python3 scripts/yomiyasu_lint.py article.md --json其检查项包括AI 味词汇SLOP_WORDS、比喻动词模式如静かに壊れる〜側に倒す時間を溶かす见 METAPHOR_VERB_PATTERNS、前置填充词重要なのはいかがでしたでしょうか、否定对比AではなくB、同一文末三连、加粗频率每千字 2.0 以下为推荐、3.0 以上为警告与列表比率15% 以下推荐、25% 以上警告。对本文样本而言推敲结果不含上述任何模式理论上可得到 [PASS] 判定。需要强调的是scripts/yomiyasu_lint.py 文档串明确声明检测结果是复查候选[PASS] 只代表无规则指摘不代表自然、意味保持或绝对可读。差分检查scripts/yomiyasu_diff.py用于对照改写前后文本核查语词增减、文末类型与立场勧め/決まり/説明变化python3 scripts/yomiyasu_diff.py 元の文.md 書き直した文.md --stance説明 python3 scripts/yomiyasu_diff.py --endings 対象文.md针对本文案例可指定--stance勧め建议立场运行核对改めてください推奨します等要求型文末是否被误改为说明型。脚本输出同样只是候选清单最终以人读判断为准。使用边界与正确姿势最后必须交代语料的适用前提避免误用evals/comparison_benchmark.md 明确声明语料中的適用後文本是过去验证时保存的输出不是当前版本的实际运行结果也不作为现行意味保持规则的合格例当时代的完整提示上下文未保留个别適用後文包含仅凭前文无法确定的条件或步骤静态检查无指摘 ≠ 语义保真。语料的定位是记录而非及格卷推敲结果的最终质量须以 SKILL.md 的意味の保持主張・比重・言い切りの強さ・文の働き四点为准绳人工复核本文关联文档可视为一份教学型样本它展示的是 yomiyasu 原则在代码评审反馈 正式文体 已约束词汇组合下的理想输出形态实际使用时请结合 references/domains/business.md 的业务文书写规范责任主体明确、条件与结果一一对应、比喩平实化进行同款推敲。通过这一份样本你可以同时掌握三件事一是 yomiyasu 处理实务文书的完整手法清单二是服务层/仓储层/网关层拆分与事务边界归属的架构常识三是用仓库自带工具客观核验推敲结果的流程——这套组合拳可以直接迁移到你的技术评审与代码审查写作中。赞分享【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载相关推荐yomiyasu 推敲实践把 AI 生成的日语代码评审评论改写成自然表达——以「服务层拆分重构」建议为例yomiyasu 推敲实践把 AI 生成的日语代码评审评论改写成自然表达——以「服务层拆分重构」建议为例 导读 本篇文章以开源仓库 yomiyasu 语料库中yomiyasu 实战把 AI 生成的日语代码评审推敲成自然日语——以服务层职责拆分建议为例yomiyasu 实战把 AI 生成的日语代码评审推敲成自然日语——以服务层职责拆分建议为例 本篇技术指南以仓库评测语料中的一篇真实样例为核心AI 生成的日yomiyasu 实战拆解将 AI 生成的代码评审意见推敲为自然日语服务层责任分离评审示例yomiyasu 实战拆解将 AI 生成的代码评审意见推敲为自然日语服务层责任分离评审示例 本篇以 yomiyasu 仓库中保存的推敲示例 tests/c上一篇Windows 11 LTSC 没有微软商店三步装回来常见报错一次说清下一篇思源宋体CN TTF 7字重免费商用装好、选对、上网页创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 yomiyasu 实战：用 Agent Skill 推敲代码评审反馈文——从分层架构指摘到自然日语表达
【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载代码评审反馈是 AI 生成最容易翻车的文体之一业务规则判定、SQL 与外部 API 调用混写在一个方法里评审意见既要讲清架构问题又要给出可执行的改造建议还得分清说明现状与提出要求两种文句功能。yomiyasu 在 tests/corpus/yomiyasu_rewritten/07_code_review_sonnet_formal_bl.md 中留下了一段正式文体formal的推敲样本本文以它为解剖对象结合 SKILL.md 的转换原则与 scripts/build_corpus.py 的语料生成机制完整还原AI 生成文 → yomiyasu 推敲文的改写过程并延伸到服务层、仓储层、网关层的分层设计原理帮助你既学会用 yomiyasu 处理此类文本也理解评审意见背后的架构常识。案例定位语料库中的代码评审反馈样本该样本属于仓库tests/corpus中8 个实务场景 × 3 种文体语料矩阵的第 07 号主题。在 scripts/build_corpus.py 中该主题的生成提示词是サービス層にDBアクセスや外部API呼び出しのビジネスロジックが混在しているコードに対する、責務分離を促すコードレビューのフィードバックコメント400字程度を作成してください。围绕同一主题语料库保存了三个版本形成完整的对照链目录文件角色tests/corpus/raw_ai07_code_review_sonnet_formal.md未加约束的 AI 原始输出tests/corpus/blacklist_ai07_code_review_sonnet_formal.md加入禁用 AI 味词汇指令后的输出tests/corpus/yomiyasu_rewritten07_code_review_sonnet_formal_bl.md对 blacklist 版应用 yomiyasu 推敲的结果本文关联文档文件名后缀_bl表示改写输入取自blacklist_aiformal表示系统提示词要求エンタープライズシステムのシニアアーキテクト。堅牢で形式的な文体。这是理解整篇文章的坐标系yomiyasu 处理的对象恰恰是已经被禁用词约束过的 AI 输出说明它的价值不在替换个别词汇而在重构句法与文脉。推敲后的目标文本关联文档全文以下为yomiyasu_rewritten/07_code_review_sonnet_formal_bl.md的完整内容是本文讨论的唯一主体本サービスクラスでは、業務ルールの判定、SQLの発行、外部APIの呼び出しを同じメソッドに書いています。この構成だと、業務ロジックを検証するためにDBや外部サービスを起動しなければならず、単体テストを書きにくくなります。外部APIの仕様やスキーマが変わるたびに、業務ロジックも修正する必要がある点も、保守上の問題です。永続化処理はリポジトリ層に、外部連携はゲートウェイ層に切り出し、サービス層はインターフェース経由でそれらを呼び出すように改めてください。こうすれば、モックを使って業務ロジックを単体テストできます。あわせて、トランザクション境界はサービス層で管理し、リトライやタイムアウトの制御は外部連携の実装側にまとめることを推奨します。翻译并拆解其技术要点这段评审反馈由三个层次组成现状指摘服务类Service クラス的同一方法内混写了业务规则判定、SQL 发布、外部 API 调用三种职责后果分析验证业务逻辑必须先启动 DB 和外部服务导致单元测试难写外部 API 规格或 Schema 每次变更都牵动业务逻辑修改带来维护负担改造建议持久化永続化处理迁往 Repository 层外部协作外部連携迁往 Gateway 层服务层通过接口インターフェース调用二者从而可用 Mock 进行单元测试同时推荐事务边界トランザクション境界留在服务层管理重试与超时控制收拢到外部协作实现侧。三版对比yomiyasu 到底改了什么将推敲结果与改写输入blacklist 版、未加约束的原始输出raw 版并排对照能精确看出每个转换动作。与 blacklist 版改写输入的对比blacklist 版原文为本サービスクラスでは、業務ルールの判定、SQLの発行、外部APIの呼び出しが同一メソッド内に記述されています。この構成では、業務ロジックの検証にDBや外部サービスの起動が必要となり、単体テストが困難です。また、外部APIの仕様変更やスキーマ変更が、業務ロジックの修正を伴う点も保守上の課題です。永続化処理はリポジトリ層に、外部連携はゲートウェイ層に分離し、サービス層はインターフェース経由でそれらを呼び出す構成へ改めてください。この分離により、モックを用いた業務ロジックの単体テストが可能となります。あわせて、トランザクション境界はサービス層で管理し、リトライやタイムアウトの制御は外部連携の実装側へ集約することを推奨します。逐处差异如下改写前blacklist 版改写后yomiyasu 版对应原则記述されています状态描述被动書いています动作描述主动主述对应、动作主体明确この構成では、〜となり、単体テストが困難です名词化堆叠この構成だと、〜しなければならず、単体テストを書きにくくなります动词谓语句サ変名詞の数珠つなぎを動詞述語へ戻す仕様変更やスキーマ変更が、業務ロジックの修正を伴う仕様やスキーマが変わるたびに、業務ロジックも修正する必要がある条件·触发关系具体化分離し、〜構成へ改めてください切り出し、〜呼び出すように改めてください动作具体化避免抽象名词この分離により、〜可能となりますこうすれば、モックを使って〜できます因果连词收拢去形式化集約することを推奨しますまとめることを推奨します比喩·生硬语平实化与 raw 版无约束 AI 输出的对比raw 版是未被任何约束干预的原始输出结构上采用三问题分列 提案的展开方式而 yomiyasu 版压缩为连续叙述。raw 版中責務の分離の観点から三つの問題があります这种只预告不落地的空泛句被直接消解依存性注入を採用すれば、テスト容易性と差し替え可能性も確保できます这句锦上添花的承诺也被删除因为原文并未要求写入 DI 的额外收益。这符合 SKILL.md 中情報を勝手に足さない不自行添加原文没有的信息的最高优先原则。改写手法逐条解析yomiyasu 七原则的落地README.md 记录了 yomiyasu 的 7 条转换原则本节以该样本逐条印证。1. 主述·修饰·条件的点检原句業務ロジックを検証するためにDBや外部サービスを起動しなければならず中动作主是隐性的测试者/开发者。yomiyasu 通过起動しなければならず保留了原文必要性的言说强度没有擅自补充開発者は这样的主语——因为原文并未明示主体。这与 SKILL.md 中原文や提供文脈から分かる主体を必要な位置で示し、元にない担当者を創作しない完全一致。2. 文的功能与文体保持这是本样本最精妙的一处。整段文本有两种文の働き句子功能说明型现状·后果句末为書いています書きにくくなります問題ですできます要求/建议型改造指令句末为改めてください推奨します。yomiyasu 完整保留了这种功能分层没有把説明句改成要求句也没有把〜してください的请求强度削弱为〜しましょう。对照 SKILL.md 中文書の立場と文末一节代码评审反馈属于勧め建议立场动作发出者是受评审的开发者因此改めてください与推奨します的组合是立场正确的。3. 拟人化整理原文中サービス層はインターフェース経由でそれらを呼び出す是架构概念的动作描述属于客观的系统行为叙述而非给概念赋予意志的拟人化因此 yomiyasu保留了サービス層は〜呼び出す的表述。这正是 SKILL.md 强调的边界道具や仕組みの働きを客観的に述べている文はそのまま残します。4. 比喩を平易な言葉へblacklist 版中集約するaggregate一词带有抽象隐喻色彩yomiyasu 改为まとめる归拢在保持集中管理含义的同时更口语化。类似的切り出し切出取代分離し分离把架构动作从名词化状态还原为具体操作。这些都是 references/domains/business.md 中比喩をふだんの言葉に直す的典型应用。5. 前置き·否定対比の役割確認raw 版的責務の分離の観点から三つの問題があります属于预告性前置yomiyasu 版直接删除因为后续内容并未按第一、第二、第三展开blacklist 版本就没有分列删除后主张与比重不受影响。这与前置きを削るのは、削っても主張や比重が変わらない場合だけ的原则严格吻合。6. 情報を勝手に足さない最明显的验证是 raw 版末句依存性注入を採用すれば、テスト容易性と差し替え可能性も確保できます。改写输入blacklist 版中没有这一句yomiyasu 版也没有补回。推敲过程没有把通过接口调用自行扩写成采用依赖注入杜绝了越权添加信息。7. 文長·読点·装飾の調整对照 README.md 的平均文長30〜45文字、1文の読点0〜2個目安本样本的单句长度适中以この構成だと、〜書きにくくなります为例全句约 45 字、1 个读点处于推荐区间永続化処理はリポジトリ層に、外部連携はゲートウェイ層に切り出し、〜改めてください通过成对的〜は〜に结构建立平行节奏读点起的是对照分组作用而非装饰。全文没有出现 em dash、装饰性文末冒号与多余加粗符合装飾記号の排除规则。技术实质这段评审反馈讲的分层架构是什么要让这篇文章不只停留在推敲层面还需把评审意见背后的工程原理讲透——这也是推敲结果质量的地基。服务层混写为何有害业务规则判定 SQL 发布 外部 API 调用同处一个方法意味着验证业务逻辑必须真实启动 DB 与外部服务。单元测试因此退化为集成测试环境搭建成本高、执行慢、外部依赖抖动会导致测试不稳定。这正是语料主题生成词中責務分離を促す的指向。Repository / Gateway / 接口三层拆解Repository 层负责永続化処理SQL 发布、ORM 操作把数据访问细节与业务规则隔离Gateway 层负责外部連携第三方 API 调用把外部协议、Schema 变化圈定在网关实现内部服务层只保留业务规则判定通过接口インターフェース声明对 Repository 与 Gateway 的依赖运行时注入具体实现。这样拆分后测试代码可以用 Mock 替身替换真实 Repository/Gateway业务逻辑的单元测试不再触碰 DB 与外部网络。这也是该样本中こうすれば、モックを使って業務ロジックを単体テストできます的完整论证链条。事务边界与重试/超时的归属样本末句给出了两条关键推荐トランザクション境界はサービス層で管理事务需要横跨多个仓储操作多表更新、补偿逻辑只有服务层能界定一个业务用例的边界因此事务应开在服务层而非埋在某个仓储方法内部リトライやタイムアウトの制御は外部連携の実装側にまとめる重试策略退避算法、最大次数与超时阈值只与外部 API 的稳定性有关属于 Gateway 的领域知识收拢到外部协作实现侧避免每个调用方各自实现导致策略漂移。这两条建议在语料生成提示词中并未逐条给出而是模型基于架构常识自然产出的yomiyasu 的职责是保证这些技术要点以准确、自然的日语传达而非发明或删改它们。语料库的构建机制这段文本从哪来tests/corpus不是手写语料而是由 scripts/build_corpus.py 通过 Claude CLI 按8 主题 × 3 文体矩阵程序化生成生成前会删除旧文件仓库只读使用时不运行raw_ai用RAW_PROMPT_PREFIX要求只输出正文 各主题提示词直接生成blacklist_ai在提示词末尾追加BLACKLIST_PROMPT_SUFFIX禁止使用手触り解像度地味に効く静かに壊れる時間を溶かす等 AI 味词汇scripts/build_corpus.pyyomiyasu_rewritten将 raw 版与 blacklist 版分别送入YOMIYASU_REWRITE_PROMPTscripts/build_corpus.py该提示词要求复现谁/什么/怎么的统语结构、把比喻动词展开为字面技术处置、剥除无据加粗、合并多余列表、消除否定对比、排除装饰符号等blacklist 版的输出以_bl后缀命名。由此可知本文关联文档是禁用词约束输出 × yomiyasu 推敲双阶段的结果它验证的是 yomiyasu 在词汇已被约束时仍能改善句法与文脉——这正是 README 所述従来のアプローチ禁止語の置き換えが抱えていた限界的对照实验。验证工具链如何客观检查这类推敲结果yomiyasu 仓库自带两个检查脚本可作为评审反馈文推敲后的客观度量手段。静态检查scripts/yomiyasu_lint.py执行方式仓库只读路径以仓库根目录为基准python3 scripts/yomiyasu_lint.py README.md python3 scripts/yomiyasu_lint.py article.md --strict python3 scripts/yomiyasu_lint.py article.md --json其检查项包括AI 味词汇SLOP_WORDS、比喻动词模式如静かに壊れる〜側に倒す時間を溶かす见 METAPHOR_VERB_PATTERNS、前置填充词重要なのはいかがでしたでしょうか、否定对比AではなくB、同一文末三连、加粗频率每千字 2.0 以下为推荐、3.0 以上为警告与列表比率15% 以下推荐、25% 以上警告。对本文样本而言推敲结果不含上述任何模式理论上可得到 [PASS] 判定。需要强调的是scripts/yomiyasu_lint.py 文档串明确声明检测结果是复查候选[PASS] 只代表无规则指摘不代表自然、意味保持或绝对可读。差分检查scripts/yomiyasu_diff.py用于对照改写前后文本核查语词增减、文末类型与立场勧め/決まり/説明变化python3 scripts/yomiyasu_diff.py 元の文.md 書き直した文.md --stance説明 python3 scripts/yomiyasu_diff.py --endings 対象文.md针对本文案例可指定--stance勧め建议立场运行核对改めてください推奨します等要求型文末是否被误改为说明型。脚本输出同样只是候选清单最终以人读判断为准。使用边界与正确姿势最后必须交代语料的适用前提避免误用evals/comparison_benchmark.md 明确声明语料中的適用後文本是过去验证时保存的输出不是当前版本的实际运行结果也不作为现行意味保持规则的合格例当时代的完整提示上下文未保留个别適用後文包含仅凭前文无法确定的条件或步骤静态检查无指摘 ≠ 语义保真。语料的定位是记录而非及格卷推敲结果的最终质量须以 SKILL.md 的意味の保持主張・比重・言い切りの強さ・文の働き四点为准绳人工复核本文关联文档可视为一份教学型样本它展示的是 yomiyasu 原则在代码评审反馈 正式文体 已约束词汇组合下的理想输出形态实际使用时请结合 references/domains/business.md 的业务文书写规范责任主体明确、条件与结果一一对应、比喩平实化进行同款推敲。通过这一份样本你可以同时掌握三件事一是 yomiyasu 处理实务文书的完整手法清单二是服务层/仓储层/网关层拆分与事务边界归属的架构常识三是用仓库自带工具客观核验推敲结果的流程——这套组合拳可以直接迁移到你的技术评审与代码审查写作中。赞分享【免费下载链接】yomiyasuAI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese项目地址https://gitcode.com/gh_mirrors/yo/yomiyasu点击查看免费下载相关推荐yomiyasu 推敲实践把 AI 生成的日语代码评审评论改写成自然表达——以「服务层拆分重构」建议为例yomiyasu 推敲实践把 AI 生成的日语代码评审评论改写成自然表达——以「服务层拆分重构」建议为例 导读 本篇文章以开源仓库 yomiyasu 语料库中yomiyasu 实战把 AI 生成的日语代码评审推敲成自然日语——以服务层职责拆分建议为例yomiyasu 实战把 AI 生成的日语代码评审推敲成自然日语——以服务层职责拆分建议为例 本篇技术指南以仓库评测语料中的一篇真实样例为核心AI 生成的日yomiyasu 实战拆解将 AI 生成的代码评审意见推敲为自然日语服务层责任分离评审示例yomiyasu 实战拆解将 AI 生成的代码评审意见推敲为自然日语服务层责任分离评审示例 本篇以 yomiyasu 仓库中保存的推敲示例 tests/c上一篇Windows 11 LTSC 没有微软商店三步装回来常见报错一次说清下一篇思源宋体CN TTF 7字重免费商用装好、选对、上网页创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考