From beaa89b84c601da18087beca7201df03545c7af2 Mon Sep 17 00:00:00 2001 From: Ether Date: Tue, 31 Mar 2026 12:33:44 +0900 Subject: [PATCH] feat: add Codex plugin support (skills + MCP only) Add .codex-plugin/plugin.json so OpenAI Codex can discover and use the plugin's skills and MCP servers. Hooks, agents, and commands remain Claude Code-only to minimize maintenance overhead. --- .../decisions/2026-03-31-codex-skills-mcp-only.md | 7 +++++++ CHANGELOG.md | 4 ++++ plugins/skill-set/.codex-plugin/plugin.json | 11 +++++++++++ 3 files changed, 22 insertions(+) create mode 100644 .knowledge/decisions/2026-03-31-codex-skills-mcp-only.md create mode 100644 plugins/skill-set/.codex-plugin/plugin.json diff --git a/.knowledge/decisions/2026-03-31-codex-skills-mcp-only.md b/.knowledge/decisions/2026-03-31-codex-skills-mcp-only.md new file mode 100644 index 0000000..4f86dc6 --- /dev/null +++ b/.knowledge/decisions/2026-03-31-codex-skills-mcp-only.md @@ -0,0 +1,7 @@ +# Decision: Codex 호환은 skills/MCP만 지원 + +**Decision**: Codex 플러그인 지원 범위를 skills와 MCP 서버로 한정하고, hooks/agents/commands는 Claude Code 전용으로 유지한다. + +**Context**: skill-set 플러그인을 OpenAI Codex에서도 사용할 수 있도록 확장하는 과정에서, 전체 기능(skills, agents, hooks, commands, MCP)을 모두 호환시킬지 범위를 결정해야 했다. Codex와 Claude Code는 hooks 이벤트 모델, agents 정의 형식(TOML vs 마크다운), commands 개념 유무 등에서 차이가 있다. + +**Rationale**: hooks와 agents까지 Codex 포맷으로 별도 관리하면 중복 코드와 관리 포인트가 늘어나 유지보수가 불편해진다. Claude Code가 메인 플랫폼이므로 이를 기준으로 관리하고, Codex는 양쪽이 이미 동일한 포맷을 공유하는 skills와 MCP만 활용하는 것이 중복 최소화와 유지보수 편의성 측면에서 최선이다. `.codex-plugin/plugin.json` 파일 1개 추가만으로 구현 가능하다. diff --git a/CHANGELOG.md b/CHANGELOG.md index 3918cfb..46bdd6c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [1.8.1] - 2026-03-30 +### Added + +- **codex**: Add `.codex-plugin/plugin.json` for OpenAI Codex compatibility (skills and MCP servers) + ### Fixed - **consulting-peer-llms**: Restrict review command `allowed-tools` from `Bash(command:*)` to `Bash(command:bash *peer-review.sh*)` to structurally prevent agents from bypassing the bundled script and calling `codex -p` directly diff --git a/plugins/skill-set/.codex-plugin/plugin.json b/plugins/skill-set/.codex-plugin/plugin.json new file mode 100644 index 0000000..3789a25 --- /dev/null +++ b/plugins/skill-set/.codex-plugin/plugin.json @@ -0,0 +1,11 @@ +{ + "name": "skill-set", + "description": "Comprehensive productivity skills for coding agents — git workflow automation, code context understanding, peer LLM consulting, prose writing, and more.", + "version": "1.8.1", + "author": { + "name": "ether-moon" + }, + "license": "MIT", + "skills": "./skills/", + "mcpServers": "./.mcp.json" +}