把技能和子代理打包成一个 Claude Code 插件:最小只要一个清单文件,不用上架就能在本地试

写了几个 Claude Code 技能或子代理、想分给同事或在多个项目里复用时,下一步就是把它们打成一个插件:本质上只是一个文件夹加一份小清单,Claude Code 会把它当成一个整体加载。10 月 25 日的这篇实测教程用一个真实小插件 standup-helper 从空文件夹一路做到能跑:一个技能把 notes.md 变成三行晨会纪要(昨天/今天/阻塞),一个子代理检查笔记里缺日期的行。

做法分七步:先建插件根目录与 .claude-plugin、skills、agents 文件夹;再写 plugin.json 清单,唯一必填字段是不能带空格的 name,它会成为所有技能和子代理的前缀;接着在 skills/ 下每个技能一个 SKILL.md、在 agents/ 下每个子代理一个 Markdown 文件;然后跑 claude plugin validate ./standup-helper 校验——名字带空格的插件会直接被拦下;再用 claude –plugin-dir ./standup-helper 只为当前会话加载,技能以 /standup-helper:standup 的形式出现在斜杠菜单里;改文件后不用重启,跑 /reload-plugins 即可;最后在 /plugin 面板确认它显示为 inline,并看 Errors 标签排查加载失败。

几个坑要先记住:.claude-plugin/ 里只能放 plugin.json,技能文件夹误放进去不会加载;插件根目录的 CLAUDE.md 不会生效,指令要写成技能;两个地方各放一份 hook 会跑两遍;–plugin-dir 只影响本次会话,想每次都加载要走个人插件目录。分享时可以直接发文件夹或 .zip、也可以自建 marketplace 或提交官方目录。适合已经写过技能、想把一套固定工作法沉淀成可复用包的开发者和团队。

相关阅读:tstack:9 个 Agent 技能打包开源、Superpowers:30 万星的编码智能体方法论。原文教程:Create a Claude Code Plugin Step by Step(AI Parabellum)

来源:AI Parabellum,原文:https://aiparabellum.com/create-claude-code-plugin/

请登录后发表评论

    没有回复内容