AIチュートリアル

MCode StackでAIコーディングのワークフローを改善

MCode Stackのインストール方法、個別のスキルやプラグインスタック全体の実行方法を学び、AIを活用した計画立案、コンテキスト管理、長時間セッション、コードレビュー、実験、緊急変更を改善します。

2026年10月28日約13分で読了

MCode Stackとは？

MCode Stackは、MiniMax Codeチームが使用するワークフロー、スキル、チェックリストをまとめたオープンソースコレクションです。実践的なエンジニアリングの習慣を、MiniMax Codeに直接インストールできる実行可能なSKILL.mdファイルへと変換します。

このリポジトリは、汎用的なプロンプトライブラリでも、静的なベストプラクティス一覧でもありません。収録されているリソースは、AI支援開発で繰り返し発生する実際の判断に対応します。たとえば、作業をサブエージェントに委任するか、コンテキストをどう管理するか、コマンドをどのくらいの時間実行するか、セッション間で状態をどう保持するか、AIが記述したコードをどう独立してレビューするか、といった判断です。

MCode Stackに含まれるのはワークフローとスキルであり、MiniMax Code自体のソースコードではありません。

主な機能

実行可能なスキル：名前でスキルを呼び出すか、エージェントに説明を基に読み込ませることができます。
インタラクティブなチェックリスト：エージェントにプロジェクトを項目ごとに調査させたり、プレーンテキスト版を自分で読んだりできます。
文書化されたワークフロー：個々のコントリビューターが日々の業務でMiniMax Codeをどのように使っているかを確認できます。
プラグインパッケージ：スタック全体を1つのMiniMax Codeプラグインとしてインストールできます。
マーケットプレイス対応：リポジトリをマーケットプレイスとして追加し、対応している環境ではスタックをインストール可能なプラグインとして管理できます。
ポータブルな形式：共通のSKILL.md形式により、多くのスキルはスキル対応の他のエージェントでも利用できます。

Ronny Stackの対象範囲

最初の、そして最も完全なスタックはstacks/ronnyです。15個のスキルが、エンジニアリング作業でよくある段階ごとに整理されています。

計画と分割：サブエージェントを使うタイミングを判断し、大きな変更を小さなプルリクエストに分割し、役立つ変更説明を作成します。
コンテキストとツール：ツールのコストを監査し、すべてのリクエストに注入されるコンテンツを特定します。
長時間のセッションとコマンド：コンパクション、メモリ、引き継ぎ、シェルコマンド、バックグラウンドタスクを管理します。
レビュー：独立したレビューを実施し、コードの健全性を評価し、レビューコメントを作成し、フィードバックに対応します。
実験と緊急修正：制御されたハーネス実験を実行し、エージェントの軌跡をレビューし、緊急の変更を安全に処理します。

1つのスキルをインストールする

完全なコレクションを有効にせずにMCode Stackを評価するには、1つのスキルをインストールするのが適しています。以下の例では、すべてのプロジェクトで使えるようにlong-command-checkをインストールします。

git clone https://github.com/MiniMax-AI/mcode-stack.git ~/mcode-stack
mkdir -p ~/.agents/skills
cp -R ~/mcode-stack/stacks/ronny/skills/long-command-check ~/.agents/skills/

新しいMiniMax Codeセッションを開始し、次を入力します。

/skills

インストールしたスキルが一覧に表示されます。次のコマンドで明示的に実行できます。

/long-command-check

関連するタスクを説明し、エージェントに説明を基にスキルを読み込ませることもできます。

プロジェクト用またはグローバルのスキルディレクトリを選択する

MiniMax Codeは複数の場所からスキルを検出します。各スキルには、SKILL.mdファイルを含む専用のサブディレクトリが必要です。

プロジェクト固有のディレクトリ：

.minimax/skills/
.claude/skills/
.agents/skills/

グローバルディレクトリ：

~/.agents/skills/
~/.claude/skills/
~/.codex/skills/

1つのリポジトリだけにスキルを適用する場合は、プロジェクトディレクトリを使用します。すべてのプロジェクトで利用できるようにする場合は、グローバルディレクトリを使用します。

完全なスタックをプラグインとしてインストールする

Ronny Stack全体をローカルで使用するには、まずMiniMax Codeのプラグインディレクトリを確認します。

mcode plugin marketplace list

このコマンドで表示されたローカルプラグインディレクトリに、stacks/ronnyディレクトリ全体をコピーします。次にMiniMax Codeで/pluginsを開き、Ctrl+Rを押してパネルを更新します。

ローカルプラグインは、そのディレクトリが存在するとインストールされます。プラグインパネルでSpaceキーを押すと、有効化または無効化できます。

mcode plugin addコマンドは公式カタログからのみインストールします。GitHub URLやローカルパスは受け付けません。

マーケットプレイスからインストールする

このリポジトリはプラグインマーケットプレイスとしても利用できます。MiniMax Codeデスクトップ版でPluginsを開き、Add marketplaceを選択して、次を入力します。

