Agent Skills
› fanfan-de/anybox
› anybox-plugin
anybox-plugin
GitHub指导构建、评审及迁移 Anybox 插件，规范清单结构与依赖声明。确保遵循最新运行时格式，验证安全性与兼容性，处理分发安装问题，并严格区分事实来源与参考文档。
Trigger Scenarios
创建或更新 Anybox 插件包结构
编写或校验 plugin.json 清单
诊断插件安装或解析错误
迁移旧版 Fanfande 插件至新格式
Install
npx skills add fanfan-de/anybox --skill anybox-plugin -g -y
SKILL.md
Frontmatter
{
"name": "anybox-plugin",
"description": "构建、说明、迁移、评审或验证 Anybox 插件包及其 .anybox-plugin\/plugin.json 清单。适用于 Codex 需要创建或更新插件目录、MCP Server、内置 Skill、插件自有 API Key 或 OAuth Connector、平台 Connector 依赖、外部组件 JSON、Registry 条目、ZIP 或 GitHub Tree 分发、生成 ID，或诊断 Anybox 插件目录与安装问题。"
}
Anybox 插件规范
使用当前 Anybox 运行时格式。不要把历史 Fanfande 格式或旧的 fanfande-plugin-structure Skill 当作权威规范。
确定事实来源
做出重要的插件格式判断前，按以下顺序检查目标仓库中的实时内容：
packages/anyboxagent/src/plugin/plugin.tspackages/anyboxagent/Test/plugin.test.tspackages/anyboxagent/src/connector/connector.tsplugins/Anybox-Plugins/index.json- 当前内置插件的
.anybox-plugin/plugin.json示例 plugins/Anybox-Plugins/anybox-plugin-development/docs/anybox-third-party-plugin-development.md- 本 Skill 的参考文档
运行代码优先于测试，测试优先于说明文档，目标仓库优先于既有假设。如果实时解析器与本 Skill 不一致，遵循解析器并报告规范漂移。除非用户明确要求修改插件格式本身，否则不要为了让某个插件通过而修改解析器。
按需读取参考文档
- 创建、迁移或完整评审插件时，读取 manifest-format.md。
- 插件声明 MCP Server、自有 Connector、OAuth、API Key 或平台 Connector 依赖时，读取 connectors-and-mcp.md。
- 处理本地来源、安装、Registry 条目、ZIP、GitHub URL、发布或验证时，读取 distribution-and-validation.md。
面对范围很窄的问题时，不要加载无关参考文档。
执行流程
- 判断任务属于包结构、清单编写、运行时接入、分发、迁移还是诊断。
- 找到插件包根目录。把
.anybox-plugin视为元数据目录，而不是包根目录。 - 对每项高级能力检查实时 schema，并至少查看一个当前内置插件示例。
- 在
<plugin-root>/.anybox-plugin/plugin.json创建或更新规范清单。 - 把
scripts、skills、connectors、docs和assets放在.anybox-plugin同级。 - 使用严格 JSON。遇到不支持的顶层字段时应报错，不要假设解析器会忽略。
- 保证所有包内相对路径都留在插件包中。拒绝路径穿越、应使用相对路径处的绝对路径，以及分发包中的符号链接。
- 不要把密钥写入源码。声明 placeholder 和 credential 元数据，由 Anybox 保存并注入真实密钥。
- 按变更风险验证目录加载和安装行为。
- 修改插件系统代码时，在同一项变更中同步更新测试、开发文档和本 Skill。
强制规则
- 为新 Anybox 插件生成
.anybox-plugin/plugin.json。 - 仅把根目录
plugin.json和.codex-plugin/plugin.json当作兼容输入。 - 不要生成
.fanfande-plugin/plugin.json或plugin.meta.json。 - 根据规范化后的 manifest
name生成插件 ID，并让文件夹、manifest 名称和 Registry 路径保持一致。 - 新插件自有 Connector 使用
connectors[].id；把connectorID和appID视为兼容别名。 - 规范 Connector 条目必须同时包含
credential和runtime；configFields只能作为额外配置。 - 优先使用
connectors，不要为新插件使用旧的apps字段。 - 把
commands和agents视为保留兼容字段，不要声称当前运行时会执行它们。 - 内置 Registry 使用精确的 manifest URL，即使运行时能够规范化受支持的 GitHub 目录 URL。
- 除非确实希望阻止安装，否则不要把风险标记为
critical。 - 迁移或验证期间保留用户文件和工作区中的无关改动。
输出评审结果
评审时把发现分为：
- 阻止解析或安装的 schema 错误；
- 导致执行失败的 runtime 或 credential 错误；
- 安全与打包风险；
- 应现代化的兼容结构；
- 可选的 Marketplace 元数据改进。
为重要结论指出对应的实时来源。如果没有运行验证，必须明确说明。
Version History
- 374d7ca Current 2026-07-19 23:18
