nika-plugins
supernovae-st/nika-plugins加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
你给 Claude Code 下达了一个需求:「帮我把这个 Python 项目加上类型注解,并确保每次提交前都跑一遍测试。」Claude 理解了,洋洋洒洒写了一大段类型注解,commit message 也编好了。你满心欢喜运行 git push——然后 CI 报红:测试根本没跑。
问题出在哪?不是模型不够聪明,而是你的 AI 助手不知道你的团队规矩。谁负责写测试?commit 前要做什么检查?某种特定的代码风格要怎么遵守?这些靠「提示」一次又一次塞给 AI,既低效又容易遗漏。
supernovae-st/nika-plugins 解决的就是这个问题——它为多种 AI 编程工具提供了一套可安装的工作流包(plugins),让 AI 助手在开始工作前就「学会」你的团队规范,而且是自动化的、版本化的。

2026 年 8 月,OpenAI、GitHub、Anthropic、Google、Vercel 等五大 AI 玩家联合发布了 Agent Plugins 1.0 开放标准(公开 beta 预计 2026 年 Q4 上线),旨在为 AI Agent 建立一套通用的插件格式规范。在此之前,各家的 AI 编程助手(Claude Code、Codex、Cursor 等)各自为政,插件格式互不兼容——一个为 Claude Code 写的 skill 没法在 Codex 里用。
而 nika-plugins 的作者 supernovae-st 正是这一标准的早期实践者。这个仓库在 2026 年 8 月发布,目标是成为 Nika 工作流的标准化分发点——Nika 是一个用纯文本定义工作流的轻量引擎,开发者可以用它把团队规范打包成 AI 可读的工作流规范,在各种 AI 编程工具里一键安装。
这背后的核心思想很朴素:LLM 在 token 消耗前和消耗后都需要「检查」。在花掉 token 之前,AI 需要知道自己要做什么规范;完成任务后,需要验证结果是否符合预期。Nika 的 mcp oracle(MCP 服务器)提供了 9 个只读工具:nika_check、nika_explain、nika_schema、nika_examples、nika_template、nika_canon、nika_catalog、nika_tools、nika_inspect,让 AI 可以在执行前后调用这些工具确认自己是否按规矩办事。
nika-plugins 采用了「引擎 + 插件」的二层架构:
引擎层(supernovae-st/nika):用 Homebrew 或 install.sh 安装 nika 二进制文件,这是整个系统的核心引擎。它读取团队定义的 .agents 规范文件(纯文本),供 AI 在执行工作流前做检查。
插件层(supernovae-st/nika-plugins):安装引擎后,用一行命令把 Nika 工作流「插」进你正在用的 AI 编程工具。
支持的客户端非常广泛:
| 安装方式 | 适用客户端 |
|---|---|
claude plugin install nika@nika | Claude Code |
codex plugin add nika@nika | OpenAI Codex |
grok plugin install nika@nika --trust | xAI Grok Build |
openclaude plugin install nika@nika | OpenClaude |
npx plugins add supernovae-st/nika-plugins | Vercel 跨客户端安装(自动识别本机 Claude Code/Cursor/Codex/Grok 等) |
npx skills add supernovae-st/nika-plugins | Hermes / skills.sh 生态 |
通过 npx plugins add 安装时,Vercel 的检测脚本会自动扫描本机安装了哪些 AI 编程工具,然后逐一通过各工具的原生插件系统完成安装——一条命令,覆盖所有客户端。
这套插件包含:
项目的 AGENTS.md 中定义了一条「ONE law」:mirror.json 是漂移契约。整个仓库的文件分为两类:
engine-mirror 类(.agents/plugins/nika/**):这些是 supernovae-st/nika 引擎的逐字节镜像,通过 SHA256 校验固定在特定版本上。如果你在插件仓库里手动改了某个文件,与引擎 SHA 对不上就会触发 CI 告警。真正修复 bug 要去引擎仓库提交 PR,再重新同步。
kit-native 类(skills/**、integrations/**):这些是插件仓库自己维护的内容,包括针对不同客户端的 wiring 配置、各平台的描述文案等。
这种设计解决了插件生态中的一个常见矛盾:插件仓库既需要「镜像」上游引擎(保证同步),又需要「定制」自身特有内容(客户端 wiring)。通过 mirror.json 声明式地分离两类文件,用 CI gate 确保镜像一致性,就不需要硬编码路径列表来维护了。
安装层面:极其简单。一条 curl 命令装引擎,一条 npx 命令装插件,全程不需要写任何配置。
理解层面:需要理解 Nika 的工作流哲学。.agents 规范文件的格式、hook 的触发时机、oracle 工具的使用方式——这些不是开箱即用的功能,而是一套需要团队内部先定义好的「规范文档」。如果团队没有现成的工作流规范,这套工具的价值会大打折扣。
技术要求:Python 语言项目,了解 .agents 规范格式,有团队工作流需要管理。
没有 Web UI:这是一套纯命令行工具,所有操作通过终端完成。对于不熟悉命令行的用户有较高门槛。
Stars 过低(2★):截至分析时该项目仅 2 stars,说明目前用户规模极小,还处于早期探索阶段,生态成熟度有待验证。
Nika 引擎本身是闭源的吗:仓库中 .agents/plugins/nika/** 是引擎镜像,实际的 Nika 引擎代码仓库本身可能不是开源的。这意味着整个系统的核心逻辑是封闭的,用户对引擎本身没有修改权。
依赖平台兼容性:插件通过各 AI 工具的原生插件系统安装,若某客户端插件系统有 breaking change,需要等待插件仓库更新适配。
在 Agent Plugins 1.0 正式规范发布前夕,nika-plugins 提前践行了多客户端插件分发的思路。虽然目前规模极小,但它在以下方面值得关注:
多客户端兼容:通过 clients.yaml 矩阵(manifest/skills/subagents/commands/hooks/rules/mcp/presentation/scaffold 九大类组件 × 各客户端),系统性地管理跨客户端兼容性,而非针对每个客户端单独维护。
镜像同步机制:mirror.json + SHA256 校验 + CI gate 的设计,为「插件生态如何安全同步上游引擎」提供了一个可参考的实现样本。
MCP Oracle:9 个只读工具的设计,让 AI 在执行前可以「查询规范」,而不是靠「背提示词」,这可能是未来 AI Agent 规范执行的主流方向之一。
一句话总结:nika-plugins 是一个跨客户端 AI 编程助手的插件分发点,通过 Nika 工作流引擎让 AI 在执行任务前「学会」团队规范,但目前仍处于极早期探索阶段,生态价值有待验证。