moyu

moyu skill の概要

moyu skill でできること

moyu skill は、コード変更に対する編集ガードレールです。モデルをユーザーが求めた範囲の中にとどめ、不要な抽象化を避け、最小限で安全な diff を優先するよう促します。過剰設計に抵抗する Code Editing 用の skill を探しているなら、moyu はまさにそのために作られています。

どんな人に向いているか

moyu skill は、網羅性よりも正確さを重視する場面で使うのが向いています。たとえば、1 つのバグ修正、1 ファイルの変更、diff の圧縮、あるいは「X だけ触ってください」という依頼への対応です。特に、レビュー担当者、メンテナー、そして既存のコードベースで作業するエージェントに有用です。余計な整理を加えることが、かえってリスクになるからです。

何が強みなのか

最大の差別化ポイントは、節度を強く重視していることです。この skill は、ユーザーが求めていない限り、新しい依存関係、広範な書き換え、追加の検証、テスト、コメント、補助レイヤーを明確に避けるように設計されています。そのため moyu は、現実の編集作業で強みを発揮します。危険なのは機能を取りこぼすことではなく、変更しすぎることだからです。

moyu skill の使い方

moyu をインストールして有効化する

moyu skill をエージェントの skills ディレクトリにインストールし、編集前に coding workflow がそれを読み込むようにしてください。一般的なインストール例は npx skills add uucz/moyu --skill moyu です。最良の結果を得るには、「この関数だけ更新して」「変更は最小限に」といった、節度を前提にしたタスクで有効化するのが効果的です。

skill に狭い指示を与える

moyu skill は、変更すべき正確なファイル、関数、挙動、出力をプロンプトで明示したときに最もよく機能します。たとえば強い指示は、「src/auth.ts ではトークン更新のバグだけ直してください。リファクタリングも新規ファイル追加も不要です。」です。逆に「認証を改善して」のような曖昧な指示では、変更範囲が広がりすぎてしまい、moyu を使う意図が弱まります。

先に適切なファイルを読む

まず SKILL.md を読み、その後、実際に編集する予定のファイルと、ローカルな慣習を説明している周辺コンテキストを確認してください。このリポジトリは意図的に軽量なので、案内用の追加スクリプトやサポート用ディレクトリはありません。核となる価値は skill テキストそのものにあります。つまり、最善の流れは「skill を読む → 編集対象を最小化する → 実行する」です。

moyu が想定する進め方で作業する

moyu を Code Editing で使うときは、まず最小限の修正を依頼し、結果がまだ狙いに届かない場合だけ次に進めてください。さらに変更が必要なら、最初の依頼に広げて足すのではなく、2 回目のリクエストで追加します。こうすると diff を小さく保ててレビューもしやすくなり、skill の「依頼されたことだけ変える」というルールにも合致します。

moyu skill の FAQ

moyu は高機能なコーディングアシスタントですか？

いいえ。moyu skill は、対応範囲を広げることではなく、変更範囲を絞り、不要な編集を避けることに重点があります。広いリファクタリング、雛形作成、アーキテクチャ面の支援が欲しいなら、moyu skill より一般的な coding prompt のほうが合っている場合があります。

どんなときに moyu を使わないべきですか？

本当に複数ファイルの調整、新しい抽象化、システム全体の整理が必要なタスクでは、moyu は使わないでください。「アーキテクチャをきれいにしたい」「足りないテストスイートを追加したい」といった作業では、この skill の節度が利点ではなく制約になることがあります。

moyu は初心者にも向いていますか？

はい。安全に編集したい、予想外の変更を減らしたい初心者には向いています。特に、モデルに頼みすぎてしまう人や、大きすぎる diff を受け入れてしまいがちな人に役立ちます。「問題を解く最小の変更を頼む」という有用な基本姿勢を学べるからです。

単に「慎重に」と伝えるのと何が違いますか？

通常のプロンプトでも慎重さは求められますが、moyu skill はその方針を再利用可能な編集ポリシーとして組み込んでいます。1 回限りの指示ではなく、複数のタスクで一貫して minimal-diff 行動が必要なときに、この違いが重要になります。

moyu skill を改善するには

依頼をより小さく、より明確にする

moyu の出力を改善する最も効果的な方法は、最初の編集前に曖昧さをなくすことです。正確な file path、保持すべき挙動、望む変更内容をすべて含めてください。たとえば、「components/Button.tsx だけを編集し、props は変えず、disabled のスタイルだけ修正してください」のように指定します。

変えてはいけないことを明示する

この skill は、何を触らないかを伝えるほど強く機能します。「新規ファイルなし」「新しい依存関係なし」「API の形を変えない」「関数全体を書き換えない」といった条件を明記してください。そうすることで、moyu はユーザーの本当の意図に沿ったまま、不要に広い改善へ最適化してしまうのを防げます。

最初の diff を確認してから、さらに絞る

最初の結果でもまだ大きすぎるなら、大きくなりすぎた部分をフィードバックして、より狭い再実行を求めてください。よくある失敗は、余計な整理、追加の抽象化、依頼されていない防御的コードです。moyu の最適な進め方は反復型です。制約を与え、レビューし、必要ならもう一段絞って、diff が依頼内容に一致するまで調整します。