菜单
Implement Zhin.js plugins with Plugin Runtime. Use when asked to create a plugin, add commands, middleware, components, cron, AI tools/skills/agents, config, database, router, or console pages. 适用于 definePlugin / 约定目录能力落地。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/zhinjs/zhin --skill zhin-plugin-standard-development命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
回合末或 master 说「记住」时，将 1–3 条可检索事实写入 memory_entries（memory_upsert），文件 MEMORY.md 仅保留纲领。
审查和改进 Zhin.js 插件质量（Plugin Runtime）。Use when asked to review plugin code, audit structure, or improve before publishing. 检查 definePlugin、约定目录、发送链与安全。
Migrate legacy Zhin.js plugins and projects to the convention-based Plugin Runtime — from usePlugin/getPlugin/addCommand/addMiddleware/addComponent/addTool/addCron/declareConfig/useContext and mutable registries to definePlugin + capability directories + Scope/Token resources. Use this whenever a Zhin plugin fails to load under `zhin runtime start`, errors with "does not default-export a Plugin definition", still imports zhin.js/@zhin.js/core/@zhin.js/kernel, or when asked to upgrade, port, modernize, or migrate a Zhin plugin, command, middleware, component, tool, cron job, config schema, or package manifest — even if the user does not say the word "migrate". 适用于旧 Zhin 插件向约定式目录与快照运行时的破坏性迁移。
正在显示 SKILL.md
| name | zhin-plugin-standard-development |
| description | Implement Zhin.js plugins with Plugin Runtime. Use when asked to create a plugin, add commands, middleware, components, cron, AI tools/skills/agents, config, database, router, or console pages. 适用于 definePlugin / 约定目录能力落地。 |
| argument-hint | Describe the plugin goal, target package, and required capabilities (commands, middleware, events, components, cron, AI tools, config, database, router, console). |
| user-invocable | true |
把需求落成符合仓库约定的可运行插件。唯一创作面是 Plugin Runtime。
zhin runtime start 是唯一启动路径。插件即 package：package.json#zhin 声明 manifest，
plugin.ts 必须 default-export definePlugin()，否则装配抛
does not default-export a Plugin definition。
能力按目录发现（一个文件一个能力，default export），不要命令式注册：
| 目录 | API |
|---|---|
commands/**/*.ts | defineCommand()（路径即路由；Next.js 风格 [name].ts / [[name]].ts / [...name].ts 传参，类型与默认值在 params 中声明） |
middlewares/*.ts | defineMiddleware() |
components/*.tsx | defineComponent() |
tools/*.ts | defineAgentTool() |
pages/*.tsx | definePage()（$nav.tsx / $footer.tsx 布局） |
skills/<name>/SKILL.md | Markdown Skill |
agents/<name>.agent.md | Markdown Agent |
DI：context.resources（Scope + Token）。清理：context.lifecycle。
禁止新代码使用 usePlugin() / getPlugin() / MessageCommand / addCron(new Cron) /
declareConfig 经典路径——它们只在已弃用的 zhin.js/node（bootstrapNode）下有效，未接 CLI。
迁移旧代码用 migrate-zhin-plugin-runtime。
配套资产：
官方指令摘要：.github/instructions/zhin-plugin.instructions.md。
plugin.ts default-export definePlugin；package.json#zhin 正确define* APIusePlugin / MessageCommand / 经典 Plugin 生命周期.js；Host token 先 has 再 usecontext.lifecycle（或 setup 返回 disposer）| 类型 | 重点 | 位置 |
|---|---|---|
| 命令 | defineCommand，路径即路由 | commands/**/*.ts |
| 中间件 / 入站过滤 | defineMiddleware，target: 'inbound' | middlewares/*.ts |
| 出站改写 | target: 'outbound' | middlewares/*.ts |
| 定时 | scheduleHostToken.register + lifecycle | plugin.ts 或 agent/schedules/*.ts |
| 组件 | defineComponent | components/*.tsx |
| AI 工具 | defineAgentTool | tools/*.ts |
| 服务 / DI | resources.provide | plugin.ts setup |
| 数据库 | databaseHostToken，start 前 define 表 | plugin.ts setup |
| Web | definePage | pages/*.tsx |
多类型并存时先定主职责，再考虑拆分子包。
packages/host/；可选服务：plugins/services/ / plugins/utils/plugins/ 对应分类examples/minimal-bot / examples/single-file-botHost（database / schedule / outbound / agentTools）一律可选：has(token) 再 use(token)。
schema.json + context.config.get()outboundHostToken（不旁路发送链）definePlugin({ requires: [...] })明确职责、用户入口（命令 / 中间件 / 页）、是否持久化。无复杂度时保持最小结构（可先单文件 addCommand，再拆 commands/）。
plugin.ts 只装配与生命周期，业务在约定目录。
execute 读 params / args / input（含 session 字段若需要）remind.add），动态参数只能是路径最后一段且至多一个。commands/[note].ts 在 root 可用、在子插件启动期抛 Invalid Command path；子插件一律写 commands/add/[note].tsawait next()inputSchema 与 execute 入参一致；副作用边界清晰definePage + 客户端与 Node 分离结构在「单文件 vs 拆模块」间犹豫时看 实现分支参考。 已混乱的旧插件改用 refactoring / migrate skill，不要硬扩。
package.json#zhin + default export.jsusePlugin / MessageCommand 新增pnpm --filter <pkg> test 或 Sandbox 手测命令原文pages/| 触发 | 一线 | 仍失败 |
|---|---|---|
| 命令无响应 | 查路径路由、zhin.features 是否含 @zhin.js/command、前缀配置 | 对照 minimal-bot / first-plugin 文档 |
does not default-export a Plugin definition | 改成 export default definePlugin(...) | 查 entry 路径 |
| Host use 炸 | 先 has(token)；确认 Host 插件已装 | 查精简安装分档 |
tsc 导入错 | 加 .js；查 exports | 对照官方插件 package.json |
| 控制台页 404 | 查 definePage / catalog 注册 | 查 Host entries API |
usePlugin / MessageCommand / bootstrapNodeMessage.$reply / Adapter.sendMessage 发送链createGenerationStore