Skip to content
Skills Library
AI & agents · Building & coding

plugin-creator

/plugin-creator

Plugin 插件包的创建与更新器:从自然语言创建可被 JiuwenSwarm 加载的 plugin 插件包,或在同一流程的 update mode 下修改已有自定义插件。 触发词:创建插件、创建 plugin、做一个插件、plugin 脚手架、修改插件、编辑插件、更新插件、调整插件、create plugin package、插件包、帮我做一个 XX 插件、给 agent 加 XX 能力包。当用户说「帮我做一个 XX 插件」「创建一个能力扩展包」「改一下 XX 插件」时,务必使用本 skill。

Repository
jiuwenswarm ↗
Licence
Apache-2.0
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
11
Scripts
4
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What to check before installing
  • 4 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: scripts/init_plugin.py, scripts/register_plugin.py, scripts/validate_plugin.py, scripts/validate_plugin_hot_load_worker.py

What it does and when to use it

Plugin 插件包的创建与更新器:从自然语言创建可被 JiuwenSwarm 加载的 plugin 插件包,或在同一流程的 update mode 下修改已有自定义插件。 触发词:创建插件、创建 plugin、做一个插件、plugin 脚手架、修改插件、编辑插件、更新插件、调整插件、create plugin package、插件包、帮我做一个 XX 插件、给 agent 加 XX 能力包。当用户说「帮我做一个 XX 插件」「创建一个能力扩展包」「改一下 XX 插件」时,务必使用本 skill。

Original author description

Plugin 插件包的创建与更新器:从自然语言创建可被 JiuwenSwarm 加载的 plugin 插件包,或在同一流程的 update mode 下修改已有自定义插件。 触发词:创建插件、创建 plugin、做一个插件、plugin 脚手架、修改插件、编辑插件、更新插件、调整插件、create plugin package、插件包、帮我做一个 XX 插件、给 agent 加 XX 能力包。当用户说「帮我做一个 XX 插件」「创建一个能力扩展包」「改一下 XX 插件」时,务必使用本 skill。

How it works

  1. 一、产物总览
  2. 二、工作流程
  3. 三、输出规范
  4. 四、关键规则
  5. References
Original SKILL.md headings · 161 lines, 353 words
SKILL.md preview
---

name: plugin-creator
description: |
  Plugin 插件包的创建与更新器:从自然语言创建可被 JiuwenSwarm 加载的 plugin 插件包,或在同一流程的 update mode 下修改已有自定义插件。
  触发词:创建插件、创建 plugin、做一个插件、plugin 脚手架、修改插件、编辑插件、更新插件、调整插件、create plugin package、插件包、帮我做一个 XX 插件、给 agent 加 XX 能力包。当用户说「帮我做一个 XX 插件」「创建一个能力扩展包」「改一下 XX 插件」时,务必使用本 skill。
---

# Plugin 插件包创建器

> **执行前必读**:在启用本 Skill 开展任务前,务必完整阅读 SKILL.md 全文,严格遵守所有约束规则、执行步骤及参考条目。严禁跳读文档、只截取部分内容就执行操作。

你是 JiuwenSwarm Plugin 插件包创建器,把自然语言需求转化成可被装备系统扫描加载的 plugin 能力扩展包。

## 一、产物总览

```
<plugin-name>/
├── manifest.json          # 必须
├── README.md              # 必须
├── skills/<name>/SKILL.md # 可选
├── tools/<name>_tool.py        # 可选
├── rails/<name>_rail.py        # 可选
```

包落盘目录(由 `JIUWENSWARM_DATA_DIR` 决定,未设置时默认 `~/.jiuwenswarm`):

- **local(可写,自定义插件)**:`<data-dir>/agent/workspace/plugins/plugin_packages/local/<plugin-name>/`
- **built_in(只读内置)**:`<data-dir>/agent/workspace/plugins/plugin_packages/built_in/<plugin-name>/`

本 skill 只在 `local/` 下创建或修改包;**禁止**改写 `built_in/`。

---



## 二、工作流程

```
1. 明确意图与信息
2. 初始化包目录 → scripts/init_plugin.py <plugin-name>   [create only]
3. 填充/更新内容 → references/fill-package.md
4. 校验 → scripts/validate_plugin.py <plugin-name>
5. 注册 → scripts/register_plugin.py <plugin-name>
```



### 第一步:明确意图与信息



#### 1.1 判定 mode

在提问或动手前,先根据用户意图判定 `mode`:

- 用户明确「修改 / 编辑 / 更新 / 调整已有插件」→ `update`
- 其他创建类需求 → `create`

保护规则:

- `create` 前若 `local/<plugin-name>` 已存在,停下确认:修改现有插件,还是换新名字创建。
- `update` 只允许修改 `local/<plugin-name>`;找不到则提示用户确认插件名,或改走 `create`。
- `built_in` 永远只读;如需基于内置插件修改,只能创建 local 派生包。

措辞含糊且无法从上下文判断时,先问:新建还是改已有的?确认前不要进入第二步。

#### 1.2 create — 收集创建信息

**必须明确:**

1. **名字**:插件 id / 展示名(中英文)
2. **能力领域**:这个插件扩展什么场景(中英文)
3. **核心能力**:详细的能力描述(中英文,3–5 条)

若任一项无法从用户描述直接确定,先提问并停等确认。

#### 1.3 update — 定位与确认范围

1. 确定 `<plugin-name>`(kebab-case)
2. 读取 `local/<plugin-name>/` 下现有 `manifest.json`、已有 `skills/` / `tools/` / `rails/`
3. 向用户确认要改什么(展示字段、quick_inputs、增删 skill/tool/rail 等)
4. 包不存在 → 提示在插件中心确认「我的插件」,或改走 `create`

唯一标识、展示字段和 manifest 细则见「关键规则」与 `references/manifest-spec.md`。用户要求改名 → 告知需换新名字走 `create`,不支持原地改名。

### 第二步:初始化包目录

**仅** `mode=create` **执行。**`mode=update` **跳过本步**,直接进入第三步。

- `<plugin-name>`: kebab-case 包 id(等于目录名、manifest `id`)

```bash
python3 <skill_dir>/scripts/init_plugin.py <plugin-name>
```

脚本自行解析落盘路径并在 stdout 输出;生成的模板文件带 `[TODO]` 占位符,实际内容后续填充。勿手建目录或改落盘路径。

### 第三步:填充/更新内容

读取并遵守 `@references/fill-package.md`。

`create` 完整填充;`update` 只做用户确认范围内的局部修改。涉及 skill/tool/rail 增删时,必须同步回写 `manifest.json`。

### 第四步:校验

`create` 与 `update` 均必须执行:

```bash
python3 <skill_dir>/scripts/validate_plugin.py <plugin-name>
```

脚本依次跑 L0 规范质量、L1 静态结构、L2 真实热加载。必须用 JiuwenSwarm 运行环境的 python 执行,跑到 `RESULT: PASS` 才算通过;L2 失败或未执行均不能 register。

### 第五步:注册

`create` 与 `update` 均必须执行(register 对 marketplace 做 upsert,登记为已安装;已安装插件会保留 `installed=true`)。命令按 mode 分派:

```bash
# create
python3 <skill_dir>/scripts/register_plugin.py <plugin-name>

# update
python3 <skill_dir>/scripts/register_plugin.py <plugin-name> --bump
```

注册成功后才算全流程完成。告知用户:参考「三、输出规范」。

---



## 三、输出规范

注册成功后,用下面结构告知用户:

1. **插件概览**:插件包名、分类、核心能力(或本次变更摘要)、标签
2. **产物位置**:包路径(`create` 用 init 脚本输出;`update` 用已定位的 `local/<plugin-name>/`)
3. **推荐提问**:直接引用 manifest 的 `quick_inputs`(3 条),强调是**能力触发语**而非人设介绍
4. **如何启用**:
  - `create`:打开扩展能看到该插件已安装;新对话输入区勾选插件 chip
  - `update`:建议重开对话或切换装备以加载新版本

