前言¶
学日语时，查词、标假名、拆语法、改作文往往要切换词典、教材和论坛。若在写代码或办公的 Agent 会话里顺手完成这些事，需要一套明确的触发规则：只有在你给出日文或明确要学日语时才进入教学模式，而不是对任意中文闲聊强行「日文分析」。
下面介绍 SkillHub 社区 Skill「日语学习助手」（坐标 @user_ce78a98f/japanese-learning-assistant，当前版本 1.0.9），以日语教师角色森亜るるか（もりあ るるか）承接分析、纠错、对比与聊天四类任务。
这是什么¶
「日语学习助手」是 SkillHub 上分类为 education、来源为 community 的 Skill，由发布者 user_ce78a98f 维护。页面标注 requires_api_key=false，安装后无需额外配置 API Key。
它解决的是：在支持 SKILL.md 的 Agent（如 Cursor、Claude Code、Codex 等）中，用统一角色完成日文理解、自写句子检查、易混语法对比和日语/中文会话练习，而不必每次手写长篇提示词。
核心功能¶
官方说明将能力归纳为四种模式，均围绕用户主动提供的日文或明确的日语学习意图展开。
分析模式¶
对用户给出的日文文本提供：
- 中文翻译
- 汉字假名标注
- 逐句语法分析（含 JLPT 级别标注）
适用表述示例：附带日文并询问「这句日语什么意思」「帮我看看这句日语」「汉字读音 / 假名标注」等。
纠错模式¶
检查用户自写的日语句子，定位错误，说明原因并给出正确写法。触发场景包括「我写的日语对吗」「日语作文批改」「日语造句检查」「日语纠错」等。
对比辨析¶
对比易混淆的语法点或词汇，例如は与が、に与で、ように与ために等。适合在备考 JLPT（N5–N1）或梳理助词、ます形、て形、た形、敬语等概念时使用。
聊天模式¶
与るるか用日语或中文自由对话，练习会话。常见入口包括日常寒暄（こんにちは、おはよう 等）或「和露露卡聊天」「日语会话」「日语对话」等关键词。
触发边界（简介中的注意项）：日语文本分析应在用户主动提供日文时触发；不应仅因用户用中文提问就对内容做日文语法分析。纯中文问题应走聊天或一般问答，而非强行进入分析模式。
SkillHub 列出的触发关键词还包括：日语分析、日语纠错、日语语法、汉字读音、日语对话、日语学习，以及简介中扩展的こんばんは、おやすみ、るるか、露露卡、日本語、翻译、语法分析、平假名、片假名等表述。
安装与启用¶
安装前需已具备 SkillHub CLI。若尚未安装，可先按官方文档检查版本：
command -v skillhub && skillhub --version
未安装时，可使用 SkillHub 提供的安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。SkillHub 页面给出的安装方式为：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_ce78a98f/japanese-learning-assistant。
对应 CLI 示例（将目录替换为你的环境路径）：
skillhub install @user_ce78a98f/japanese-learning-assistant --dir ~/.cursor/skills/
常用路径参考（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端要求重启或刷新 Agent，使 Skill 被加载。本 Skill 无需 API Key 配置项。
典型用法¶
以下示例可在启用 Skill 后直接复现，用于验证四种模式是否按预期触发。
分析模式——先给出日文，再说明需求：
请分析这句日语：今日は早く帰って、本を読みたいと思います。
需要翻译、假名标注和语法讲解。
纠错模式：
我写的日语对吗？私は昨日図書館に行きました。
对比辨析：
日语语法：は和が的区别是什么？各举一个例句。
聊天模式：
るるか、こんにちは。今日の天気について少し日本語で話しましょう。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等 Agent，希望在同一会话里完成读句、改错、辨析和口语练习的学习者。
- 备考 JLPT 或需要 JLPT 级别标注的语法讲解时，可优先使用分析模式并附上完整日文。
使用注意
- 分析、纠错、对比模式依赖你提供日文或明确的日语学习问题；勿期望对无日文内容的纯中文问题自动做日文拆解。
- 角色设定为教师「森亜るるか」；聊天可用中文或日语，教学类任务仍以你给出的句子或知识点为准。
- SkillHub 页面统计（抓取时）：评分 100000，下载 2117；分类 education。数据以 SkillHub 实时页面为准。
结尾¶
「日语学习助手」把翻译、假名标注、语法分析、作文纠错、易混点对比和会话练习收进一个 Skill，并通过关键词与「须用户提供日文」的边界减少误触发。若要在 Agent 中安装，以 SkillHub 官方说明为准。
- Skill 页面：https://www.skillhub.cn/skills/user_ce78a98f/japanese-learning-assistant
- API 入口：https://api.skillhub.cn/user_ce78a98f/japanese-learning-assistant
- 安装文档：https://skillhub.cn/install/skillhub.md
