S Plugins

面向 Agents 的插件集合。

安装与使用

Codex 桌面端

以下为 Codex 桌面端真实截图，界面可能随版本变化。

打开插件，点击右上角添加，选择 添加插件市场。
在来源中填写 https://github.com/tadazly/s-plugins.git，Git 引用填写 main，稀疏路径留空，然后点击 添加市场。
返回插件页，点击个人，从 S Plugins 中选择要安装的插件。
新建 Codex 任务后直接描述需求；需要明确指定时，可输入 @ 选择插件或 Skill。

Codex CLI

codex plugin marketplace add tadazly/s-plugins
codex plugin marketplace list

运行 /plugins 浏览并安装插件；安装完成后新建 CLI 会话。

更新已安装插件（桌面端与 CLI 共用同一份 Codex 配置，同样适用）：

codex plugin marketplace upgrade s-plugins

该命令刷新市场快照，并把已安装插件更新到市场中的版本；之后新建任务或会话生效。

Claude Code

claude plugin marketplace add tadazly/s-plugins
claude plugin install design-rag@s-plugins

也可以在会话中运行 /plugin marketplace add tadazly/s-plugins，再到 /plugin 的 Discover 页浏览安装。安装完成后新建会话；已打开的会话可运行 /reload-plugins。

第三方市场默认不自动更新，更新已安装插件：

claude plugin marketplace update s-plugins
claude plugin update design-rag@s-plugins

也可以在 /plugin → Marketplaces 中为 s-plugins 开启自动更新。

WorkBuddy

以下为 WorkBuddy 5.6.2 真实截图，界面可能随版本变化。

切换到 技能 -> 套件 标签，点击市场列表右侧的 +。
在 市场源 中填写 tadazly/s-plugins，点击提交。
在市场列表中选择 s-plugins，点击要安装插件卡片右上角的 +。

使用 CodeBuddy Code CLI 时：

/plugin marketplace add tadazly/s-plugins
/plugin install design-rag@s-plugins

插件目录

插件	简介
DRAG 游戏策划知识库	检索本地策划案、配表和历史版本
Egret Agent Inspector	查询、操作和测试浏览器中的 Egret 游戏

发布插件

新插件建议从 plugin-template 创建。模板内置三端清单生成与校验、agent 制作与发布技能，以及发布后通知本仓库的 CI/CD；按模板说明配置 S_PLUGINS_DISPATCH_TOKEN 即可接入。

从其他仓库自动发布

插件仓库完成构建、测试、tag 和发布后，向本仓库发送 plugin-released 类型的 repository_dispatch：

上游发布成功
  → repository_dispatch
  → 更新 .agents/plugins/marketplace.json
  → 生成 Claude Code / WorkBuddy marketplace 与 README 插件目录
  → 静态校验
  → github-actions[bot] 提交 main

通知参数：

参数	首次登记	后续发布	说明
`name`	必填	必填	稳定的插件 ID，小写 kebab-case
`version`	必填	必填	插件版本，使用 SemVer，不带 `v`
`source.ref`	必填	必填	已发布的 Git tag 或 ref
`source.url`	必填	可省略	插件仓库 HTTPS URL；登记后不可由通知修改
`source.path`	必填	可省略	插件目录，以 `./` 开头；登记后不可由通知修改
`description`	必填	可选	插件包说明，Codex 与 Claude Code 共用
`interface.displayName`	必填	可选	Codex、Claude Code 与 README 中显示的名称
`interface.shortDescription`	必填	可选	Codex 与 README 中显示的简短说明
`interface.longDescription`	必填	可选	插件详情中的完整说明
`interface.developerName`	必填	可选	开发者名称，Claude Code 中为 `author.name`
`interface.websiteURL`	必填	可选	插件网站或仓库的 HTTPS URL，Claude Code 中为 `homepage`

policy.installation、policy.authentication 和 category 由本仓库管理，不接受发布通知覆盖。首次登记必须提供全部参数；后续发布至少提供 name、version 和 source.ref，其他字段仅在传入时更新。

Claude Code 与 WorkBuddy marketplace 不单独接收通知，由同一次更新从 Codex 条目生成：只保留各自 schema 支持的字段（WorkBuddy 只写 CodeBuddy 文档列出的字段），source.path 去掉 ./ 前缀，policy.installation 为 NOT_AVAILABLE 的插件不列出。

可省略参数不可变更，确需迁移来源时，应在本仓库中人工修改并审核，而不是通过普通版本发布通知变更。

首次登记示例：

