Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions .agents/plugins/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,18 @@
"authentication": "ON_INSTALL"
},
"category": "Productivity"
},
{
"name": "youfang",
"source": {
"source": "local",
"path": "./stacks/youfang"
},
"policy": {
"installation": "AVAILABLE",
"authentication": "ON_INSTALL"
},
"category": "Productivity"
}
]
}
10 changes: 10 additions & 0 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,16 @@
"name": "MiniMax Code team"
},
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/req-tpm"
},
{
"name": "youfang",
"source": "./stacks/youfang",
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
"category": "Productivity",
"author": {
"name": "Youfang (MiniMax Code team)"
},
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang"
}
]
}
22 changes: 16 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,9 @@ Inside a Claude Code session:
/plugin install ronny --marketplace MiniMax-AI/mcode-stack
```

Use `jiachen` or `req-tpm` in place of `ronny` for those stacks. From a clone of this
repository, `scripts/install.sh` installs `ronny` (`scripts/install.sh jiachen`
or `scripts/install.sh req-tpm` for the others) with `claude` or `codex` when either is on `PATH`, and
Use `jiachen`, `req-tpm` or `youfang` in place of `ronny` for those stacks. From a clone of this
repository, `scripts/install.sh` installs `ronny` (`scripts/install.sh jiachen`,
`scripts/install.sh req-tpm` or `scripts/install.sh youfang` for the others) with `claude` or `codex` when either is on `PATH`, and
otherwise copies that stack's skills into `~/.agents/skills/`.

Older Claude Code can add the marketplace first, then install:
Expand All @@ -63,7 +63,7 @@ codex plugin marketplace add MiniMax-AI/mcode-stack
codex plugin add ronny@mcode-stack
```

Substitute `jiachen` or `req-tpm` the same way. To take a single skill instead of the
Substitute `jiachen`, `req-tpm` or `youfang` the same way. To take a single skill instead of the
plugin, copy that skill's folder into `~/.agents/skills/`. Codex and MiniMax
Code both scan that directory; the copy steps are below.

Expand Down Expand Up @@ -163,6 +163,14 @@ v0 and needs the `meegle` and `lark-cli` CLIs plus a one-time look-up of your
Meegle space's fields and states; see
[`stacks/req-tpm/README.md`](stacks/req-tpm/README.md).

[`stacks/youfang`](stacks/youfang/) has
[`magic-move-deck`](stacks/youfang/skills/magic-move-deck/SKILL.md), which
turns an architecture or flow walkthrough into a Keynote-style Magic Move
slide deck: every slide is a diagram seen through a camera, and the boxes and
titles two slides share morph between them. The agent shows one sample slide
in each of four styles (hand-drawn, minimal, dark neon, neo-brutalist) and
builds the deck in the one you pick, as a single offline HTML file.

A stack usually has three kinds of things:

| Kind | What it is | How to use it |
Expand Down Expand Up @@ -205,15 +213,17 @@ change it. To suggest a change here, open an issue; see
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/req-tpm/ Optional: the requester and their agent act as a requirement's TPM (Feishu doc body, Meegle status); v0
stacks/youfang/ Youfang's stack: architecture walkthroughs as Magic Move slide decks, in four styles
stacks/<name>/ One directory per team member; teammates are welcome to add theirs
notes/ Which runnable piece goes with each Engineering Notes article
community/ Stacks from outside the team, added by collaborators
templates/stack-template/ Template for a new stack
```

Every stack is also a MiniMax Code plugin package. See
[`stacks/ronny`](stacks/ronny/), [`stacks/jiachen`](stacks/jiachen/) and
[`stacks/req-tpm`](stacks/req-tpm/) for what each one contains.
[`stacks/ronny`](stacks/ronny/), [`stacks/jiachen`](stacks/jiachen/),
[`stacks/req-tpm`](stacks/req-tpm/) and [`stacks/youfang`](stacks/youfang/) for
what each one contains.

## Contributing

Expand Down
9 changes: 6 additions & 3 deletions README_ZH.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ claude plugin install ronny --marketplace MiniMax-AI/mcode-stack
/plugin install ronny --marketplace MiniMax-AI/mcode-stack
```

