diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 0aae76b..1176c3e 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -14,7 +14,8 @@ "category": "Code", "author": { "name": "Ronny (MiniMax Code team)" - } + }, + "homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/ronny" }, { "name": "jiachen", diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml index 0086358..d1b3090 100644 --- a/.github/ISSUE_TEMPLATE/config.yml +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -1 +1,5 @@ blank_issues_enabled: true +contact_links: + - name: Bug or feature request for MiniMax Code itself + url: https://github.com/MiniMax-AI/minimax-code/issues + about: This repository only holds workflows and skills. Report problems with the MiniMax Code app or CLI there. diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md index b520892..29cfd4a 100644 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -19,4 +19,4 @@ - [ ] No keys, tokens, internal hostnames or private links - [ ] Third-party content is credited with its license -- [ ] I agree to release this under the repository's MIT License +- [ ] I agree to release my own work here under the repository's MIT License (third-party material keeps its own license, noted in the stack's `NOTICE.md`) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 9c347f2..c4cabb9 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -83,5 +83,6 @@ into an existing skill. ## License and conduct By submitting, you agree that your contribution is released under this -repository's [MIT License](LICENSE). Be respectful and constructive in +repository's [MIT License](LICENSE). Third-party material keeps its own +license: credit it and note the license in your stack's `NOTICE.md`. Be respectful and constructive in issues and reviews. diff --git a/CONTRIBUTING_ZH.md b/CONTRIBUTING_ZH.md index 9b90401..8cca714 100644 --- a/CONTRIBUTING_ZH.md +++ b/CONTRIBUTING_ZH.md @@ -53,4 +53,4 @@ PR 只要改了某份 stack 里的文件,就要同时调高它 `.minimax-plugi ## 许可和行为规范 -提交即表示你同意按本仓库的 [MIT License](LICENSE) 发布。在 issue 和 review 里请保持尊重、就事论事。 +提交即表示你同意按本仓库的 [MIT License](LICENSE) 发布。第三方内容沿用它原来的许可,请注明出处,并在 stack 的 `NOTICE.md` 里写清许可。在 issue 和 review 里请保持尊重、就事论事。 diff --git a/README.md b/README.md index 50ca733..e810366 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,7 @@

License: MIT validate - skills: 15 + skills: 17 for MiniMax Code

@@ -110,6 +110,14 @@ other agents that support skills. | | [`trajectory-review`](stacks/ronny/skills/trajectory-review/SKILL.md) | Look at how the agent got its result, not only whether it passed | | | [`engineering-emergency-changes`](stacks/ronny/skills/engineering-emergency-changes/SKILL.md) | Decide whether a hotfix is a real emergency and run expedited review safely | +The table above is [`stacks/ronny`](stacks/ronny/). +[`stacks/jiachen`](stacks/jiachen/) adds two more skills: +[`lifting-loops`](stacks/jiachen/skills/lifting-loops/SKILL.md), which finds +the loops where you keep acting as a manual step for your agents and lifts you +out of them, and [`making-content`](stacks/jiachen/skills/making-content/SKILL.md), +which turns notes and material into Xiaohongshu image posts and short vertical +videos. + A stack usually has three kinds of things: | Kind | What it is | How to use it | @@ -150,15 +158,15 @@ it, and send your version back. ```text stacks/ronny/ Ronny's stack (MiniMax Code R&D lead), the first and most complete one stacks/jiachen/ Jiachen's stack: getting out of the agent loop, and turning notes into posts and videos -stacks// Other team members' stacks (on the way) +stacks// One directory per team member; teammates are welcome to add theirs notes/ Which runnable piece goes with each Engineering Notes article community/ Stacks contributed by developers outside the team templates/stack-template/ Start here to write your own stack ``` Every stack is also a MiniMax Code plugin package. See -[`stacks/ronny`](stacks/ronny/) for its skills, checklists and -[`WORKFLOW.md`](stacks/ronny/WORKFLOW.md). +[`stacks/ronny`](stacks/ronny/) and [`stacks/jiachen`](stacks/jiachen/) for +what each one contains. ## Contribute your own stack diff --git a/README_ZH.md b/README_ZH.md index 3f7a8b1..abffa16 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -5,7 +5,7 @@

License: MIT validate - skills: 15 + skills: 17 for MiniMax Code

@@ -91,6 +91,8 @@ MiniMax Code 会自动发现这几个目录里的 Skill(每个 Skill 一个子 | | [`trajectory-review`](stacks/ronny/skills/trajectory-review/SKILL.md) | 不只看结果过没过,回头看 agent 是怎么得到这个结果的 | | | [`engineering-emergency-changes`](stacks/ronny/skills/engineering-emergency-changes/SKILL.md) | 判断 hotfix 是不是真紧急,紧急时怎么快审又不丢质量 | +上表是 [`stacks/ronny`](stacks/ronny/) 的内容。[`stacks/jiachen`](stacks/jiachen/) 另有两个 Skill:[`lifting-loops`](stacks/jiachen/skills/lifting-loops/SKILL.md) 找出你总在给 agent 当「人工环节」的那些循环,帮你从里面抽身;[`making-content`](stacks/jiachen/skills/making-content/SKILL.md) 把笔记和素材做成小红书图文和竖版短视频。 + 每个 stack 里一般有三类东西: | 类型 | 是什么 | 怎么用 | @@ -124,13 +126,13 @@ AI 写代码越来越快,真正拉开差距的,是围绕 agent 的那一圈 ```text stacks/ronny/ MiniMax Code 研发负责人 Ronny 的日常工作流,第一份,也是目前最完整的一份 stacks/jiachen/ Jiachen 的工作流:把自己从 agent 的循环里解放出来,以及把笔记做成图文和短视频 -stacks// 团队其他成员各自的工作流(陆续上线) +stacks// 每位成员一个目录,欢迎团队同事把自己的也放进来 notes/ 「MCode 工程笔记」每一篇对应哪一份能跑的东西 community/ 外部开发者提交的 stack templates/stack-template/ 写你自己的 stack,从这里开始 ``` -每份 stack 本身也是一个 MiniMax Code 插件包。[`stacks/ronny`](stacks/ronny/) 里有它的 Skill、清单和 [`WORKFLOW.md`](stacks/ronny/WORKFLOW.md)。 +每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/) 和 [`stacks/jiachen`](stacks/jiachen/)。 ## 贡献你自己的 stack diff --git a/community/README.md b/community/README.md index 9f005b3..18d2804 100644 --- a/community/README.md +++ b/community/README.md @@ -16,8 +16,12 @@ see how you actually work with MiniMax Code, or with any agent that supports 1. Open a **New stack** issue first: who you are, how you use agents, and what you plan to include. 2. Copy `templates/stack-template/` to `community//`. -3. Run `node scripts/check.mjs` locally and paste the output into the PR. -4. Include a short **real usage record** in the PR: the task where the agent +3. Add an entry for it to + [`.claude-plugin/marketplace.json`](../.claude-plugin/marketplace.json) + (`"source": "./community/"`, the same `description` as your + `plugin.json`). +4. Run `node scripts/check.mjs` locally and paste the output into the PR. +5. Include a short **real usage record** in the PR: the task where the agent used the skill, what the process looked like, and how it went. Show the process, not only the final result. diff --git a/stacks/README.md b/stacks/README.md index 49f4c45..7b530c2 100644 --- a/stacks/README.md +++ b/stacks/README.md @@ -9,7 +9,7 @@ MiniMax Code plugin package. | [`ronny`](ronny/) | Ronny, R&D lead | 15 skills, 5 checklists | | [`jiachen`](jiachen/) | Jiachen, engineer | 2 skills | -More team members' stacks are on the way. +Teammates are welcome to add their own; see below. ## Adding a team stack diff --git a/stacks/ronny/.minimax-plugin/plugin.json b/stacks/ronny/.minimax-plugin/plugin.json index 7317e19..3a7beef 100644 --- a/stacks/ronny/.minimax-plugin/plugin.json +++ b/stacks/ronny/.minimax-plugin/plugin.json @@ -1,7 +1,7 @@ { "schemaVersion": 1, "name": "ronny", - "version": "0.2.1", + "version": "0.2.2", "displayName": "Ronny's MCode Stack", "description": "Daily workflows and self-check skills from the MiniMax Code R&D lead: independent review, subagent split checks, tool and context budget audits, long sessions, long commands, harness experiments, trajectory review, plus everyday engineering practice for code review, review comments, small PRs, change descriptions and emergency changes.", "author": "Ronny (MiniMax Code team)", diff --git a/stacks/ronny/README.md b/stacks/ronny/README.md index 572a412..0da3064 100644 --- a/stacks/ronny/README.md +++ b/stacks/ronny/README.md @@ -1,9 +1,24 @@ # ronny The first stack in MCode Stack: the workflows and self-check skills of -Ronny, R&D lead of MiniMax Code. Each skill pairs with an article in the +Ronny, R&D lead of MiniMax Code. Most skills pair with an article in the *MCode Engineering Notes* series (see [`../../notes/`](../../notes/)). +## Install + +From the marketplace, in Claude Code: + +```bash +/plugin marketplace add MiniMax-AI/mcode-stack +/plugin install ronny@mcode-stack +``` + +In MiniMax Code, copy this whole directory into the local plugin directory +shown by `mcode plugin marketplace list`, or copy single skills into +`~/.agents/skills/`. See the [repository README](../../README.md#quick-start). + +## Skills + | Skill | What it does | Notes | | --- | --- | --- | | [`independent-review`](skills/independent-review/SKILL.md) | Review a diff from a clean context: only diff, requirement and test results; structured findings verified before fixing | 01 | @@ -33,4 +48,3 @@ and adapted from Google Engineering Practices (CC-BY 3.0). See | [`engineering-emergency-changes`](skills/engineering-emergency-changes/SKILL.md) | Decide whether a hotfix is a real emergency and run expedited review safely | Plain-text versions of the checklists live in [`checklists/`](checklists/). -How Ronny strings them together: [`WORKFLOW.md`](WORKFLOW.md) (coming soon). diff --git a/stacks/ronny/WORKFLOW.md b/stacks/ronny/WORKFLOW.md index d98b271..3cf04ef 100644 --- a/stacks/ronny/WORKFLOW.md +++ b/stacks/ronny/WORKFLOW.md @@ -1,12 +1,6 @@ -# Ronny's day with MiniMax Code +# Ronny's stack: when to use each skill -> **Coming soon.** This page will describe, in Ronny's own words, how he works -> with MiniMax Code every day: which parts he hands to the agent, how reviews -> are arranged, how experiments are recorded, and where he keeps a close eye -> himself. It is intentionally left empty until he writes it. - -Until then, the skills in [`skills/`](skills/) are the parts of the workflow -that are already written down. A rough map: +Which skill in [`skills/`](skills/) fits which moment of the day: | Moment in the day | Skill | | --- | --- | diff --git a/templates/stack-template/README.md b/templates/stack-template/README.md index ea69692..157f470 100644 --- a/templates/stack-template/README.md +++ b/templates/stack-template/README.md @@ -9,7 +9,7 @@ cp -R templates/stack-template community/ Then: 1. Rename the plugin: set `name` in `.minimax-plugin/plugin.json` to ``. - It must equal the directory name (lowercase letters, digits, `.`, `_`, `-`). + It must equal the directory name (lowercase letters, digits and hyphens). 2. Fill in `description`, `author` and, optionally, up to three `exampleQueries`. 3. Replace `icon.png` with your own PNG, JPEG or WebP icon if you like. 4. Rename `skills/example` and write your skills. List every skill in `skills`