Skip to content

Commit 209bc71

Browse files
State that code, docs, and stack PRs are collaborator-only. (#8)
Issues stay open to everyone. The stack template and submission steps remain for collaborators. Co-authored-by: Cursor Agent <cursoragent@cursor.com> Co-authored-by: DanielWalnut <hetaoBackend@users.noreply.github.com>
1 parent d3d902e commit 209bc71

8 files changed

Lines changed: 60 additions & 26 deletions

File tree

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: New stack
2-
description: Propose a stack before opening a PR
2+
description: Propose a stack. Pull requests are accepted only from collaborators.
33
title: "New stack: <your-id>"
44
labels: ["new-stack"]
55
body:

‎CONTRIBUTING.md‎

Lines changed: 13 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,27 @@
22

33
[中文](CONTRIBUTING_ZH.md)
44

5+
Issues and discussion are welcome. For now, pull requests for code,
6+
documentation, and stacks are accepted only from repository collaborators.
7+
If you are not a collaborator, [open an issue](https://github.com/MiniMax-AI/mcode-stack/issues/new/choose)
8+
to discuss first.
9+
10+
The steps below are for collaborators who add or change a stack.
11+
512
## What we accept
613

714
- **A stack = one person's or one team's real daily practice**: a
815
`WORKFLOW.md` plus at least one skill or checklist.
916
- **Not accepted**: pure prompt collections, "ideal" processes nobody runs,
1017
and anything tied to a private system that others cannot run.
11-
- Improvements to existing skills are welcome too. Explain what went wrong
18+
- Collaborators can also improve an existing skill. Explain what went wrong
1219
without the change.
1320

1421
## How to submit a stack
1522

23+
Collaborators follow every step. If you are not a collaborator, do step 1
24+
only.
25+
1626
1. **Open a "New stack" issue first.** In a few sentences: who you are, how
1727
you use agents, and which pieces you plan to include.
1828
2. **Copy the template** to `community/<id>/`. The `id` uses only lowercase
@@ -66,8 +76,8 @@ into an existing skill.
6676

6777
## After it is merged
6878

69-
- The author maintains their stack under `community/` and sends changes as
70-
PRs.
79+
- The author maintains their stack under `community/`. Later changes are
80+
pull requests from collaborators.
7181
- Stacks that go unmaintained or stop matching current MiniMax Code may be
7282
marked and later moved to an archive area.
7383
- Stacks that are well written and widely used may be featured in the

‎CONTRIBUTING_ZH.md‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,20 @@
22

33
[English](CONTRIBUTING.md)
44

5+
欢迎开 issue 讨论。代码、文档和 stack 的 PR,目前只收仓库协作者的。还不是协作者的话,先[开一个 issue](https://github.com/MiniMax-AI/mcode-stack/issues/new/choose) 把想法说清楚。
6+
7+
下面是给协作者加 stack、改 stack 用的。
8+
59
## 我们收什么
610

711
- **一份 stack = 一个人或一个团队真实的日常用法**:一份 `WORKFLOW.md`,加上至少一个 Skill 或清单。
812
- **不收**:纯 prompt 合集、没人在用的「理想流程」、和某个内部系统强绑定、别人没法跑的东西。
9-
- 也欢迎改进已有的 Skill,请说清楚不改的话 agent 会在哪儿出错。
13+
- 协作者也可以改已有的 Skill,请说清楚不改的话 agent 会在哪儿出错。
1014

1115
## 提交流程
1216

17+
协作者走完全部步骤。还不是协作者的,只做第 1 步。
18+
1319
1. **先开一个「New stack」issue**,用几句话说清楚你是谁、怎么用 agent、打算放哪几样东西。
1420
2. **从模板复制**到 `community/<id>/`。`id` 只用小写字母、数字和连字符,并且要和 `.minimax-plugin/plugin.json` 里的 `name` 一致。
1521
3. **登记到插件市场**:在 `.claude-plugin/marketplace.json` 里加一条,`"name"` 填 id,`"source"` 填 `"./community/<id>"`,`description` 和 `plugin.json` 里的保持一致。不要写 `skills` 等组件字段,这些由 `plugin.json` 定义。
@@ -40,7 +46,7 @@ PR 只要改了某份 stack 里的文件,就要同时调高它 `.minimax-plugi
4046

4147
## 收录之后
4248

43-
- 进了 `community/`,作者就是这份 stack 的维护人,后续改动由作者自己提 PR。
49+
- 进了 `community/`,作者就是这份 stack 的维护人。后续改动同样由协作者提 PR。
4450
- 长期没人维护、和新版 MiniMax Code 对不上的,会先标记,再移到归档区。
4551
- 写得好、用的人多的,会在工程笔记或官方渠道里介绍。
4652

‎README.md‎

Lines changed: 14 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ checklist that installs straight into
2626
- [How it works](#how-it-works)
2727
- [Articles](#articles)
2828
- [Stacks](#stacks)
29-
- [Contribute your own stack](#contribute-your-own-stack)
29+
- [Contributing](#contributing)
3030

3131
## Quick start
3232

@@ -170,8 +170,9 @@ skills and checklists. They pair with our *MCode Engineering Notes* column:
170170
the article explains the idea, this repository makes it runnable.
171171

172172
We also believe harness engineering is a craft that moves forward by
173-
experiment. Everything here will keep changing as we learn. Take it, change
174-
it, and send your version back.
173+
experiment. Everything here will keep changing as we learn. Take it and
174+
change it. To suggest a change here, open an issue; see
175+
[Contributing](#contributing).
175176

176177
## Articles
177178

@@ -190,18 +191,23 @@ stacks/ronny/ Ronny's stack (MiniMax Code R&D lead), the first and
190191
stacks/jiachen/ Jiachen's stack: getting out of the agent loop, and turning notes into posts and videos
191192
stacks/<name>/ One directory per team member; teammates are welcome to add theirs
192193
notes/ Which runnable piece goes with each Engineering Notes article
193-
community/ Stacks contributed by developers outside the team
194-
templates/stack-template/ Start here to write your own stack
194+
community/ Stacks from outside the team, added by collaborators
195+
templates/stack-template/ Template for a new stack
195196
```
196197

197198
Every stack is also a MiniMax Code plugin package. See
198199
[`stacks/ronny`](stacks/ronny/) and [`stacks/jiachen`](stacks/jiachen/) for
199200
what each one contains.
200201

201-
## Contribute your own stack
202+
## Contributing
202203

203-
What we most want to see is how you actually work with MiniMax Code, or with
204-
any other agent, day to day.
204+
Issues and discussion are welcome. For now, pull requests for code,
205+
documentation, and stacks are accepted only from repository collaborators.
206+
If you are not a collaborator, [open an issue](https://github.com/MiniMax-AI/mcode-stack/issues/new/choose)
207+
to discuss first.
208+
209+
We still want to hear how you work with MiniMax Code, or any other agent,
210+
day to day. Share that in an issue. Collaborators adding a stack:
205211

206212
1. Copy `templates/stack-template/` to `community/<your-id>/`.
207213
2. Write a `WORKFLOW.md`: how you use the agent every day, what you hand to it

‎README_ZH.md‎

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
- [怎么用起来](#怎么用起来)
2121
- [工程笔记](#工程笔记)
2222
- [Stacks](#stacks)
23-
- [贡献你自己的 stack](#贡献你自己的-stack)
23+
- [参与贡献](#参与贡献)
2424

2525
## 快速开始
2626

@@ -132,7 +132,7 @@ MiniMax Code 会自动发现这几个目录里的 Skill(每个 Skill 一个子
132132

133133
AI 写代码越来越快,真正拉开差距的,是围绕 agent 的那一圈工程习惯:什么时候让它停下来自查,review 交给谁,状态记在哪,实验怎么做才算数。这些东西写在文章里很难照着做,所以我们把它们做成了 Skill 和清单,和「MCode 工程笔记」专栏对应:文章把道理讲清楚,仓库负责落地。
134134

135-
我们也相信,harness 工程是一门靠实验推进的手艺。这里的每一份东西都会随着我们的实践继续改。欢迎拿去用、拿去改,再把你的版本提回来。
135+
我们也相信,harness 工程是一门靠实验推进的手艺。这里的每一份东西都会随着我们的实践继续改。欢迎拿去用、拿去改。想改仓库里的内容,先开 issue,见[参与贡献](#参与贡献)。
136136

137137
## 工程笔记
138138

@@ -151,15 +151,17 @@ stacks/ronny/ MiniMax Code 研发负责人 Ronny 的日常工作
151151
stacks/jiachen/ Jiachen 的工作流:把自己从 agent 的循环里解放出来,以及把笔记做成图文和短视频
152152
stacks/<name>/ 每位成员一个目录,欢迎团队同事把自己的也放进来
153153
notes/ 「MCode 工程笔记」每一篇对应哪一份能跑的东西
154-
community/ 外部开发者提交的 stack
155-
templates/stack-template/ 写你自己的 stack,从这里开始
154+
community/ 团队外的 stack,由协作者加进来
155+
templates/stack-template/ 新增 stack 用的模板
156156
```
157157

158158
每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/) 和 [`stacks/jiachen`](stacks/jiachen/)。
159159

160-
## 贡献你自己的 stack
160+
## 参与贡献
161161

162-
我们最想看到的,是你用 MiniMax Code(或者别的 agent)每天到底怎么干活。
162+
欢迎开 issue 讨论。代码、文档和 stack 的 PR,目前只收仓库协作者的。还不是协作者的话,先[开一个 issue](https://github.com/MiniMax-AI/mcode-stack/issues/new/choose) 把想法说清楚。
163+
164+
我们很想知道你用 MiniMax Code(或者别的 agent)每天到底怎么干活,写在 issue 里就行。协作者要把一份 stack 放进仓库,按这几步:
163165

164166
1. 从 `templates/stack-template/` 复制一份到 `community/<你的 id>/`
165167
2. 写一份 `WORKFLOW.md`:你每天怎么用 agent,哪些环节交给它,哪些自己盯着

‎community/README.md‎

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,11 @@
11
# Community stacks
22

3-
Stacks contributed by developers outside the MiniMax Code team. We want to
4-
see how you actually work with MiniMax Code, or with any agent that supports
5-
`SKILL.md` skills.
3+
Stacks from developers outside the MiniMax Code team: how people actually
4+
work with MiniMax Code, or with any agent that supports `SKILL.md` skills.
5+
6+
Issues and discussion are welcome. For now, pull requests are accepted only
7+
from repository collaborators. If you are not a collaborator, open an issue
8+
to discuss first.
69

710
## What we accept
811

@@ -13,6 +16,9 @@ see how you actually work with MiniMax Code, or with any agent that supports
1316

1417
## How to submit
1518

19+
Collaborators follow every step. If you are not a collaborator, do step 1
20+
only.
21+
1622
1. Open a **New stack** issue first: who you are, how you use agents, and what
1723
you plan to include.
1824
2. Copy `templates/stack-template/` to `community/<your-id>/`.
@@ -31,4 +37,4 @@ Full rules: [CONTRIBUTING.md](../CONTRIBUTING.md).
3137

3238
| Stack | Author | What it covers |
3339
| --- | --- | --- |
34-
| *Yours could be the first.* | | |
40+
| *None yet.* | | |

‎stacks/README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -29,4 +29,6 @@ Keep it public-safe: no internal hostnames, links, project codenames,
2929
internal metrics, credentials or customer data. Skills must work for someone
3030
outside the team.
3131

32-
External contributors: please use [`community/`](../community/) instead.
32+
Stacks from outside the team go in [`community/`](../community/). Pull
33+
requests are accepted only from repository collaborators. If you are not a
34+
collaborator, open an issue first. See [CONTRIBUTING.md](../CONTRIBUTING.md).

‎templates/stack-template/README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# Stack template
22

3-
Copy this directory to start your own stack:
3+
Copy this directory to start a stack. Pull requests that add one are accepted
4+
only from repository collaborators. If you are not a collaborator, open an
5+
issue first ([CONTRIBUTING.md](../../CONTRIBUTING.md)).
46

57
```bash
68
cp -R templates/stack-template community/<your-id>

0 commit comments

Comments
 (0)