Skip to content

Repository navigation

Commit c889a19

Browse files
hetaoBackendhetaoBackend
committed
Initial MCode Stack: ronny stack, template, notes and CI
0 parents  commit c889a19

43 files changed

Lines changed: 1680 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.github/ISSUE_TEMPLATE/config.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
blank_issues_enabled: true

‎.github/ISSUE_TEMPLATE/i-use-this.yml‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
name: I use this
2+
description: Tell us you are using a stack or skill from this repository
3+
title: "I use: <stack/skill>"
4+
labels: ["i-use-this"]
5+
body:
6+
- type: input
7+
id: what
8+
attributes:
9+
label: Which stack or skill
10+
placeholder: ronny/long-command-check
11+
validations:
12+
required: true
13+
- type: input
14+
id: agent
15+
attributes:
16+
label: In which agent
17+
placeholder: MiniMax Code, or another agent that supports skills
18+
- type: textarea
19+
id: how
20+
attributes:
21+
label: How you use it, and what you changed
22+
description: Optional, but very useful. Did it catch something? Did you have to adapt it?

‎.github/ISSUE_TEMPLATE/new-stack.yml‎

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
name: New stack
2+
description: Propose a stack before opening a PR
3+
title: "New stack: <your-id>"
4+
labels: ["new-stack"]
5+
body:
6+
- type: textarea
7+
id: who
8+
attributes:
9+
label: Who you are and how you use agents
10+
description: A few sentences. Which agent(s), what kind of work.
11+
validations:
12+
required: true
13+
- type: textarea
14+
id: contents
15+
attributes:
16+
label: What you plan to include
17+
description: The skills or checklists, one line each, and what your WORKFLOW.md will cover.
18+
validations:
19+
required: true
20+
- type: input
21+
id: id
22+
attributes:
23+
label: Stack id
24+
description: Lowercase letters, digits and hyphens. Becomes community/<id>/.
25+
validations:
26+
required: true

‎.github/PULL_REQUEST_TEMPLATE.md‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
## What this adds or changes
2+
3+
<!-- New stack / new skill / fix to an existing skill -->
4+
5+
## Check output
6+
7+
<!-- Paste the output of `node scripts/check.mjs` -->
8+
9+
```
10+
```
11+
12+
## Real usage record
13+
14+
<!-- The task where the agent used this, what the process looked like, and how it turned out. Show the process, not only the result. -->
15+
16+
## If this skill were deleted, where would the agent go wrong?
17+
18+
## Checklist
19+
20+
- [ ] No keys, tokens, internal hostnames or private links
21+
- [ ] Third-party content is credited with its license
22+
- [ ] I agree to release this under the repository's MIT License

‎.github/workflows/validate.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
name: validate
2+
3+
on:
4+
push:
5+
branches: [main]
6+
pull_request:
7+
8+
permissions:
9+
contents: read
10+
11+
jobs:
12+
validate:
13+
runs-on: ubuntu-latest
14+
steps:
15+
- uses: actions/checkout@v4
16+
17+
- name: Fetch the official plugin validator from MiniMax Code
18+
uses: actions/checkout@v4
19+
with:
20+
repository: MiniMax-AI/minimax-code
21+
path: .minimax-code
22+
sparse-checkout: |
23+
tools/plugins
24+
schemas/plugins
25+
sparse-checkout-cone-mode: true
26+
27+
- uses: actions/setup-node@v4
28+
with:
29+
node-version: 22
30+
31+
- name: Check all stacks
32+
env:
33+
MINIMAX_CODE_DIR: .minimax-code
34+
run: node scripts/check.mjs

‎.gitignore‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
.minimax-code/
2+
node_modules/
3+
.DS_Store

