スキル

Monozukuri:日本のクラフトプロセスで agent に簡潔で検証可能なコードを書かせる

Monozukuri は、agent に日式のクラフトプロセスに沿って簡潔で検証可能なソフトウェアを構築・保守させるのに最も適しています。ただし、まずあなたの agent が Agent Skills 形式に対応しているか確認してください。また、ファイルを直接変更するか、コマンドを実行するか、ネットワークにアクセスするかは公式に明示されていません。

公式ソース · kuya-egg/Monozukuri

インストール

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

誰に向いているか

  • agent がコードを書く際に、一発でコードを出すのではなく、検証可能なプロセス(観察 → 理解 → 計画 → 実装 → 検証 → 振り返り → 改善)に沿って進めてほしい開発者に向いています。
  • Agent Skills 形式をサポートする agent を使っているユーザーに向いています。各スキルはトップレベルの <name>/SKILL.md ディレクトリで構成され、公式はこの形式をサポートする任意の agent と互換があるとしています。$monozukuri-core による明示的な呼び出しで使います。
  • 向いていないケース:エビデンスでは依存する具体的なランタイムバージョンが示されておらず、検証済みクライアントの一覧もなく、テキスト/ドキュメント系タスクへの対応状況も示されていません。本スキルはソフトウェアの構築と保守を対象としており、エビデンスが触れていない用途については想定しないでください。
  • 公式に明記されていない点:対応プログラミング言語、ネットワークアクセスの要否、各スキルの具体的な副作用の範囲はいずれもエビデンスがなく、使用前に自身で確認してください。

3 分で最初の試行を完了する

前提:ローカルに Node.js/npx があること。Agent Skills 形式をサポートする agent を使用すること。公式は 2 つのインストール方法を提示していますが、ここでは 1 つのメインパスのみ推奨します:

メインパス:skills CLI でコアスキルをインストール

プロジェクトのルートで実行します:

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

これでアンブレラスキル monozukuri-core のみがインストールされます。その後、全 12 スキル(アンブレラスキル + 11 のフォーカススキル)をインストールしたい場合は、公式の同じ CLI がワイルドカードをサポートしています:

npx skills add kuya-egg/Monozukuri --skill '*'

(公式は Claude Code プラグインとしてのインストール方法も提供しています:/plugin marketplace add kuya-egg/Monozukuri の後に /plugin install monozukuri@monozukuri を実行すると、全 12 スキルが monozukuri 名前空間で読み込まれます。本記事ではこれをメインパスとしては扱いません。)

低リスクなタスクを一度実行する:インストール後、agent で明示的に $monozukuri-core と入力し、読み取り専用/分析系の小さなタスクを与えます。たとえば「craftsmanship のプロセスに沿って、ある小さな関数の正しさと簡潔さをチェックする」などです。コアのワークフローは Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen です。

成功のサイン:agent がコードをいきなり出すのではなく、上記 7 フェーズのプロセスに沿って回答を構成すること。フォーカススキルが公式の順序(nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka)で連結されれば、全スキルが有効になっています。注意:本スキルはコードタスクを対象としており、小説/専門ドキュメント向けの分岐ルーブリックは存在しません。テキストライティングのタスクを与えても、対応するプロセスがあることはエビデンスでは保証されません。$monozukuri-core はあくまで明示的なトリガー手段であり、ファイルの読み書き、コマンド実行、ネットワークアクセスを行うかどうかは公式に明示されていないため、最初の試行では副作用を生まないタスクを選んでください。

使用例

ケース 1:小さな関数のクラフト的なチェック シナリオ:agent に既存コードをじっくりレビューさせたい場合。実行方法:対応する agent で $monozukuri-core と入力し、対象コードを添えてプロセスに沿った評価を依頼します。使用するワークフロー:アンブレラスキルの Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen。期待できる結果:agent が直接書き換えるのではなく、フェーズごとに観察・理解・計画・検証の提案を返します。ファイル変更の前にユーザーの確認が必要かどうかはエビデンスに示されていないため、「分析のみでファイルは変更しない」と明示的に指示するのがよいでしょう。

ケース 2:フォーカススキルチェーンで機能開発を完走 シナリオ:先に全スキルをインストールし(--skill '*' または Claude Code プラグイン方式)、agent に小さな機能を開発させます。使用するワークフロー:フォーカススキルが公式の順序 nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka で連結され、準備から検証までの全リンクをカバーします。期待できる結果:agent が各スキルのフェーズを進めながら、各フェーズの成果物を提示します。各フォーカススキルの個別のトリガー方法や具体的な副作用はエビデンスでは展開されていないため、実際に実行する前に、各ステップでコードが変更されるかどうかを agent に確認してください。

使用上の境界

  • インストール方法はプラットフォーム別:skills CLI(npx skills add ...)が汎用パスです。Claude Code プラットフォームでは /plugin marketplace add + /plugin install monozukuri@monozukuri を使い、全 12 スキルを monozukuri 名前空間付きでインストールします。両者を混同したり、他のクライアントのインストール方法を推測しないでください。
  • トリガー方法:公式の説明では $monozukuri-core の明示的な呼び出しです。他のスキルの呼び出し構文はエビデンスに示されていません。
  • 副作用と確認ポイント:本スキルは agent にコードを書かせますが、ファイルを直接変更するか、コマンドを実行するか、ネットワークにアクセスするかはエビデンスに示されておらず、いずれも不明です。最初の試行では読み取り専用の分析タスクを優先し、変更を加える前に agent に必ず計画を提示させてください。
  • 公式に明記された制限:monozukuri-core を単独でインストールした場合はアンブレラスキルのプロセスのみが含まれます。完全なスキルチェーンには全 12 スキルのインストールが必要です。対応プログラミング言語、言語環境、ネットワーク要件、クライアント一覧は公式には示されていません。
  • 未確認の重要情報:各フォーカススキルの具体的な挙動、更新/アンインストール方法、ライセンス以外の利用規約については、エビデンスに記載がありません。使用前にリポジトリの原文を確認してください。