forked from arechen/EapilSkillMarket
99 lines
8.0 KiB
Markdown
99 lines
8.0 KiB
Markdown
# EAPIL Codex 插件市场
|
||
|
||
这是 EAPIL Codex 插件市场。首要用途是让 AI agent 能稳定安装公共 skills、MCP 插件和第三方 Codex plugin。
|
||
|
||
## 给 AI 的安装流程
|
||
|
||
当用户要求安装或使用 EAPIL 插件时，优先执行：
|
||
|
||
```bash
|
||
codex plugin marketplace add https://git.playones.com/arechen/EapilSkillMarket.git --ref main
|
||
codex plugin marketplace upgrade eapil-skill-market
|
||
codex plugin list --marketplace eapil-skill-market
|
||
codex plugin add <plugin-id>@eapil-skill-market
|
||
```
|
||
|
||
使用 `codex plugin list --marketplace eapil-skill-market` 输出里的精确 `plugin-id`。不要猜测中文名、翻译名或 display name。
|
||
|
||
同一插件的原版与本地化版本可能同时存在。它们的展示名可以相近，但 `plugin-id` 必须不同；安装前应通过列表确认语言版本和精确 ID。
|
||
|
||
Codex 插件页的大标题按 marketplace 来源分组，不是按插件 `category` 分组。本市场统一使用 Codex 官方分类值；本地化版本与原版放在同一功能分类，并通过 `-zh` 等 ID 后缀和说明文字区分。
|
||
|
||
安装公共 skill 或第三方 Codex plugin 时也使用同一套命令；具体可安装项以 `codex plugin list --marketplace eapil-skill-market` 的实时输出为准。
|
||
|
||
有些插件是 skill 集合，安装一个 `plugin-id` 后会同时提供多个 `$skill-name`。可安装项和安装后可用的 skills 均以 Codex 的实际输出为准。
|
||
|
||
`superpowers-zh` 是 Superpowers 的简体中文版本，提供规划、测试驱动开发、调试和代码审查等工作流。请使用上述插件 ID 安装；其内容跟随中文版正式发版，Codex 组件保持上游声明。
|
||
|
||
`docx`、`pdf`、`pptx` 和 `xlsx` 提供简体中文入口与 Windows PowerShell 指引。首次使用先检查 Python、Node、中文字体和实际需要的依赖；Office 转换需要 LibreOffice，PDF 逐页预览使用 PyMuPDF，无需 Poppler。中文文件路径必须加引号，交付前检查缺字、版式与公式结果。
|
||
|
||
`find-skills` 使用 Vercel Skills CLI 搜索技能，需要 Node.js 与 `npx`。搜索结果里的安装命令适用于其上游生态；安装本市场插件仍使用上述 Codex 命令。
|
||
|
||
`taste-skill` 用于网站与工作界面的设计和真实浏览器检查。运行其脚本需要 Node.js 22+ 和已安装的 Chrome、Edge 或 Chromium；素材搜索需要网络访问。
|
||
|
||
`hallmark` 用于设计新网站和页面，提供视觉主题与浏览器检查；只有明确指定 Hallmark 时才重设计或审阅现有页面。主题和检查脚本需要 Node.js，浏览器检查需要可用浏览器；可选图像生成需要 Together AI 凭据与网络。
|
||
|
||
`generate-agents-md`、`design-md`、`eapil-llmapi-structured`、`eapil-gpt2-image` 和 `eapil-voice` 的内容与版本跟随 [ManySkills 正式发版](https://git.playones.com/chenmingxuan/ManySkills/releases)，安装 ID 保持不变。图像、LLM 和音频服务需要用户自行配置相应凭据。
|
||
|
||
`dingtalk-workspace` 提供钉钉官方办公协作 Skills。使用前请单独安装与插件版本匹配的 [dws CLI](https://github.com/DingTalk-Real-AI/dingtalk-workspace-cli/releases)，执行 `dws auth login` 并取得企业授权；辅助脚本需要 Python 3。建议使用官方预编译二进制，避免安装器额外安装重复 Skills；升级 CLI 时可使用 `dws upgrade --skip-skills`，Skills 由本市场更新。插件不会附带账号凭据，消息发送、文档修改和审批等操作需要明确的用户指令。
|
||
|
||
例如 `grill-me` 插件会同时安装用户入口 `$grill-me` 和必需的基础能力 `$grilling`；请安装插件整体，不要只复制其中一个 skill 目录。
|
||
|
||
安装 `shuorenhua` 后，可显式调用 `$shuorenhua` 清理中文文本中的模板套话和生硬表达；需要只审阅不改写时，在指令中指定 `annotation mode`。
|
||
|
||
安装 `hardware-development` 后，可显式调用 `$hardware-development` 处理以 KiCad 为主的电路实施、PCB 布局布线、DRC 和制造交付；执行前应确认本机可用的 EDA 工具、有效工程版本和项目约束。
|
||
|
||
`embedded-app-pc-debug`、`firmware-app-development` 和 `firmware-lowlevel-development` 分别覆盖 Windows 电脑端设备调试、固件应用层开发及 BSP/PSP 等底层开发流程。使用前应确认项目工具链、目标设备和访问权限；构建、设备写入、刷机、升级、上传和发布等操作必须按插件门禁取得明确确认。
|
||
|
||
`artemis-case-prep` 根据原始 Android 测试工作簿筛选可自动化用例，保留原表副本并生成七列 ARTEMIS 任务表；它只准备文档，不启动测试。导入前请检查表头与当前 ARTEMIS 版本是否匹配。
|
||
|
||
`mobile-aijia-daily-screenshots` 和 `unicom-zhijia-daily-screenshots` 使用 ARTEMIS Flash 分别采集移动爱家和联通智家设备截图并整理结果，需要 ARTEMIS、`artemis-use`、Android 模拟器及相应 App；钉钉通知需要 DWS 与对应 Skills。创建计划时须确认完整配置和通知授权，执行时核实设备与授权范围。
|
||
|
||
部分插件依赖特定运行环境。`$updating-gitea-repositories` 面向 Gitea HTTPS、GCM 和 PAT 工作流；安装前应查看插件详情并确认运行前置条件。
|
||
|
||
`etunel-role-collaboration` 保留原安装 ID，v2.0.0 起提供 `$ep-hub` 项目中心，展示名为 `ep-hub`，按八阶段管理交付、真人确认、进度、交接和成果留档，不再提供旧的全角色流程入口。Etunel 配置与通信需目标环境已安装 `etunel-use`；缺少时仍可整理记录与待决定事项，不得声称配置或通信已完成。
|
||
|
||
该插件跟随 [EP-Hub-Skill 正式发版](https://git.playones.com/chenmingxuan/EP-Hub-Skill/releases)。升级后开始新会话并调用 `$ep-hub`；更新不会自动修改 Hook、职责契约或迁移在途项目。迁移须明确确认范围，保留既有任务、时间、成果和确认历史。可选钉钉通知脚本需从同版仓库另行部署，依赖 Python 3.9+ 和已登录的原生 DWS；旧 `progress` 调用必须补 `--stage`，`--dry-run` 仅离线预览，不代表通知已发送。
|
||
|
||
`caveman` 插件中的大多数工作流可直接使用。可选的 `$caveman-compress` 需要 Python 3.10，以及 `ANTHROPIC_API_KEY` 或已登录的 Claude CLI；仅在用户明确指定文件后执行，并会把该文件内容发送给 Anthropic。该插件不包含 Claude Code 专用统计 hooks、statusline、Caveman CLI、代理或 MCP shrink。
|
||
|
||
如果插件刚安装到当前 Codex 会话中，启动新的 Codex thread 或新的 Codex 调用后再依赖新增 skills/hooks/MCP/app 配置。
|
||
|
||
`caveman` 包含 Codex `SessionStart` hook，需要 Node.js。信任并启用后，启动或恢复会话时会根据配置注入默认模式，未配置时默认为 Caveman。可要求 `normal mode` 停用当前模式；需要持续关闭时，可设置 `CAVEMAN_DEFAULT_MODE=off` 或在 Codex 中禁用该 hook 或插件。
|
||
|
||
卸载插件：
|
||
|
||
```bash
|
||
codex plugin remove <plugin-id>@eapil-skill-market
|
||
```
|
||
|
||
## MCP 插件
|
||
|
||
当前公开 MCP 插件是 `mcp-playwright`。
|
||
|
||
`mcp-playwright` 是本地 MCP 插件：
|
||
|
||
- 插件 ID：`mcp-playwright`
|
||
- MCP server id：`playwright`
|
||
- 本地命令：`bunx @playwright/mcp@latest`
|
||
- 鉴权：无
|
||
|
||
安装后如需覆盖启用状态或审批策略，可在用户 Codex 配置里追加：
|
||
|
||
```toml
|
||
[plugins."mcp-playwright@eapil-skill-market".mcp_servers.playwright]
|
||
enabled = true
|
||
```
|
||
|
||
## 官方插件能力
|
||
|
||
本市场中的插件可以包含 Codex 官方支持的这些能力：
|
||
|
||
- `skills`：`./skills/` 下的一个或多个 `SKILL.md`。
|
||
- `mcpServers`：通常是 `./.mcp.json`，允许 MCP-only 插件。
|
||
- `apps`：通常是 `./.app.json`，用于 app connector metadata。
|
||
- `hooks`：插件作用域 Codex hooks，可为路径、路径数组、inline object 或 object 数组。
|
||
- `interface` / `assets`：`interface.logo`、`interface.composerIcon`、`interface.screenshots` 可引用插件内 `assets/` 文件或公开 URL。
|
||
|
||
安装时请使用 `codex plugin list --marketplace eapil-skill-market` 显示的 `plugin-id`；中文展示名不是安装 ID。
|