‎CONTRIBUTING.md‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
# Contributing to MCode Stack
2+
3+
[中文](CONTRIBUTING_ZH.md)
4+
5+
## What we accept
6+
7+
- **A stack = one person's or one team's real daily practice**: a
8+
`WORKFLOW.md` plus at least one skill or checklist.
9+
- **Not accepted**: pure prompt collections, "ideal" processes nobody runs,
10+
and anything tied to a private system that others cannot run.
11+
- Improvements to existing skills are welcome too. Explain what went wrong
12+
without the change.
13+
14+
## How to submit a stack
15+
16+
1. **Open a "New stack" issue first.** In a few sentences: who you are, how
17+
you use agents, and which pieces you plan to include.
18+
2. **Copy the template** to `community/<id>/`. The `id` uses only lowercase
19+
letters, digits and hyphens, and must equal the `name` in
20+
`.minimax-plugin/plugin.json`.
21+
3. **Run the checks locally** and paste the output into the PR:
22+
23+
```bash
24+
node scripts/check.mjs
25+
# optional: also run the official MiniMax Code plugin validator
26+
git clone --depth 1 https://github.com/MiniMax-AI/minimax-code.git ../minimax-code
27+
MINIMAX_CODE_DIR=../minimax-code node scripts/check.mjs
28+
```
29+
30+
4. **Include a real usage record** in the PR: the task where the agent used
31+
the skill, what the process looked like, and how it turned out. Show the
32+
process, not just the final result.
33+
34+
## How we review
35+
36+
At least one maintainer reviews each PR, looking at three things:
37+
38+
- **Does it run?** Checks pass; after installing, it shows up in `/skills` in
39+
MiniMax Code; the agent loads it correctly from its `description`.
40+
- **Is it really used?** The usage record shows the process, not only a
41+
conclusion. We hold ourselves to the same rule: look at how the agent got
42+
the result, not just the result.
43+
- **Safety and boundaries.** No keys, tokens or internal addresses; scripts do
44+
nothing beyond what they describe; third-party content is credited with its
45+
license.
46+
47+
We will usually ask one question: *"If you deleted this skill, where would
48+
your agent go wrong?"* If there is no clear answer, we may suggest merging it
49+
into an existing skill.
50+
51+
## After it is merged
52+
53+
- The author maintains their stack under `community/` and sends changes as
54+
PRs.
55+
- Stacks that go unmaintained or stop matching current MiniMax Code may be
56+
marked and later moved to an archive area.
57+
- Stacks that are well written and widely used may be featured in the
58+
Engineering Notes or other official channels.
59+
60+
## Writing a good skill
61+
62+
- Frontmatter: `name` equal to the directory name, and a one-line
63+
`description` saying what it does and **when** to use it. Quote the value
64+
if it contains `: `.
65+
- Steps the agent can actually execute, in order, with how to verify each one.
66+
- Ask for evidence (files, commands, real output). Never let the skill invent
67+
numbers.
68+
- Say what the output should look like.
69+
70+
## License and conduct
71+
72+
By submitting, you agree that your contribution is released under this
73+
repository's [MIT License](LICENSE). Be respectful and constructive in
74+
issues and reviews.