{
  "event_type": "plugin-released",
  "client_payload": {
    "name": "design-rag",
    "version": "0.3.0",
    "description": "DRAG 本地游戏策划案与配置表检索、分析和索引管理工具",
    "source": {
      "url": "https://github.com/tadazly/design-rag.git",
      "path": "./plugins/design-rag",
      "ref": "v0.3.0"
    },
    "interface": {
      "displayName": "DRAG 游戏策划知识库",
      "shortDescription": "检索本地策划案、配表和历史版本",
      "longDescription": "使用本地只读索引模糊查找游戏策划案与配置表，分析玩法、流程、产出逻辑、历史改动和活动复用，并管理资料来源与增量索引。",
      "developerName": "tadazly",
      "websiteURL": "https://github.com/tadazly/design-rag"
    }
  }
}

后续版本的最小通知：

{
  "event_type": "plugin-released",
  "client_payload": {
    "name": "design-rag",
    "version": "0.3.1",
    "source": {
      "ref": "v0.3.1"
    }
  }
}

如果展示信息发生变化，在后续 payload 中附带变化的 description 或 interface 字段即可。

支持 Claude Code 与 WorkBuddy

发布通知无需额外字段。三个客户端各自读取插件清单：

Codex 读 .codex-plugin/plugin.json；
Claude Code 读 .claude-plugin/plugin.json；
WorkBuddy 按 .codebuddy-plugin → .workbuddy-plugin → .claude-plugin 的顺序，只读第一个找到的 plugin.json。

发布的 tag 需满足：

