# 开发第一个插件

适用 Marketplace 1.0.0-alpha.1 的多类型制品与 S3 revision 分发合同。请先取得
[CLI](../users/index.md)。

## 创建目录

```text
my-plugin/
  plugin.json
  README.md
  skills/
    my-skill/
      SKILL.md
  bin/
    tool
```

```json
{
  "$schema": "urn:marketplace:plugin-manifest:v1",
  "name": "my-plugin",
  "version": "1.0.0",
  "description": "我的第一个智能体插件"
}
```

此为本市场的独立 manifest 规范，名称规则不同于上游 Agent Plugins 1.0.0。
若包含 skill，frontmatter 的名称必须与 skill 目录相同；skill 自身规则仍只接受短横线分词。

## 校验与打包

```sh
pluginctl check --root ./my-plugin --json
pluginctl pack --root ./my-plugin --platform linux-arm64 --out ./artifacts --json
pluginctl verify --out ./artifacts/my-plugin-1.0.0-linux-arm64.tar.gz --version 1.0.0 --json
```

输出目录放在插件源目录外。pack 同时产生 `.pack.json`，publish 会核对 receipt 与归档原字节。

## 继续发布

先申请 namespace 并取得管理员批准，例如在 `my-team` 下发布 `my-team/my-plugin`。

阅读 [包格式](./package.md)，准备平台集合和市场介绍，然后按 [发布与审核](./publish.md) 提交。