‎CONTRIBUTING_ZH.md‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# 参与贡献
2+
3+
[English](CONTRIBUTING.md)
4+
5+
## 我们收什么
6+
7+
- **一份 stack = 一个人或一个团队真实的日常用法**：一份 `WORKFLOW.md`，加上至少一个 Skill 或清单。
8+
- **不收**：纯 prompt 合集、没人在用的「理想流程」、和某个内部系统强绑定、别人没法跑的东西。
9+
- 也欢迎改进已有的 Skill，请说清楚不改的话 agent 会在哪儿出错。
10+
11+
## 提交流程
12+
13+
1. **先开一个「New stack」issue**，用几句话说清楚你是谁、怎么用 agent、打算放哪几样东西。
14+
2. **从模板复制**到 `community/<id>/`。`id` 只用小写字母、数字和连字符，并且要和 `.minimax-plugin/plugin.json` 里的 `name` 一致。
15+
3. **本地跑校验**，把输出贴进 PR：
16+
17+
```bash
18+
node scripts/check.mjs
19+
# 可选：同时跑 MiniMax Code 官方的插件校验
20+
git clone --depth 1 https://github.com/MiniMax-AI/minimax-code.git ../minimax-code
21+
MINIMAX_CODE_DIR=../minimax-code node scripts/check.mjs
22+
```
23+
24+
4. **PR 里附一段真实的使用记录**：agent 在什么任务里用了这个 Skill，过程是什么样，结果怎么样。不要只贴最终结果。
25+
26+
## 怎么审
27+
28+
每个 PR 至少一位维护者审，看三件事：
29+
30+
- **能不能跑**：校验通过；在 MiniMax Code 里装上后 `/skills` 能看到；agent 能按 `description` 正确加载。
31+
- **是不是真在用**：使用记录要能看出过程，而不只是结论。这也是我们对自己的要求：看 agent 怎么得到结果，不只看结果。
32+
- **安全和边界**：不带密钥、token、内部地址；脚本不做超出说明的事；第三方内容注明出处和许可。
33+
34+
审的时候一般会请作者回答一句：「删掉这个 Skill，你的 agent 会在哪儿犯错？」答不上来的，我们可能会建议先合进已有的 Skill。
35+
36+
## 收录之后
37+
38+
- 进了 `community/`，作者就是这份 stack 的维护人，后续改动由作者自己提 PR。
39+
- 长期没人维护、和新版 MiniMax Code 对不上的，会先标记，再移到归档区。
40+
- 写得好、用的人多的，会在工程笔记或官方渠道里介绍。
41+
42+
## 写好一个 Skill
43+
44+
- frontmatter 里的 `name` 和目录名一致；`description` 一句话写清做什么、**什么时候**用。值里有 `: ` 的话要加引号。
45+
- 步骤要是 agent 真能执行的，按顺序写，并写清每一步怎么确认做对了。
46+
- 要求 agent 拿证据说话（文件、命令、真实输出），不要让 Skill 编数字。
47+
- 写清最后要交回什么。
48+
49+
## 许可和行为规范
50+
51+
提交即表示你同意按本仓库的 [MIT License](LICENSE) 发布。在 issue 和 review 里请保持尊重、就事论事。

