README.zh-CN.md

English · 贡献指南 · Plugin 契约 · 安全

一个目录，就是一个发布单元

MiniMax Code Plugins 是 MiniMax Code Agent Plugin 的社区入口。把 Plugin 放进 plugins/<GitHub 用户名>/<Plugin 名>，提交一个 PR，CI 会直接检查用户最终安装的那份代码。

Fork  →  创建  →  开发  →  校验  →  Pull Request  →  被发现

不用另建仓库，不用写 Catalog JSON，也不用手抄 commit SHA。源码、文档、Review 和修改历史都在 一个地方。

30 秒创建第一个 Plugin

git clone https://github.com/<你的用户名>/MiniMax-Code-Plugins.git
cd MiniMax-Code-Plugins
npm install
npm run create -- <你的用户名>/my-first-plugin

脚手架会生成一个 Skill-first Plugin：

plugins/<你的用户名>/my-first-plugin/
├── plugin.json
├── README.md
├── LICENSE
└── skills/
    └── my-first-plugin/
        └── SKILL.md

替换全部 TODO，然后运行：

npm run check

通过后，为这个 Plugin 提交一个 PR。完整 Review 要求见 CONTRIBUTING.md。

Plugin 能给 Agent 加什么？

Skills

把可复用的指令、工作流和领域知识打包。一个验证过的提示词方法，可以直接变成任何人都能安装的能力。

MCP Servers

通过 stdio、streamable-http 或 sse 连接本地工具和远程服务。依赖、账号、网络目标和数据处理必须 在安装前说清楚。

Skill + MCP

Skill 教会 Agent 怎么做，MCP 给它真正的工具。可移植包结构保持简单：

plugin-root/
├── plugin.json
├── mcp.json                  # 可选
└── skills/                   # 可选

这个仓库只承接 Agent 能力。TUI Extension 是另一套独立扩展体系，不使用这里的包格式和加载流程。

门槛也很简单

一个贡献必须：

• 位于 plugins/<GitHub 用户名>/<Plugin 名>；
• 包含 plugin.json、README.md 和 LICENSE；
• 至少提供一个有效的 Skill 或 MCP Server；
• 写清示例、依赖、网络访问和数据用途；
• 不包含密钥、私有地址、隐藏遥测、原生二进制或 symlink；
• 通过 npm run check 和人工 Review。

通过 Review 代表它可以作为社区软件被发现，不代表 MiniMax 背书或已经完成完整安全审计。安装前仍需阅读 源码和能力声明。

逛逛这个仓库

• plugins/：社区 Plugin 源码
• examples/hello-mcode：最小 Skill Plugin
• examples/hello-mcode-mcp：零依赖 stdio MCP
• docs/plugin-compatibility.md：当前支持的精确契约
• docs/security-model.md：校验与信任模型
• docs/architecture.md：中央托管架构
• GOVERNANCE.md：决策与维护者职责

Community Preview

MiniMax Code 的公开 Plugin 能力仍在稳定中，所以首版契约刻意保持克制。Hooks、自定义 Agent、Commands、 LSP、Apps、通用 OAuth 和 TUI Extension 暂不作为当前 Agent Plugin 能力宣传。

带来一个真的有用的能力，给出一个无法误解的示例，然后用一个 PR 把它发布出来。

License

仓库工具和文档使用 Apache-2.0。每个托管 Plugin 都必须包含并声明自己的开源 License。