装 Jiachen 的 stack 时,把 `ronny` 换成 `jiachen`;装需求管理的 stack 时换成 `req-tpm`。克隆本仓库后可以跑 `scripts/install.sh`(默认 `ronny`,或 `scripts/install.sh jiachen`、`scripts/install.sh req-tpm`):`PATH` 里有 `claude` 或 `codex` 时,它会执行同样的安装,否则把该 stack 的 Skill 复制到 `~/.agents/skills/`。
装 Jiachen 的 stack 时,把 `ronny` 换成 `jiachen`;装需求管理的 stack 时换成 `req-tpm`;装 Youfang 的 stack 时换成 `youfang`。克隆本仓库后可以跑 `scripts/install.sh`(默认 `ronny`,或 `scripts/install.sh jiachen`、`scripts/install.sh req-tpm`、`scripts/install.sh youfang`):`PATH` 里有 `claude` 或 `codex` 时,它会执行同样的安装,否则把该 stack 的 Skill 复制到 `~/.agents/skills/`。

较旧的 Claude Code 可以先加市场,再安装:

Expand All @@ -52,7 +52,7 @@ codex plugin marketplace add MiniMax-AI/mcode-stack
codex plugin add ronny@mcode-stack
```

把 `ronny` 换成 `jiachen` 即可。如果只要某一个 Skill,把它的目录复制到 `~/.agents/skills/`。Codex 和 MiniMax Code 都会扫描这个目录,复制步骤见下文。
把 `ronny` 换成 `jiachen`、`req-tpm` 或 `youfang` 即可。如果只要某一个 Skill,把它的目录复制到 `~/.agents/skills/`。Codex 和 MiniMax Code 都会扫描这个目录,复制步骤见下文。

**装一个 Skill,所有项目都能用:**

Expand Down Expand Up @@ -122,6 +122,8 @@ MiniMax Code 会自动发现这几个目录里的 Skill(每个 Skill 一个子

[`stacks/req-tpm`](stacks/req-tpm/README_ZH.md) 是一份可选的需求管理 stack:谁提的产品或技术需求,谁就和自己的 agent 一起当这条需求的 TPM。受理时先追问该不该做,写死可衡量的预期效果;优先级交给负责人拍板;记下方案决策;按节奏跟进,停滞的显式标出来;上线前过检查项;最后拿证据对照预期效果才关闭。需求正文放飞书文档,状态和流转放飞书项目(Meegle)。目前是 v0,需要 `meegle` 和 `lark-cli`,并先在自己的 Meegle 空间里查一遍字段和状态,见 [`stacks/req-tpm/README_ZH.md`](stacks/req-tpm/README_ZH.md)。

[`stacks/youfang`](stacks/youfang/) 里有 [`magic-move-deck`](stacks/youfang/skills/magic-move-deck/SKILL.md):把一次架构或流程讲解做成 Keynote 式「神奇移动」演示,每一页都是某张图加一个镜头取景,前后页共有的框和标题直接变形飞过去。agent 先用四种风格(手绘、简约、暗色科技、新野兽派)各出一张样张,你选定后再按这种风格做完整的单文件离线 HTML。

每个 stack 里一般有三类东西:

| 类型 | 是什么 | 怎么用 |
Expand Down Expand Up @@ -156,13 +158,14 @@ AI 写代码越来越快,真正拉开差距的,是围绕 agent 的那一圈
stacks/ronny/ MiniMax Code 研发负责人 Ronny 的日常工作流,第一份,也是目前最完整的一份
stacks/jiachen/ Jiachen 的工作流:把自己从 agent 的循环里解放出来,以及把笔记做成图文和短视频
stacks/req-tpm/ 可选:需求提出人和自己的 agent 一起当这条需求的 TPM(正文在飞书文档,状态在 Meegle),v0
stacks/youfang/ Youfang 的工作流:把架构讲解做成「神奇移动」演示,四种风格可选
stacks/<name>/ 每位成员一个目录,欢迎团队同事把自己的也放进来
notes/ 「MCode 工程笔记」每一篇对应哪一份能跑的东西
community/ 团队外的 stack,由协作者加进来
templates/stack-template/ 新增 stack 用的模板
```

