moyu-ja

moyu-ja 技能概览

moyu-ja 是一款面向代码编辑的 Japanese skill，专门帮助 AI 在变更请求范围很窄时保持严格克制。它最适合那些想要小而精准的 diff，而不是“顺手帮你重写一遍”的开发者，尤其是在你已经知道目标文件、功能点或行号范围时。

moyu-ja skill 的真正作用是控制范围：只改用户要求的内容，优先选择最简单、能工作的修复方案，并在请求含糊不清或会波及无关文件时及时停住。它特别适合维护工作、修复 bug，以及以 review 为驱动的编辑场景，因为这类任务最大的风险往往不是做得不够，而是做得过头。

它的核心差异化在于克制。这个 skill 的设计目标就是在没有明确要求时，尽量避免额外抽象、额外依赖、额外测试和额外文档。如果你希望模型尽量保留现有设计，只做最少量修改，moyu-ja 是很合适的选择。

moyu-ja 用于代码编辑

当任务是“改这个，不要改别的”时，就用 moyu-ja。它适合那些最安全输出往往也是最小输出的代码编辑工作：一行修复、定点替换，或在已知文件中做受限 patch。

这个 skill 擅长什么

• 把修改限制在用户明确说明的范围内
• 避免不必要的重构和包装层
• 优先沿用现有代码路径，而不是新建结构
• 当请求描述不充分时主动要求确认

什么时候不适合用

如果你想要的是架构清理、范围较大的重构，或者需要重新审视周边设计的方案，moyu-ja 就会显得过于保守。它并不是为“既然都来了，就顺手把整个模块优化一下”这种请求准备的。

如何使用 moyu-ja skill

安装并激活 moyu-ja

先把 moyu-ja skill 安装到你的 skills 环境中，然后在需要克制编辑的任务里调用它。这个 repo 里的典型安装命令是：

npx skills add uucz/moyu --skill moyu-ja

当你的 prompt 里包含边界清晰的编辑请求时就使用 moyu-ja，例如修复一个函数、调整一个条件，或应用一个很小的行为变更。

给它一个窄范围的编辑 brief

最好的 moyu-ja 用法，始于一个明确指出目标和边界的 prompt。好的输入会说清楚要改什么、改哪里，以及哪些内容不能动。

强提示模式：

• “在 src/auth.ts 里，只改 token parsing 逻辑。不要碰无关的 validation。”
• “更新这个组件，让它处理空输入，但保留当前结构，不要新建文件。”
• “针对 PaymentForm 里的失败场景，做最小改动修复；不要增加新的 abstractions。”

弱提示模式：

• “优化一下这段代码。”
• “让它更干净一点。”
• “重构这个模块。”

按正确顺序阅读源码

使用这个 skill 时，先看 SKILL.md，然后再检查 repo tree 里是否有从仓库中链接出来的相邻指导文件。如果项目包含 README.md、AGENTS.md、metadata.json，或者 rules/、resources/、references/、scripts/ 之类的支持目录，只在需要澄清范围和约束时再读。

关键不是把所有东西都读一遍。moyu-ja 最适合的方式是：先找出安全编辑所需的最少上下文，然后就停下。

能带来更好结果的工作流

1. 确认要修改的具体文件和行为。
2. 用一句话说明期望结果。
3. 在确实重要时，加上“minimal diff”“no new files”或“no new dependency”之类的约束。
4. 先要求给出最小可接受修复。
5. 如果模型提出澄清问题，就回答它，而不是把任务范围扩大。

这个工作流和 moyu-ja 的思路是一致的：输入要精确，范围要最小，不靠猜。

moyu-ja skill 常见问题

moyu-ja 只适合 Japanese 工作流吗？

不是。虽然这个 skill 的内容是 Japanese，但它所强化的编辑行为是通用的：保持最小改动、保持范围受控、避免不必要的变更。即使你的仓库和 prompt 都是 English，moyu-ja 依然有用。

这和普通 prompt 有什么不同？

普通 prompt 也可以要求谨慎编辑，但 moyu-ja 是把这种纪律直接编码成默认行为。这个差异很重要，因为模型很容易“帮忙过头”，把太多内容重写、加太多 abstractions，或者碰到相邻文件。

moyu-ja 适合初学者吗？

适合，前提是你的目标是学习如何做更小、更安全的修改。它尤其适合那些容易把代码改过头，或者不必要地加很多层的初学者。

什么时候不该用 moyu-ja？

当真正的任务是重新设计、跨多个文件清理，或者做更广泛的改进时，不要用 moyu-ja。若你希望模型重新评估架构，选择更宽泛的 coding skill 会更合适。

如何改进 moyu-ja skill

提供更明确的范围信号

最重要的改进，就是把编辑边界说清楚。明确指出文件、函数、行区间，或者具体行为。边界越明确，skill 越不容易越界。

说明真正重要的约束

如果你在意实现风格的保留，就直接说。如果你不想要新的 classes、helpers、dependencies、comments、tests 或 documentation，也要明确说出来。moyu-ja 最强的使用方式，就是让 prompt 把“少做一点”这条规则具体化。

要求先给出最小可接受修复

一个有效的 moyu-ja 改进循环，是先要求 minimum viable patch，再只在它失败时继续扩展。比如，先说“用最小 diff 修复这个 bug”，然后只有在第一版确实没覆盖真实需求时再迭代。

警惕过度工程化的失败模式

这个 skill 最主要要防的失败模式，就是 scope creep：改了无关文件、为了一个一次性修复加了抽象层，或者针对用户根本没问到的情况引入防御性代码。如果发生这种情况，就把 prompt 收紧到精确编辑点，并再次明确禁止额外工作。