什么是 MCode Stack？
MCode Stack 是 MiniMax Code 团队所使用的工作流、技能和检查清单的开源集合。它将实用的工程习惯转化为可运行的 SKILL.md 文件，可直接安装到 MiniMax Code 中。
这个仓库不是通用的提示词库，也不是静态的最佳实践列表。其中的资源针对 AI 辅助开发中的常见实际决策：是否将工作委派给子代理、如何管理上下文、命令应运行多长时间、如何跨会话保留状态，以及如何独立审查 AI 编写的代码。
MCode Stack 包含的是工作流和技能，而不是 MiniMax Code 本身的源代码。
主要功能
- 可运行的技能：按名称调用技能，或让代理根据技能描述自动加载。
- 交互式检查清单：让代理逐项检查项目，或自行阅读纯文本版本。
- 文档化工作流：了解个人贡献者如何在日常工作中使用 MiniMax Code。
- 插件打包：将整个 Stack 作为一个 MiniMax Code 插件安装。
- 市场支持：将此仓库添加为市场，并在支持该功能的环境中将 Stack 作为可安装插件进行管理。
- 便携格式：通用的
SKILL.md格式让许多技能也能与其他支持技能的代理配合使用。
Ronny Stack 涵盖的内容
第一个也是最完整的 Stack 是 stacks/ronny。其中的 15 项技能围绕工程工作的常见阶段组织。
- 规划与拆分：决定何时使用子代理，将大型变更拆分为小型拉取请求，并撰写有用的变更说明。
- 上下文与工具：审查工具成本，并识别注入每个请求的内容。
- 长会话与命令：管理压缩、记忆、交接、Shell 命令和后台任务。
- 审查：执行独立审查，评估代码健康状况，撰写审查意见，并回应反馈。
- 实验与热修复：运行受控的测试框架实验，审查代理轨迹，并安全地处理紧急变更。
安装单项技能
安装单项技能是评估 MCode Stack 的好方法，无需启用完整集合。以下示例会为所有项目安装 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/
当技能只应应用于一个仓库时，使用项目级目录。当你希望它在每个项目中都可用时，使用全局目录。
将完整 Stack 作为插件安装
要在本地使用完整的 Ronny Stack，首先定位 MiniMax Code 的插件目录：
mcode plugin marketplace list将完整的 stacks/ronny 目录复制到该命令显示的本地插件目录中。然后在 MiniMax Code 中打开 /plugins，按 Ctrl+R 刷新面板。
本地插件目录存在后，插件即安装完成。在插件面板中，按空格键启用或禁用它。
mcode plugin add命令只能从官方目录安装，不接受 GitHub URL 或本地路径。
通过市场安装
此仓库也可以作为插件市场使用。在 MiniMax Code 桌面版中，打开插件，选择添加市场，然后输入：
MiniMax-AI/mcode-stack随后，每个 Stack 都会显示为可安装、更新或卸载的插件。市场支持正在逐步推出，因此此选项可能尚未出现在所有 MiniMax Code 版本中。
在 Claude Code 中使用目录
同一个插件目录也可以添加到 Claude Code 中：
/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stack兼容性可能因技能而异，但共享的 SKILL.md 格式旨在支持所有支持技能的代理。
基本使用示例
审查长时间运行的命令
在启动可能运行缓慢的构建、测试、迁移或后台任务之前，调用：
/long-command-check该技能会对较长的 Shell 命令和后台任务进行十项审计。根据审计结果，决定命令应如何运行，以及如何监控其进度。
决定是否使用子代理
当任务可以并行处理，但你不确定委派是否有帮助时，运行：
/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 技能强调小规模评估、一次只做一项变更、重复运行，以及检查结果发生变化的任务。将其与 trajectory-review 搭配使用，检查代理是如何得出结果的，而不只是关注测试是否通过。
让技能栈适应你的工作流
该项目将工具编排视为不断发展的实践。你可以将技能复制到项目专用目录中，根据环境修改它们，或组装一个精简子集，而不必全部安装。让变更立足于实际使用，避免将技能栈变成一组假设性的提示词集合。
贡献你自己的技能栈
仓库欢迎基于 MiniMax Code 或其他代理真实日常工作流的技能栈。
- 将
templates/stack-template/复制到community/<your-id>/。 - 编写
WORKFLOW.md，说明哪些工作委派给代理，以及哪些工作由你自行监控。 - 至少添加一个你确实在使用的技能或检查清单。
- 使用以下命令验证贡献：
node scripts/check.mjs提交一个包含验证输出和简短实际使用记录的拉取请求。完整的贡献要求请参阅 CONTRIBUTING.md。
许可证说明
MCode Stack 通常依据 MIT 许可证提供，除非某个技能栈的 NOTICE.md 另有说明。其中六个 engineering-* 技能改编自 Google Engineering Practices，改编后的材料仍依据 CC-BY 3.0 许可。
结语
MCode Stack 让经过验证的 AI 辅助工程习惯可以直接运行。先从一个技能开始，例如 long-command-check；如果完整插件技能栈符合你的需求，再采用它。通过结合规划、上下文控制、会话管理、独立审查和受控实验，你可以围绕 AI 编写的代码建立更有纪律性的流程。