---



## 四、关键规则

1. **update 只做局部修改**:禁止 init、禁止重写整包;只修改 `local/`,`built_in/` 只读。
2. **不改唯一标识**:包目录名、manifest `id`、`source`。
3. **至少一种能力组件**:`skills` / `tools` / `rails` 至少声明一类且路径真实存在。
4. **manifest 以 spec 为准**:组件声明、禁用字段、展示字段规则见 `references/manifest-spec.md`;不要复制本 skill 的 `references/` 进用户包。
5. **顺序不可跳**:必须 `validate_plugin.py` 跑到 `RESULT: PASS` 后再 `register_plugin.py`;`create/update` 都一样。

---



## References

- `references/fill-package.md` — 填充/更新包内容规范
- `references/manifest-spec.md` — manifest 文件结构模板
- `references/skill-spec.md` — 创建 skill 模板
- `references/tool-spec.md` — Tool 结构模板
- `references/rail-spec.md` — Rail 结构模板
- `references/code-quality.md` — tool/rail/scripts Python 代码质量
Files in this package (11)
  • SKILL.md 7 KB
  • references/code-quality.md 1 KB
  • references/fill-package.md 5 KB
  • references/manifest-spec.md 6 KB
  • references/rail-spec.md 5 KB
  • references/skill-spec.md 2 KB
  • references/tool-spec.md 4 KB
  • scripts/init_plugin.py 6 KB
  • scripts/register_plugin.py 8 KB
  • scripts/validate_plugin.py 35 KB
  • scripts/validate_plugin_hot_load_worker.py 13 KB

Versions

RepositoryScoreLicence
This page · openjiuwen-ai/jiuwenswarm100Apache-2.0
jeremylongshore/tons-of-skills-marketplace100MIT
fengchen122123-sudo/xingyao-y-code100MIT
krzysztofsurdy/code-virtuoso100MIT
HaizhuAI/Zkali100Apache-2.0
lttr/claude-marketplace100MIT
liyunxuanyu/dsh-zcode-port100MIT
jscraik/Agent-Skills100Apache-2.0
fx/cc100MIT

Database snapshot: 13.11.2026 · package version 53fc22bcd963 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100agent-creator
    Agent 模板包的创建与更新器:从自然语言创建可被 JiuwenSwarm 加载的 agent 模板包,或在同一流程的 update mode 下修改已有自定义专家。 触发词:创建 agent模板包、创建模板包、生成 agent 模板、新建 agent、做一个 agent、create agent template、建一个专家、做一个专家、agent 脚手架、scaffold agent、修改专家、编辑专家、更新专家、调整专家、modify expert、update expert。当用户说「帮我做一个能 XX 的 agent」「创建一个 XX…
  • 95agent-group-creator
    从自然语言创建可被 JiuwenSwarm 加载和安装的专家团(agent_group)包,包含 Leader、专家成员、协作指令及可选共享技能。用户提出“创建专家团”“组建专家团队”“做一个多专家协作团队”时使用;创建单个专家使用 agent-creator,执行已有专家团的业务任务不使用本技能。
  • 100create-plugin
    Use this skill when the user asks to "create a plugin", "add a plugin", "make a new plugin", "build a plugin", or wants to package skills into an installable plugin for this marketplace. Guides creating a properly structured plugin under plugins/.
  • 100optimize-plugin
    This skill should be used when the user asks to "validate a plugin", "optimize plugin", "check plugin quality", "review plugin structure", or "run plugin optimizer".
  • 100skill-to-plugin
    Generates a harness plugin from a skill using the local templates in this repo. Use when the user names /skill-to-plugin or asks to package a skill as a plugin for a coding-agent harness.
  • 90create-plugin
    Scaffold a new AI agent plugin directory with valid manifest, component directories, and marketplace wiring. Use when starting a new plugin, adding a plugin to a multi-plugin repository, or reviewing a plugin before submission.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.