MiniMax-AI/mcode-stack

各スタックが、インストール、更新、アンインストール可能なプラグインとして表示されます。マーケットプレイス対応は段階的に展開されているため、このオプションはまだすべてのMiniMax Codeバージョンに表示されるとは限りません。

Claude Codeでカタログを使用する

同じプラグインカタログをClaude Codeに追加できます。

/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stack

互換性はスキルによって異なる場合がありますが、共通のSKILL.md形式は、スキルに対応するエージェント間で動作するよう設計されています。

基本的な使用例

長時間実行コマンドを監査する

時間がかかる可能性のあるビルド、テスト、移行、またはバックグラウンドタスクを開始する前に、次を実行します。

/long-command-check

このスキルは、長いシェルコマンドとバックグラウンドタスクに対して10項目の監査を行います。その結果を使って、コマンドの実行方法と進捗の監視方法を決めます。

サブエージェントを使うか判断する

タスクを並列化できそうだが、委譲が役立つか判断できない場合は、次を実行します。

/subagent-split-check

このスキルは、作業をサブエージェントに任せるべきか、メインループに残すべきかの判断に役立ちます。エージェントを追加する前にコンテキストを管理するという、リポジトリのより広い原則を支援します。

セッションの引き継ぎを準備する

新しいセッションで作業を継続する必要がある場合は、次を実行します。

/handoff-doc

生成された引き継ぎドキュメントにより、別のセッションが必要な状態を引き継いで作業を再開できます。要約するか、情報をファイルに書き出すか、現在のセッションを圧縮するか、最初からやり直すかを判断する際は、/long-session-checkと組み合わせて使用します。

クリーンなコンテキストでレビューする

次を使用します。

/independent-review

このスキルは、差分、要件、テスト結果だけを含むクリーンなコンテキストで変更をレビューします。設計、機能、複雑性、テスト、承認リスクを含む、より広範なコード健全性の評価には、次を使用します。

/engineering-code-review

高度なワークフローのヒント

開発段階に応じてスキルを組み合わせる

すべてのタスクで毎回すべてのスキルを実行するのではなく、現在の作業段階に応じてスキルを選択します。

計画: subagent-split-checkとengineering-small-prsから始めます。
コンテキストを管理: tool-budget-auditとcontext-tax-auditを使用します。
継続性を維持: long-session-check、handoff-doc、long-command-checkを適用します。
レビュー: independent-reviewとengineering-code-reviewを実行し、必要に応じてレビューコメントとフィードバックのスキルを使用します。
変更を評価: harness-experimentとtrajectory-reviewを使い、結果とエージェントがたどった経路の両方を調べます。

ワークフローファイルを確認する

スタックには、スキル、チェックリスト、WORKFLOW.mdファイルが含まれることがあります。スキルは実行可能なリソースであり、WORKFLOW.mdはスタックの作成者がエージェントとどのように作業するかを説明します。スタック全体を導入する前にワークフローを読み、その構成要素がどのように連携するかを理解してください。

実験を管理された状態に保つ

harness-experimentスキルは、小規模な評価、一度に1つの変更、繰り返しの実行、結果が変化したタスクの確認を重視します。trajectory-reviewと組み合わせて、テストに合格したかどうかだけでなく、エージェントがどのように結果に到達したかを調べます。

スタックをワークフローに適応させる

このプロジェクトでは、ハーネスエンジニアリングを発展し続ける実践と捉えています。スキルをプロジェクト固有のディレクトリにコピーしたり、環境に合わせて変更したり、すべてを導入する代わりに必要な一部だけを組み合わせたりできます。スタックを仮想的なプロンプトの集合に変えるのではなく、実際の利用に基づいて変更してください。

独自のスタックを提供する

このリポジトリでは、MiniMax Codeやその他のエージェントを使った実際の日常的なワークフローに基づくスタックを歓迎しています。

templates/stack-template/をcommunity/<your-id>/にコピーします。
エージェントに委譲する作業と、自分で監視する作業を説明するWORKFLOW.mdを作成します。
実際に使用しているスキルまたはチェックリストを少なくとも1つ追加します。
次のコマンドで貢献内容を検証します。

node scripts/check.mjs

検証結果と実際の使用記録の短い説明を含むプルリクエストを作成します。詳細な貢献要件については、CONTRIBUTING.mdを参照してください。

ライセンスに関する注意

MCode Stackは、スタックのNOTICE.mdに別の記載がない限り、原則としてMITライセンスで提供されます。6つのengineering-*スキルはGoogle Engineering Practicesを基に改変されており、その改変された素材はCC-BY 3.0の下で引き続き提供されます。

まとめ

MCode Stackは、実績のあるAI支援開発の習慣を直接実行可能にします。まずはlong-command-checkなど1つのスキルから始め、ワークフローが自分のニーズに合う場合は、完全なプラグインスタックを導入してください。計画、コンテキスト管理、セッション管理、独立したレビュー、管理された実験を組み合わせることで、AIが作成したコードをより規律正しく扱うプロセスを確立できます。