‎LICENSE‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 MiniMax Code
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎README.md‎

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
# MCode Stack
2+
3+
[中文](README_ZH.md)
4+
5+
**The workflows and skills the MiniMax Code team uses to build MiniMax Code. Open source, install and use.**
6+
7+
This is not a prompt collection or a list of "best practices". It is what
8+
people on the team actually use every day: how to keep AI-written code at a
9+
high bar, how to decide whether a task should go to a subagent, how long to
10+
wait on a long command, how to keep long sessions from going dull, and what
11+
goes into context on every turn. Everything here installs straight into
12+
[MiniMax Code](https://github.com/MiniMax-AI/minimax-code).
13+
14+
## Why
15+
16+
AI writes code faster every month. What separates results now is the layer
17+
of engineering habits around the agent: when to make it stop and check its
18+
own work, who reviews, where state lives, what counts as a real experiment.
19+
Those habits are hard to follow from an article, so we turned them into
20+
skills and checklists. They pair one to one with our *MCode Engineering
21+
Notes* column: the article explains the idea, this repository makes it
22+
runnable.
23+
24+
We also believe harness engineering is a craft that moves forward by
25+
experiment. Everything here will keep changing as we learn. Take it, change
26+
it, and send your version back.
27+
28+
## What's inside
29+
30+
```text
31+
stacks/ronny/ Ronny's stack (MiniMax Code R&D lead), the first and most complete one
32+
stacks/<name>/ Other team members' stacks (on the way)
33+
notes/ Which runnable piece goes with each Engineering Notes article
34+
community/ Stacks contributed by developers outside the team
35+
templates/stack-template/ Start here to write your own stack
36+
```
37+
38+
A stack usually has three kinds of things:
39+
40+
| Kind | What it is | How to use it |
41+
| --- | --- | --- |
42+
| Skill | A directory with a `SKILL.md` | Invoke it in MiniMax Code with `/<skill-name>`, or let the agent load it from its description |
43+
| Checklist | Also a skill: the agent walks your project item by item. A plain-text copy lives in `checklists/` | Same as above, or just read it |
44+
| Workflow | A `WORKFLOW.md` describing how this person works with MiniMax Code every day | Read it |
45+
46+
### First batch in `stacks/ronny`
47+
48+
| Skill | What it does | Notes |
49+
| --- | --- | --- |
50+
| `independent-review` | Review a diff from a clean context: only diff, requirement and test results | 01 |
51+
| `subagent-split-check` | Decide whether work goes to a subagent or stays in the main loop | 01 |
52+
| `harness-experiment` | Small eval, one change at a time, repeated runs, look at flipped tasks | 01, 02, 06 |
53+
| `tool-budget-audit` | Measure what tools cost in context; trim, tool search or programmatic tool calling | 02 |
54+
| `long-session-check` | Drop, summarize or write to file; compact or start fresh; memory scoping | 03 |
55+
| `handoff-doc` | A hand-off doc so a new session can pick up the work | 01, 03 |
56+
| `long-command-check` | Ten-point audit of long shell commands and background tasks | 04 |
57+
| `context-tax-audit` | What gets injected into every request, and what it does to the prompt cache | 06 |
58+
| `trajectory-review` | Look at how the agent got its result, not only whether it passed | - |
59+
60+
## Install
61+
62+
Clone the repository first:
63+
64+
```bash
65+
git clone https://github.com/MiniMax-AI/mcode-stack.git ~/mcode-stack
66+
```
67+
68+
### Install a single skill
69+
70+
MiniMax Code discovers skills in these directories (one subdirectory per
71+
skill, containing `SKILL.md`):
72+
73+
- For the current project only: `.minimax/skills/`, `.claude/skills/` or
74+
`.agents/skills/` in the project
75+
- For all projects: `~/.agents/skills/` (`~/.claude/skills/` and
76+
`~/.codex/skills/` are read too)
77+
78+
For example, to install the long-command checklist globally:
79+
80+
```bash
81+
mkdir -p ~/.agents/skills
82+
cp -R ~/mcode-stack/stacks/ronny/skills/long-command-check ~/.agents/skills/
83+
```
84+
85+
Open a new session and type `/skills` in MiniMax Code to see it.
86+
87+
The skills use the common `SKILL.md` format, so most of them also work in
88+
other agents that support skills.
89+
90+
### Install a whole stack as a plugin
91+
92+
Every stack is also a MiniMax Code plugin package. Find your local plugin
93+
directory:
94+
95+
```bash
96+
mcode plugin marketplace list
97+
```
98+
99+
Copy the whole `stacks/ronny` directory into that directory, then open
100+
`/plugins` in MiniMax Code and press `Ctrl+R` to refresh. A local plugin is
101+
installed as soon as it is in that directory; press Space in the panel to
102+
enable or disable it.
103+
104+
`mcode plugin add` installs from the official catalog only; it does not take
105+
a GitHub URL or a local path.
106+
107+
## Contribute your own stack
108+
109+
What we most want to see is how you actually work with MiniMax Code, or with
110+
any other agent, day to day.
111+
112+
1. Copy `templates/stack-template/` to `community/<your-id>/`.
113+
2. Write a `WORKFLOW.md`: how you use the agent every day, what you hand to it
114+
and what you keep an eye on yourself.
115+
3. Add at least one skill or checklist you really use.
116+
4. Run `node scripts/check.mjs`, then open a PR with the output and a short
117+
record of real usage.
118+
119+
Details in [CONTRIBUTING.md](CONTRIBUTING.md). Using something from here in
120+
your own agent? Tell us with an **I use this** issue.
121+
122+
## Relationship to MiniMax Code
123+
124+
MiniMax Code itself lives in
125+
[MiniMax-AI/minimax-code](https://github.com/MiniMax-AI/minimax-code). This
126+
repository only holds workflows and skills, no MiniMax Code source code.
127+
128+
## License
129+
130+
[MIT](LICENSE)

0 commit comments

Comments
 (0)