用 Claude Code 搞构建
创建插件
把子代理、技能、配置打包成插件，分享给别人或跨项目用。
页面信息
这页不是官方原文，而是顺着官方文档结构做的中文解释版。命令、参数、配置名这些硬东西尽量保留，解释部分则尽量讲成人能照着做的话。
如果你碰到特别敏感的配置、权限或企业环境差异，最好顺手点上面的“查看原始文档”再核一遍。
这一页先讲明白
插件就是把常用本事打包好，别的项目一装就能用。
它可以带上子代理、技能、MCP 配置这些“成套工具”。
像把常用农具装成一套工具箱。下次去另一块地，不用再一把锄头一把铲子重新找。
如果你们团队有固定工作流，插件最适合拿来做复用。
先想清楚这个插件解决的是哪类重复问题，再决定里面放技能、子代理还是外部连接。
插件不要贪多。一个插件最好解决一类明确场景，而不是把所有东西都塞进去。
打包前先问三句
想明白这三句，插件就不容易做成一坨。
1. 这个插件帮谁省时间？
2. 安装后最常用的动作是什么？
3. 团队里哪些项目都能复用？照着做一遍
第一次做插件，先别想着一口气把 skills、hooks、MCP 全塞进去。
先做一个最小能装、能跑、能试的插件，跑通以后再加复杂能力。
终端里敲
第 1 步：先建插件目录
先把插件的壳子搭起来，这一步就是把地圈出来。
mkdir my-first-plugin
mkdir my-first-plugin/.claude-plugin 改配置
第 2 步：写 plugin.json
这个文件像工具箱封面，告诉 Claude 这套插件叫什么、干什么。
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
} 改配置
第 3 步：先加一个最小 skill
不要先上复杂代理，先放一个最简单的 skill，能呼出来就算跑通。
mkdir -p my-first-plugin/skills/hello
---
description: Greet the user with a friendly message
disable-model-invocation: true
---
Greet the user warmly and ask how you can help them today. 终端里敲
第 4 步：本地试装
先别发给别人，先在自己机器上临时加载，确认能用。
claude --plugin-dir ./my-first-plugin
/my-first-plugin:hello一眼看懂这一页
这页的作用，就是把原本偏专业的话题，拆成能直接照着走的明白话。
创建插件
|
v
把子代理、技能、配置打包成插件，分享给别人或跨项目用。
|
v
照着步骤去做文末提醒
这站会按官方 docs 的导航和内容变化继续重生成，原站加页、删页、改页时，这里会跟着更新。
人话解释会尽量顺着原页往下讲，但命令、参数名、配置名这些硬东西还是保留原样，免得你抄过去跑不起来。
顺手再看
Sub-agents、Plugins、MCP 怎么选
先分清插件到底值不值得上。
常见报错排查清单
插件一装就出事时，先别乱拆环境。