每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/)、[`stacks/jiachen`](stacks/jiachen/) 和 [`stacks/req-tpm`](stacks/req-tpm/README_ZH.md)。
每份 stack 本身也是一个 MiniMax Code 插件包,具体内容见 [`stacks/ronny`](stacks/ronny/)、[`stacks/jiachen`](stacks/jiachen/)、[`stacks/req-tpm`](stacks/req-tpm/README_ZH.md) 和 [`stacks/youfang`](stacks/youfang/)。

## 参与贡献

Expand Down
1 change: 1 addition & 0 deletions stacks/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ MiniMax Code plugin package.
| [`ronny`](ronny/) | Ronny, R&D lead | Skills and plain-text checklists |
| [`jiachen`](jiachen/) | Jiachen, engineer | Skills and a `WORKFLOW.md` |
| [`req-tpm`](req-tpm/) | MiniMax Code team | Optional, v0: the requester and their agent act as a requirement's TPM (Feishu doc body, Meegle status). Skills, templates and a `WORKFLOW.md` |
| [`youfang`](youfang/) | Youfang, engineer | A skill that turns diagram walkthroughs into Magic Move slide decks (four styles, sample first), and a `WORKFLOW.md` |

Teammates are welcome to add their own; see below.

Expand Down
11 changes: 11 additions & 0 deletions stacks/youfang/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"name": "youfang",
"displayName": "Youfang's MCode Stack",
"version": "0.1.0",
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
"author": {
"name": "Youfang (MiniMax Code team)"
},
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
"repository": "https://github.com/MiniMax-AI/mcode-stack"
}
28 changes: 28 additions & 0 deletions stacks/youfang/.codex-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
{
"name": "youfang",
"version": "0.1.0",
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
"author": {
"name": "Youfang (MiniMax Code team)"
},
"homepage": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
"repository": "https://github.com/MiniMax-AI/mcode-stack",
"skills": "./skills/",
"interface": {
"displayName": "Youfang's MCode Stack",
"shortDescription": "Diagram walkthroughs as Magic Move slide decks, in four styles.",
"longDescription": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
"developerName": "Youfang (MiniMax Code team)",
"category": "Productivity",
"capabilities": [
"Read",
"Write"
],
"websiteURL": "https://github.com/MiniMax-AI/mcode-stack/tree/main/stacks/youfang",
"defaultPrompt": [
"把这套架构讲解做成 Magic Move 演示,先给我看四种风格的样张",
"Make an animated slide deck that walks through our ingestion pipeline",
"Switch this deck to the dark neon style and export a 1080p video"
]
}
}
20 changes: 20 additions & 0 deletions stacks/youfang/.minimax-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
{
"schemaVersion": 1,
"name": "youfang",
"version": "0.1.0",
"displayName": "Youfang's MCode Stack",
"description": "Turn architecture and flow diagrams into Keynote-style Magic Move slide decks: one offline HTML file where the boxes and titles two slides share morph and fly, in one of four visual styles (hand-drawn, minimal, dark neon, neo-brutalist) picked from rendered samples, with optional 4K video export.",
"author": "Youfang (MiniMax Code team)",
"icon": "icon.png",
"category": "Productivity",
"exampleQueries": [
"把这套架构讲解做成 Magic Move 演示,先给我看四种风格的样张",
"Make an animated slide deck that walks through our ingestion pipeline",
"Switch this deck to the dark neon style and export a 1080p video"
],
"apps": [],
"mcpServers": [],
"skills": [
"skills/magic-move-deck/SKILL.md"
]
}
49 changes: 49 additions & 0 deletions stacks/youfang/NOTICE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
# Third-party notices

## handdrawn-diagram

