把顺手的 skills、agents、hooks、MCP 配置与兼容命令，打包成可安装、可验证、可协作维护的 Claude Code 能力
简体中文 · English · 繁體中文 · 日本語 · 한국어
这是 ZaunEkko 的 Claude Code 插件市场容器。仓库负责维护市场目录、可安装插件、使用文档、验证流程与社区协作文件；Claude Code 通过根目录的 .claude-plugin/marketplace.json 读取市场内容。
仓库按公开分发标准维护：变更先在 feature/develop 分支完成实现、安全审查、跨平台测试与文档同步，再集成到稳定的 main。
市场名称为 zaunekko，预期 GitHub 源为 ZaunEkko/claude-plugins。
仓库可以收录以下 Claude Code 插件组件：
skills/<skill-name>/SKILL.md：面向用户或模型按需加载的能力；新功能优先使用 skills。agents/*.md：可复用的专用子代理。hooks/hooks.json：Claude Code 生命周期与工具事件 hooks。.mcp.json：插件级 MCP server 配置。scripts/：由 skills、hooks 或兼容命令调用的脚本。commands/*.md：仅用于上游接口兼容；Claude Code 已将自定义 commands 统一到 skills 语义。
原创可安装插件通常采用 ekko-<specific-purpose> 命名。只有为了保留上游安装名和运行时命名空间的已授权兼容分发，才允许使用同名例外。
| 插件 | 状态 | 说明 | 文档 |
|---|---|---|---|
commit-commands |
可用 · 兼容分发 | 基于 Anthropic 官方同名插件，保留三个命令，提供当前会话模型 attribution、Bash 与已知 Playwright unsafe 提交防绕过保护、显式 detached session 绑定，以及确认式安全分支/worktree 清理。 | 使用指南 · 实现与上游说明 |
ekko-image-gen |
可用 · 原创 | 使用一个命令调用用户配置的 OpenAI-compatible Images API（localhost 或第三方 HTTPS），支持文生图、粘贴图片后的图生图、项目上下文感知落盘、受控并发叶子 worker、主代理视觉验收、绝对路径，以及可 Ctrl/Cmd+点击且不会自动弹窗的临时本地 HTTP 预览链接。 | 使用指南 · 实现说明 |
commit-commands 与官方分发暴露相同命名空间。请在同一作用域内只启用一个版本。
在当前会话中直接运行：
/plugin marketplace add ZaunEkko/claude-plugins
/plugin install commit-commands@zaunekko
/plugin install ekko-image-gen@zaunekko
/reload-plugins
/plugin 会使用 Claude Code 内置的插件管理界面；需要精确控制 scope、自动化或排查时，再使用下面的 CLI 命令。
把仓库链接和下面这段指令交给你的 Claude Code Agent：
请帮我安装这个 Claude Code 插件市场中的全部插件：
https://github.com/ZaunEkko/claude-plugins
要求：
1. 先确认我要使用 user、project 还是 local scope；如果我已经明确说明，就不要重复询问。
2. 只修改我选择的 scope，不要改动其他 scope 的插件设置。
3. 添加并更新 zaunekko marketplace，读取当前市场清单，然后安装并启用其中的全部插件。
4. 如果同一 scope 已启用 commit-commands@claude-plugins-official，先说明命名空间冲突，再禁用官方版本；不要卸载或删除它。
5. 对 ekko-image-gen，检查 `~/.claude/ekko-image-gen.local.json`。缺失时创建一个只包含 `baseUrl` 与占位 `apiKey` 的配置模板，并提示我直接在本机文件中填写；不要要求我把真实 API Key 粘贴到对话里。模型和多图能力使用插件默认值与运行时自动适配，除非我明确要求高级覆盖。
6. 完成后在当前会话运行 /reload-plugins，并汇报实际执行的命令、安装结果和仍需我填写的配置。
7. 遇到权限、认证或安全确认时停下来让我决定，不要绕过确认。
claude plugin marketplace add ZaunEkko/claude-plugins
claude plugin marketplace update zaunekkoclaude plugin install commit-commands@zaunekko --scope user
claude plugin install ekko-image-gen@zaunekko --scope user如果同一作用域已经启用官方版本，请先禁用官方分发，再启用本版本：
claude plugin disable commit-commands@claude-plugins-official --scope user
claude plugin enable commit-commands@zaunekko --scope user在正在运行的 Claude Code 会话中安装、启用、禁用或更新插件后，执行：
/reload-plugins
已安装插件要获取新版本时，市场更新与插件更新是两件事：
claude plugin marketplace update zaunekko
claude plugin update commit-commands@zaunekko --scope user
claude plugin update ekko-image-gen@zaunekko --scope user创建用户级配置：
- Windows：
%USERPROFILE%\.claude\ekko-image-gen.local.json - macOS / Linux：
~/.claude/ekko-image-gen.local.json
普通用户只需填写 endpoint 和密钥：
{
"baseUrl": "https://your-openai-compatible-service.example/v1",
"apiKey": "replace-with-local-key"
}baseUrl 可以指向 localhost 或第三方 HTTPS 服务。不要把真实 API Key 提交到 Git，也不要粘贴进 Agent 对话。模型默认走 gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 回退链；多图短返回或上游拒绝 n 参数时由 runner 自动降级补齐。两个 2.5 模型 token 单价相同，flare 偏速度、sunburst 偏画质，主代理会按素材逐个分档，不整批升档。高级模型 fallback、尺寸、画质档位和并发配置见 ekko-image-gen 使用指南。
| 作用域 | 适合场景 | 设置位置 |
|---|---|---|
user |
当前用户的默认安装 | ~/.claude/settings.json |
project |
与仓库协作者共享 | .claude/settings.json |
local |
只在当前仓库本机试用 | .claude/settings.local.json |
本地开发和兼容分发测试优先使用 --scope local，避免改动用户级插件设置。
安装市场插件后，可使用：
| 命令 | 作用 |
|---|---|
/commit-commands:commit |
检查改动、暂存相关文件并创建一个 commit。 |
/commit-commands:commit-push-pr |
按顺序 commit、push 并创建 Pull Request。 |
/commit-commands:clean_gone |
先显示确定性计划并请求确认，再安全清理上游已消失、提交仍被保留的分支及干净 worktree。 |
/ekko-image-gen:generate |
调用用户配置的 OpenAI-compatible Images API 完成文生图或图生图，并按当前项目上下文保存、展示和验收图片。 |
生成的 attribution 形如：
Generated with [Claude Code](https://claude.ai/code)
Model: gpt-5.6-sol xhigh
Co-Authored-By: Claude <noreply@anthropic.com>
模型无法可靠解析时会移除 Model: 行，而不是保留过期值或写入 unknown。
- 文档中心
- 安装与更新
- 插件开发指南
- 插件目录结构
- 故障排查
commit-commands使用指南commit-commands实现、测试与上游同步ekko-image-gen使用指南ekko-image-gen实现、配置与测试- 贡献指南
- 支持渠道
.
├── .claude-plugin/
│ └── marketplace.json
├── .github/
│ ├── ISSUE_TEMPLATE/
│ ├── PULL_REQUEST_TEMPLATE.md
│ └── workflows/
├── docs/
├── i18n/
├── plugins/
│ ├── commit-commands/
│ └── ekko-image-gen/
├── CHANGELOG.md
├── CONTRIBUTING.md
└── README.md
每个可安装插件都必须在自己的目录中包含 .claude-plugin/plugin.json。插件的 skills、agents、hooks、MCP 配置与脚本不得放到市场根目录冒充插件组件。
- 持续验证并完善
commit-commands的跨平台与会话解析行为。 - 增加经过安全审查、用途聚焦的
ekko-<specific-purpose>原创插件。 - 为新增插件补齐多语言入口、使用指南、权限说明与行为测试。
- 在公开发布前完成版本、安装、升级、回滚和安全审查流程。
路线图不是发布承诺；以 CHANGELOG.md 和实际 tag 为准。
python -m pip install PyYAML==6.0.3
python .github/validate-repository.py
bash -n plugins/commit-commands/scripts/commit-with-dynamic-attribution.sh
node --test plugins/commit-commands/tests/*.mjs plugins/ekko-image-gen/tests/*.mjs
claude plugin validate .
claude plugin validate . --strict
claude plugin validate plugins/commit-commands
claude plugin validate plugins/commit-commands --strict
claude plugin validate plugins/ekko-image-gen
claude plugin validate plugins/ekko-image-gen --strict--strict 会把验证警告视为错误，适合在 Pull Request 与发布前使用。
Claude Code 插件和市场属于高信任组件：它们可以包含 hooks、脚本、MCP servers，并可能以当前用户权限执行代码。
安装前请：
- 只添加可信来源的市场。
- 阅读目标插件的
plugin.json、hooks/hooks.json、.mcp.json与脚本。 - 使用
/hooks检查当前生效的 hooks 及来源。 - 在
local作用域或隔离环境中先验证第三方插件。 - 不要在 Issue、日志或测试夹具中提交 token、密钥、完整 transcript 或私人路径。
安全问题请遵循 SECURITY.md，不要通过公开 Issue 披露可利用细节。
- 本仓库原创内容默认使用 MIT License。
- 整个
plugins/commit-commands/目录单独使用其内置的 Apache License 2.0，包括上游派生文件与本地新增文件。 - 上游来源、文件哈希、修改说明与同步流程记录在
plugins/commit-commands/UPSTREAM.md。
贡献前请确认目标目录的许可证边界；不要把 Apache 派生内容无说明地复制到 MIT 区域。
- 提交缺陷、文档问题或插件建议：选择 Issue 模板
- 提交代码前阅读：CONTRIBUTING.md
- 获取使用帮助：SUPPORT.md
- 报告安全问题：SECURITY.md
- 社区行为规范：CODE_OF_CONDUCT.md
Pull Request 应说明受影响插件、验证结果、权限或 hook 变化、文档与多语言影响，以及任何上游/许可证来源。