Plugin Creator

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）

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

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

第三步：填充/更新内容

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

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

第四步：校验

create 与 update 均必须执行：

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 分派：

# 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：若原本已启用，建议重开对话或切换装备以加载新版本；若未安装，同 create 先安装并启用

四、关键规则

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 代码质量