[`skills/magic-move-deck/styles/handdrawn/diagram.html`](skills/magic-move-deck/styles/handdrawn/diagram.html)
is adapted from the template in
[TrentChou/handdrawn-diagram](https://github.com/TrentChou/handdrawn-diagram):
its palette, typography, shape helpers and `main()` contract. The other three
style templates follow the same helper API. Changes for this stack: a 1920×1080
default canvas, a card palette (`C.card`) and a `glow` entry used by the deck
engine.

```
MIT License
Copyright (c) 2026 TrentChou
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## Loaded at run time, not bundled

- [rough.js](https://roughjs.com) 4.6.6 (MIT), loaded from jsDelivr when a
diagram is rendered. Built decks contain the SVG it produced, not the
library.
- [Noto Serif SC](https://fonts.google.com/noto/specimen/Noto+Serif+SC)
(SIL Open Font License 1.1), loaded from Google Fonts by the hand-drawn
template as a fallback when no Songti font is installed.
- [Playwright](https://playwright.dev) (Apache-2.0) and ffmpeg run the build,
screenshot and video scripts; they are installed by the user.

Everything else in this stack is released under the repository's
[MIT License](../../LICENSE).
68 changes: 68 additions & 0 deletions stacks/youfang/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# youfang

The stack of Youfang, an engineer on MiniMax Code: one skill that turns an
architecture or flow walkthrough into a Keynote-style **Magic Move** slide
deck. Every slide is a diagram seen through a camera, and the boxes, labels
and titles two slides share morph and fly instead of cross-fading. The agent
first renders one sample slide in each of four styles; you pick one and it
builds the whole deck in that style.

| A · Hand-drawn | B · Minimal |
| --- | --- |
| ![hand-drawn](skills/magic-move-deck/styles/handdrawn/preview.png) | ![minimal](skills/magic-move-deck/styles/minimal/preview.png) |
| **C · Dark neon** | **D · Neo-brutalist** |
| ![neon](skills/magic-move-deck/styles/neon/preview.png) | ![brutalist](skills/magic-move-deck/styles/brutalist/preview.png) |

## Install

In Claude Code, one command installs this stack. In a shell:

```bash
claude plugin install youfang --marketplace MiniMax-AI/mcode-stack
```

Inside a session:

```bash
/plugin install youfang --marketplace MiniMax-AI/mcode-stack
```

Older Claude Code can add the marketplace first, then install:

```bash
/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install youfang@mcode-stack
```

In Codex, add the marketplace, then install from the Plugins Directory or the CLI:

```bash
codex plugin marketplace add MiniMax-AI/mcode-stack
codex plugin add youfang@mcode-stack
```

In MiniMax Code, copy this whole directory into the local plugin directory
shown by `mcode plugin marketplace list`, or copy the skill into
`~/.agents/skills/`. See the [repository README](../../README.md#quick-start).

| Skill | What it does |
| --- | --- |
| [`magic-move-deck`](skills/magic-move-deck/SKILL.md) | Plan the storyline (cover → overview → per topic: zoom into its region, detail diagram, three spotlights → overview → closing card), draw one detail diagram, render it in four styles for you to choose, then draw the remaining diagrams in that style and build one offline 1920×1080 HTML deck. Shared elements are matched by name across slides. Screenshots every slide and transition to check the result; optional 4K / 1080p video with background music. |

A complete example deck (a RAG knowledge assistant, 19 slides) with its
sources, configuration and previews is in
[`skills/magic-move-deck/examples/rag-assistant/`](skills/magic-move-deck/examples/rag-assistant/).

## Requirements

- Python 3 and Playwright's Chromium:
`pip install playwright && playwright install chromium`.
- `ffmpeg`, only for video export.
- Network access while diagrams are rendered (rough.js from jsDelivr). The
built deck is a single file that works offline.
- Fonts: Times New Roman and a Songti font for the hand-drawn style (shipped
with macOS and Windows); the other styles use the system UI font with
PingFang SC, Microsoft YaHei or Noto Sans SC for Chinese.

How this fits into a working day: [`WORKFLOW.md`](WORKFLOW.md). Third-party
credits: [`NOTICE.md`](NOTICE.md).
Loading
Loading