English · 中文
我们团队用 MiniMax Code 写 MiniMax Code 的全套工作流,全部开源,装上就能用。
这里放的不是 prompt 合集,也不是「最佳实践」清单,而是团队成员每天真在用的东西:怎么让 AI 写的代码保持质量、怎么判断一个任务该不该拆 subagent、长命令该怎么等、长会话怎么不变傻、每一轮往上下文里塞了什么。每一份都是一个 SKILL.md 格式的 Skill 或清单,能直接装进 MiniMax Code 里用。
Claude Code,一条命令。 这条命令会加上本仓库的插件市场,并装上一整份 stack。在 shell 里:
claude plugin install ronny --marketplace MiniMax-AI/mcode-stack在 Claude Code 会话里:
/plugin install ronny --marketplace MiniMax-AI/mcode-stack装 Jiachen 的 stack 时,把 ronny 换成 jiachen。克隆本仓库后可以跑 scripts/install.sh(默认 ronny,或 scripts/install.sh jiachen):PATH 里有 claude 或 codex 时,它会执行同样的安装,否则把该 stack 的 Skill 复制到 ~/.agents/skills/。
较旧的 Claude Code 可以先加市场,再安装:
/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stackCodex。 先加上市场,再从 Plugins Directory 或 CLI 安装:
codex plugin marketplace add MiniMax-AI/mcode-stack
codex plugin add ronny@mcode-stack把 ronny 换成 jiachen 即可。如果只要某一个 Skill,把它的目录复制到 ~/.agents/skills/。Codex 和 MiniMax Code 都会扫描这个目录,复制步骤见下文。
装一个 Skill,所有项目都能用:
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 调用,或者让 agent 按描述自动加载。
整份 stack 当插件装:
mcode plugin marketplace list # 查看本地插件目录把 stacks/ronny 整个目录复制到那个目录下,然后在 MiniMax Code 里打开 /plugins,按 Ctrl+R 刷新。本地插件放进去就算装好了,可以在面板里按空格启用或停用。
从 MiniMax Code 插件市场安装:
这个仓库本身也是一个插件市场,不用复制文件就能装,之后有更新也能直接拿到。在 MiniMax Code 桌面端打开「插件」,点「添加市场」,填入 MiniMax-AI/mcode-stack,每份 stack 都会显示成一个插件,可以安装、更新或卸载。添加市场的功能正在逐步开放,你的版本可能还没有。
更多安装方式
MiniMax Code 会自动发现这几个目录里的 Skill(每个 Skill 一个子目录,里面放 SKILL.md):
- 只对当前项目生效:项目里的
.minimax/skills/、.claude/skills/或.agents/skills/ - 对所有项目生效:
~/.agents/skills/(~/.claude/skills/、~/.codex/skills/也会读取)
mcode plugin add 只从官方插件目录安装,不接受 GitHub 地址或本地路径。
这里的 Skill 用的是通用的 SKILL.md 格式,大部分也能放进其他支持 Skill 的 agent 里用。
| 场景 | Skill | 做什么 |
|---|---|---|
| 规划与拆分 | subagent-split-check |
判断一段活该交给 subagent,还是留在主循环 |
engineering-small-prs |
把大功能、大重构、迁移拆成一串好审的小 PR | |
engineering-change-descriptions |
写清楚改了什么、为什么改的 PR 和 commit 描述 | |
| Context 与工具 | tool-budget-audit |
算清工具吃了多少 context,决定先精简、上 tool search 还是上 PTC |
context-tax-audit |
每轮往请求里塞了什么,会不会弄坏提示词缓存 | |
| 长会话与长命令 | long-session-check |
该丢的丢、该压的压、该落盘的落盘;什么时候压缩,什么时候开新会话 |
handoff-doc |
写一份交接文档,新会话接着干 | |
long-command-check |
长命令和后台任务的 10 项自查 | |
| 代码审查 | independent-review |
审查者从干净的 context 开始,只拿 diff、需求说明和测试结果 |
engineering-code-review |
按代码健康度审查改动:设计、功能、复杂度、测试、能不能批 | |
engineering-review-comments |
写清楚、标好严重程度、讲明理由的 review 评论 | |
engineering-review-feedback |
作为作者处理 review 意见:改代码、补说明、化解分歧 | |
| 实验与紧急修复 | harness-experiment |
小 eval、一次只改一处、多跑几次、看哪些任务翻转了 |
trajectory-review |
不只看结果过没过,回头看 agent 是怎么得到这个结果的 | |
engineering-emergency-changes |
判断 hotfix 是不是真紧急,紧急时怎么快审又不丢质量 |
上表是 stacks/ronny 的内容。stacks/jiachen 里还有:lifting-loops 找出你总在给 agent 当「人工环节」的那些循环,帮你从里面抽身;making-content 把笔记和素材做成小红书图文和竖版短视频。
每个 stack 里一般有三类东西:
| 类型 | 是什么 | 怎么用 |
|---|---|---|
| Skill | 一个目录,里面有 SKILL.md |
装好后在 MiniMax Code 里用 /skill名 调用,或者让 agent 按描述自动加载 |
| 清单 | 也做成 Skill,让 agent 拿着清单逐条对照你的项目;checklists/ 下另有纯文本版 |
同上,或者直接读 |
| 工作流说明 | 一份 WORKFLOW.md,写清这个人每天怎么用 MiniMax Code 干活 |
直接读 |
AI 写代码越来越快,真正拉开差距的,是围绕 agent 的那一圈工程习惯:什么时候让它停下来自查,review 交给谁,状态记在哪,实验怎么做才算数。这些东西写在文章里很难照着做,所以我们把它们做成了 Skill 和清单,和「MCode 工程笔记」专栏对应:文章把道理讲清楚,仓库负责落地。
我们也相信,harness 工程是一门靠实验推进的手艺。这里的每一份东西都会随着我们的实践继续改。欢迎拿去用、拿去改。想改仓库里的内容,先开 issue,见参与贡献。
| # | MCode 工程笔记 | 对应 Skill |
|---|---|---|
| 01 | subagent 不是越多越好:先管好 context,再谈并行 | independent-review、subagent-split-check、harness-experiment |
| 02 | 工具一多,context 就爆:从 tool search 到 PTC | tool-budget-audit |
| 03 | 长会话怎么不变傻:compaction 和 memory 的取舍 | long-session-check、handoff-doc |
| 04 | 一条 bash 命令该等多久:从前台阻塞到后台任务 | long-command-check |
| 05 | 一个小字段,拖垮整段前缀缓存 | context-tax-audit |
stacks/ronny/ MiniMax Code 研发负责人 Ronny 的日常工作流,第一份,也是目前最完整的一份
stacks/jiachen/ Jiachen 的工作流:把自己从 agent 的循环里解放出来,以及把笔记做成图文和短视频
stacks/<name>/ 每位成员一个目录,欢迎团队同事把自己的也放进来
notes/ 「MCode 工程笔记」每一篇对应哪一份能跑的东西
community/ 团队外的 stack,由协作者加进来
templates/stack-template/ 新增 stack 用的模板
每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 stacks/ronny 和 stacks/jiachen。
欢迎开 issue 讨论。代码、文档和 stack 的 PR,目前只收仓库协作者的。还不是协作者的话,先开一个 issue 把想法说清楚。
我们很想知道你用 MiniMax Code(或者别的 agent)每天到底怎么干活,写在 issue 里就行。协作者要把一份 stack 放进仓库,按这几步:
- 从
templates/stack-template/复制一份到community/<你的 id>/ - 写一份
WORKFLOW.md:你每天怎么用 agent,哪些环节交给它,哪些自己盯着 - 至少放一个你真在用的 Skill 或清单
- 本地跑一遍
node scripts/check.mjs,再提 PR,附上校验输出和一段真实的使用记录
详细规则见 CONTRIBUTING_ZH.md。如果你把这里的东西用进了自己的 agent,欢迎开一个「I use this」issue 告诉我们。
MiniMax Code 本体在 MiniMax-AI/minimax-code。这个仓库只放工作流和 Skill,不放 MiniMax Code 的代码。
MIT,各 stack 的 NOTICE.md 另有说明的除外。engineering-* 系列 Skill 改编自 Google Engineering Practices,改编部分仍遵循 CC-BY 3.0,详见 stacks/ronny/NOTICE.md。