插件目录包含 .claude-plugin/plugin.json，其 name、version 与 .codex-plugin/plugin.json 一致。marketplace 条目的 version 决定 Claude Code 的缓存目录和更新判断。
建议再提供 .codebuddy-plugin/plugin.json，这是 WorkBuddy 内置插件的写法；缺少时 WorkBuddy 会退回读取 .claude-plugin/plugin.json。
MCP server 在清单中内联声明。Claude Code 与 WorkBuddy 都在用户的会话或工作区目录启动 server，不支持 cwd，也不改写相对路径。所以 command 和 args 要用 ${CLAUDE_PLUGIN_ROOT}（WorkBuddy 清单用 ${CODEBUDDY_PLUGIN_ROOT}）定位插件文件。
插件根目录不放 .mcp.json 和 mcp/*.json：
- Claude Code 与 WorkBuddy 都会自动加载它们；
- WorkBuddy 依次合并清单、.mcp.json、mcp/*.json，同名 server 以后读到的为准。Codex 写法的 .mcp.json 会覆盖清单里的配置，导致启动失败。
- Codex 配置请改名（如 .codex-mcp.json），并在 .codex-plugin/plugin.json 的 mcpServers 中引用。
MCP 启动命令不要按名字调用 python、python3、py，Claude Code 与 WorkBuddy 侧也不要依赖 node。解释型 server 要用启动器，由启动器按平台选择解释器。
审批、超时、enabled 等字段只有 Codex 读取，WorkBuddy 下发配置时会丢弃，所以危险操作不能只靠客户端审批拦截。
skills/ 三端通用。

plugin-template 已按这些规则生成各端清单，并在 CI 中用三端 CLI 校验；详细的踩坑记录见该仓库 .agents/skills/plugin-create/references/mcp.md。冒烟测试会用 scripts/plugin_compat.py，按各客户端的加载规则检查每个已发布插件的 MCP 启动配置。

发布仓库发送通知

创建仅授权 tadazly/s-plugins、具有 Contents: Read and write 权限的 fine-grained personal access token，并在插件仓库中保存为 Secret S_PLUGINS_DISPATCH_TOKEN。不要把 Token 写入 workflow、脚本或日志。

将以下步骤放在发布 job 的最后。示例直接读取插件 manifest，避免重复维护展示信息：

- name: Notify s-plugins
  env:
    GH_TOKEN: ${{ secrets.S_PLUGINS_DISPATCH_TOKEN }}
    PLUGIN_MANIFEST: plugins/design-rag/.codex-plugin/plugin.json
    PLUGIN_SOURCE_URL: https://github.com/tadazly/design-rag.git
    PLUGIN_SOURCE_PATH: ./plugins/design-rag
    PLUGIN_WEBSITE_URL: https://github.com/tadazly/design-rag
  shell: bash
  run: |
    jq -n \
      --slurpfile plugin "$PLUGIN_MANIFEST" \
      --arg ref "$GITHUB_REF_NAME" \
      --arg url "$PLUGIN_SOURCE_URL" \
      --arg path "$PLUGIN_SOURCE_PATH" \
      --arg website "$PLUGIN_WEBSITE_URL" \
      '{
        event_type: "plugin-released",
        client_payload: {
          name: $plugin[0].name,
          version: $plugin[0].version,
          description: $plugin[0].description,
          source: {url: $url, path: $path, ref: $ref},
          interface: {
            displayName: $plugin[0].interface.displayName,
            shortDescription: $plugin[0].interface.shortDescription,
            longDescription: $plugin[0].interface.longDescription,
            developerName: $plugin[0].interface.developerName,
            websiteURL: ($plugin[0].interface.websiteURL // $website)
          }
        }
      }' | gh api --method POST repos/tadazly/s-plugins/dispatches --input -

重复发送相同内容不会产生新提交。通知表示上游已经完成发布验收，本仓库不会重新构建或测试上游插件。

给发布仓库 Agent 的提示词

当前插件发布成功后，向 tadazly/s-plugins 发送 plugin-released repository_dispatch。首次登记从插件 manifest 读取 name、version、description 和 interface 展示信息，并附带 source.url、source.path、source.ref；后续至少发送 name、version、source.ref，展示信息变化时再附带相应字段。使用仓库 Secret S_PLUGINS_DISPATCH_TOKEN，只有 tag 和 release 成功后才通知，禁止输出或提交 Token。插件支持 Claude Code 与 WorkBuddy 时，按“支持 Claude Code 与 WorkBuddy”要求在 tag 中提供 .claude-plugin/plugin.json（建议再提供 .codebuddy-plugin/plugin.json），插件根目录不放 .mcp.json 与 mcp/*.json，并在发布校验中确认各清单的 version 与 Codex manifest 一致。按 https://github.com/tadazly/s-plugins/blob/main/README.md 的“从其他仓库自动发布”协议实施并验证。

在本仓库添加插件

本地插件源码放在 plugins/<plugin-name>/：

使用 Codex 内置 $plugin-creator 创建插件及 local marketplace 条目。
将 manifest 的 version、description 和 interface 展示字段同步到 marketplace 条目。
需要支持 Claude Code 与 WorkBuddy 时，按“支持 Claude Code 与 WorkBuddy”补充 .claude-plugin/plugin.json 与 .codebuddy-plugin/plugin.json；Codex 的 MCP 配置使用 .codex-mcp.json。
运行 python scripts/sync_generated.py 更新 Claude Code marketplace 与插件目录。
使用 plugin-creator validator 验证插件，再分别运行 claude plugin validate plugins/<plugin-name> 与 codebuddy plugin validate plugins/<plugin-name>，最后运行本仓库检查。

每个本地插件必须包含 .codex-plugin/plugin.json；skills/、hooks/、assets/、MCP 配置和 .app.json 均位于插件根目录，但根目录不放 .mcp.json 与 mcp/*.json。

开发与验证

python scripts/sync_generated.py
python scripts/validate_repo.py
python -m unittest discover -s tests -v
claude plugin validate .
codebuddy plugin validate .   # 装有 CodeBuddy CLI 时运行，先退出 WorkBuddy

本地调试 marketplace：

codex plugin marketplace add .
claude plugin marketplace add .

关键文件：

.agents/plugins/marketplace.json：插件来源、安装策略和展示信息的唯一数据源。
.claude-plugin/marketplace.json、.codebuddy-plugin/marketplace.json：Claude Code 与 WorkBuddy marketplace，由脚本生成，不手工编辑。
scripts/validate_repo.py：校验与生成规则；GENERATED_MARKETPLACES 登记各平台的生成函数，新增平台只需在此加一项。
scripts/update_marketplace.py：处理发布通知，更新全部 marketplace 与 README。
scripts/sync_generated.py：重建全部生成文件；--list-outputs 列出生成文件，供 workflow 提交。
.github/workflows/update-marketplace.yml：自动更新并提交。
.github/workflows/smoke.yml：用真实的 Claude Code 与 CodeBuddy Code CLI 安装全部插件，并按三端规则检查 MCP 启动配置；只报告，不阻断发布。
scripts/plugin_compat.py：按 Codex、Claude Code 与 WorkBuddy 的加载规则，检查插件目录里各 MCP server 实际生效的启动配置。

Navigation Menu

Repository files navigation

S Plugins

安装与使用

Codex 桌面端

Codex CLI

Claude Code

WorkBuddy

插件目录

发布插件

从其他仓库自动发布

支持 Claude Code 与 WorkBuddy

发布仓库发送通知

给发布仓库 Agent 的提示词

在本仓库添加插件

开发与验证

参考

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.agents/plugins		.agents/plugins
.claude-plugin		.claude-plugin
.codebuddy-plugin		.codebuddy-plugin
.github/workflows		.github/workflows
docs/assets		docs/assets
plugins		plugins
scripts		scripts
tests		tests
.gitattributes		.gitattributes
.gitignore		.gitignore
AGENTS.md		AGENTS.md
README.md		README.md

Latest commit

History

Folders and files

Repository files navigation

S Plugins

安装与使用

Codex 桌面端

Codex CLI

Claude Code

WorkBuddy

插件目录

发布插件

从其他仓库自动发布

支持 Claude Code 与 WorkBuddy

发布仓库发送通知

给发布仓库 Agent 的提示词

在本仓库添加插件

开发与验证

参考

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages