kepler-rules

Kepler Plugins Marketplace

这是团队内部的插件市场仓库，用于分发可在 Claude Code 和 Codex 中安装的插件。

仓库说明

本仓库采用“通用规范 + 工作流打包”的形式：

• kepler-rules：独立的项目编码规范插件
• riper-workflow：整套 RIPER 工作流插件（包含 5 个 skills）
• agent-team-vben-rules：团队协作与 Vben 前端规范插件（根目录插件，包含 2 个 skills）

当前插件：

• kepler-rules
• riper-workflow
• agent-team-vben-rules
• yunxiao-bug-export
• frontend-project-starter

关键目录结构：

.
├── .claude-plugin/marketplace.json          # Claude Code 市场清单
├── .agents/plugins/marketplace.json         # Codex 市场清单
├── .claude-plugin/plugin.json               # 根目录插件 manifest（Claude）
├── .codex-plugin/plugin.json                # 根目录插件 manifest（Codex）
├── skills/                                  # 仓库根目录技能源文件
└── plugins/
    ├── kepler-rules/
    ├── riper-workflow/
    ├── frontend-project-starter/
    └── yunxiao-bug-export/

riper-workflow 内包含以下 skills：

• riper-research
• riper-plan
• riper-execute
• riper-review
• riper-innovate

仓库根目录 skills/ 维护可复用的独立 skill 源文件，目前包括：

• agent-team
• frontend-design-system
• frontend-workflow-standards
• iconify-governance
• vben-component-rules
• yunxiao-bug-export

其技能源文件直接维护在仓库根目录 skills/ 下：

• skills/agent-team/
• skills/frontend-design-system/
• skills/frontend-workflow-standards/
• skills/iconify-governance/
• skills/vben-component-rules/
• skills/yunxiao-bug-export/

frontend-design-system、frontend-workflow-standards、iconify-governance 和 vben-component-rules 是从项目实践中抽象出的公共前端规范 skill，已去除具体项目名称和业务描述。frontend-project-starter 会把这些规范初始化到目标项目的 .agents/ 通用层，并生成 AGENTS.md、CLAUDE.md 和 .codex/skills 兼容入口。

---

在 Claude Code 中安装

Claude Code 支持直接从 GitHub 仓库添加 marketplace。

方式一：直接使用 GitHub 仓库（推荐）

claude plugin marketplace add <owner>/<repo>

示例：

claude plugin marketplace add xuniversity/plugins-marketplace

方式二：使用本地路径

claude plugin marketplace add /绝对路径/plugins-marketplace

添加成功后，在 Claude Code 插件界面中找到本市场并安装：

• 需要 Kepler 编码规范时：kepler-rules
• 需要完整 RIPER 工作流时：riper-workflow（一次安装含 5 个 skills）
• 需要 Agent Team 协作和 Vben 规则时：安装根目录插件 agent-team-vben-rules（一次安装含 2 个 skills）
• 需要导出 Yunxiao 缺陷并生成本地制品时：安装 yunxiao-bug-export
• 需要初始化前端设计系统、共享组件和 Iconify 规范时：安装 frontend-project-starter

---

在 Codex 中安装

Codex 目前采用仓库内本地市场文件模式（$REPO_ROOT/.agents/plugins/marketplace.json）。

安装步骤

1. 克隆仓库到本地：

git clone https://github.com/xuniversity/plugins-marketplace.git

2. 在 Codex 中打开该仓库目录（作为当前工作目录）。
3. 确保存在市场文件：.agents/plugins/marketplace.json。
4. 重启 Codex（修改 marketplace 或 plugin 后也建议重启）。
5. 在 Codex 中打开 /plugins，选择 Kepler Skills Marketplace，安装所需插件。
6. 推荐安装 riper-workflow 以获得完整 RIPER 工作流能力。
7. 如果希望一次安装 agent-team 与 vben-component-rules，安装根目录插件 agent-team-vben-rules。
8. 如果需要导出 Yunxiao 缺陷列表、详情截图和 Markdown/JSON 制品，安装 yunxiao-bug-export。
9. 如果需要初始化一个带设计系统、前端规范和可选组件实现的项目，安装 frontend-project-starter。

如果只是浏览或维护技能源文件，请直接查看仓库根目录 skills/。

---

更新与维护

• 拉取最新插件与市场配置：

git pull

• 新增或调整 root skills/ 下的 skill 时，请同时更新根目录 plugin manifest 和两份 marketplace：
  • .claude-plugin/plugin.json
  • .codex-plugin/plugin.json
  • .claude-plugin/marketplace.json
  • .agents/plugins/marketplace.json