git:20260901.4e26eb1 to git:20260923.b852b0b

- Claude Code用プラグインを公開するためのマーケットプレイスリポジトリです。

- プラグインには 2 つの配置パターンがある:

- 1. **direct-skill 方式**: 単体スキルプラグインはスキルディレクトリを直接 source にする（`source: "./skills/<skill-dir>"` + `skills: ["./"]`）。`plugins/` 配下のラッパーは不要

- 2. **wrapper 方式**: エージェント依存プラグイン、フック定義プラグイン、複数スキルの bundle は `plugins/<plugin-name>/` 配下にまとめる

- │ └── marketplace.json # プラグインマニフェスト

- ├── skills/ # SKILL.mdの実体かつ単体スキルプラグインのsource

- │ └── README.md # (任意、ユーザー向け設定リファレンスなど)

- ├── plugins/ # wrapper 方式のプラグインのみ

- │ ├── skills/ # bundle の場合、複数 skill 分のエントリ

- │ │ └── <skill-name> # skills/<skill-name> の実ディレクトリコピー

- │ ├── agents/ # (エージェント依存プラグインのみ)

- ├── tests/ # リポジトリ自身のテスト。*.test.mjs を Skill(run-node-tests) が実行する

- │ └── <feature>/

- │ ├── commands/ # 開発用コマンド

- │ ├── skills/ # 開発・テスト用シンボリックリンク

- │ └── agents/ # エージェントへのシンボリックリンク

- ├── CHANGELOG.md # 変更履歴

- └── README.md # リポジトリ説明

- ```

-

- **注意:** marketplace.json で `source: "./"` を使ってはいけない。`skills/` 配下の全スキルが自動発見されて重複登録される（[anthropics/claude-code#13344](https://github.com/anthropics/claude-code/issues/13344)）。必ず `./skills/<skill-dir>` または `./plugins/<plugin-name>` のように specific なパスを指定する。

-

- ## プラグインマニフェスト

-

- **全プラグインが `<source>/.claude-plugin/plugin.json` を持つ。** direct-skill 方式・wrapper 方式のどちらも例外なし。マニフェストの無いプラグインは、インストール後のキャッシュディレクトリ名（バージョン文字列）からプラグイン名が推定され、同名前空間の重複・別プラグイン同士の合流が起きる（[anthropics/claude-code#76234](https://github.com/anthropics/claude-code/issues/76234)）。

-

- - `name` は marketplace.json の `name` と一致させる。スキルディレクトリ名とは異なってよい（例: plugin `peer` → `skills/ask-peer/`）

- - `version` は書かない。marketplace.json を単一のバージョン源とし、plugin.json はそれを継承する。両方に書くとバージョン更新のたびに 2 ファイル編集が必要になる

- - 例外は既存の `plugins/caffeinate` と `plugins/translate` の 2 つ。どちらも `version` を持つため、bump 時は marketplace.json とペアで更新する

-

- ## スキル追加フロー（direct-skill 方式 / エージェント非依存）

-

- スキルが `allowed-tools` を持ち、エージェント / フック定義に依存しない場合。`plugins/` 配下のラッパーは作らない。

-

- ### 1. skills/ ディレクトリにスキル作成

-

- ```text

- skills/<skill-name>/

- ├── .claude-plugin/

- │ └── plugin.json

- ├── SKILL.md

- └── README.md # (任意、設定が複雑ならユーザー向けリファレンスを追加)

- ### 2. SKILL.md

-

- ```markdown

- ---

- name: <skill-name>

- description: スキルの説明

- allowed-tools: Read, Glob, Grep

- ---

-

- # スキル名

- スキルの詳細な説明と使い方

- ```

- ### 3. plugin.json

- `.claude-plugin/plugin.json` を置く。プラグイン名は marketplace.json の `name` と一致させる（スキルディレクトリ名とは異なってよい）。`version` は書かない（marketplace.json を単一のバージョン源とする）。理由は「プラグインマニフェスト」節を参照。

- "description": "スキルの説明",

- ### 4. marketplace.json に追加

-

- `.claude-plugin/marketplace.json` の `plugins` 配列に追加（プラグイン名とスキル名が異なっても OK、例: plugin `peer` → skill `ask-peer`）:

-

- ```json

- {

- "name": "<plugin-name>",

- "source": "./skills/<skill-name>",

- "skills": ["./"],

- "description": "スキルの説明",

- "version": "1.0.0",

- "author": { "name": "hiropon" },

- "category": "workflow"

- }

- ```

-

- ### 5. 開発・テスト用シンボリックリンク作成

-

- ```bash

- ln -s ../../skills/<skill-name> .claude/skills/<skill-name>

- ```

-

- ### 6. CHANGELOG.md 更新

-

- ## プラグイン追加フロー（wrapper 方式）

-

- wrapper には **2 つのサブパターン** がある。必要なファイル構成が異なるので混同しないこと:

-

- | サブパターン | 用途 | `.claude-plugin/plugin.json` | `agents/` | `skills/` |

- |---|---|---|---|---|

- | **A. エージェント / フック wrapper** | エージェント依存 (`translate`)、フック定義 (`caffeinate`) | 必須 | エージェント依存なら必須 | 単一スキルのエントリ |

- | **B. bundle wrapper** | 複数スキルの束 (`dev-workflow-bundle`) | 必須 | 不要 | 複数スキルのエントリ + marketplace.json の `skills` 配列 |

-

- ### サブパターン A: エージェント / フック wrapper

-

- #### A-1. skills/ ディレクトリにスキル作成＋プラグインディレクトリ作成

-

- ```text

- skills/<skill-name>/

- └── SKILL.md

-

- plugins/<plugin-name>/

- ├── .claude-plugin/

- │ └── plugin.json

- ├── skills/

- │ └── <skill-name> # → ../../../skills/<skill-name> (シンボリックリンク)

- ├── agents/ # エージェント依存プラグインのみ

- │ └── <agent-name>.md

- └── README.md

- ```

- ```bash

- mkdir -p skills/<skill-name>

- mkdir -p plugins/<plugin-name>/skills

- ln -s ../../../skills/<skill-name> plugins/<plugin-name>/skills/<skill-name>

- ```

- #### A-2. plugin.json

- ```json

- {

- "name": "<plugin-name>",

- "description": "プラグインの説明",

- "author": {

- "name": "hiroro-work",

- "url": "https://github.com/hiroro-work"

- },

- "homepage": "https://github.com/hiroro-work/claude-plugins",

- "repository": "https://github.com/hiroro-work/claude-plugins",

- "license": "MIT",

- "keywords": ["keyword1", "keyword2"]

- }

- ```

- フック定義が必要な場合は `plugin.json` の `hooks` フィールドで指定（例は `plugins/caffeinate/.claude-plugin/plugin.json` を参照）。

- #### A-3. marketplace.json に追加

- ```json

- {

- "name": "<plugin-name>",

- "source": "./plugins/<plugin-name>",

- "description": "プラグインの説明",

- "version": "1.0.0",

- "author": { "name": "hiropon" },

- "category": "workflow"

- }

- ```

- ### サブパターン B: bundle wrapper

- #### B-1. プラグインディレクトリ作成

- ```text

- plugins/<bundle-name>/

- ├── .claude-plugin/

- │ └── plugin.json

- └── skills/

- ├── <skill-a> # → ../../../skills/<skill-a>

- ├── <skill-b> # → ../../../skills/<skill-b>

- └── ...

- ```

- ```bash

- mkdir -p plugins/<bundle-name>/skills

- ln -s ../../../skills/<skill-a> plugins/<bundle-name>/skills/<skill-a>

- ln -s ../../../skills/<skill-b> plugins/<bundle-name>/skills/<skill-b>

- ```

- #### B-2. marketplace.json に追加（`skills` 配列を明示）

- ```json

- {

- "name": "<bundle-name>",

- "source": "./plugins/<bundle-name>",

- "skills": ["./skills/<skill-a>", "./skills/<skill-b>"],

- "description": "bundle の説明",

- "version": "1.0.0",

- "author": { "name": "hiropon" },

- "category": "workflow"

- }

- ```

- `skills` 配列と `plugins/<bundle-name>/skills/` 配下のエントリセットは **必ず一致** させること（`/verify-plugins` と `run-tests` が整合性を検証する）。

- **wrapper 配下の `skills/` エントリは symlink ではなく実ディレクトリコピー**（`ln -s` の例は upstream bug 修正後の想定形）。plugin cache が symlink を解決しない bug（[anthropics/claude-code#53948](https://github.com/anthropics/claude-code/issues/53948)）を回避するため commit `56026cb` で全 wrapper を一括変換済み。詳細と検証ツール側の扱いは `.claude/rules/project.rules.md` § プラグイン構造 の wrapper エントリ bullet を参照。

- `dev-workflow-bundle` にメンバーを追加する場合はもう 1 つ義務がある: 新メンバーの `SKILL.md` に横断ディレクティブ `## Dispatch authorization` を他メンバーと byte-identical に同梱すること（漏れると `/verify-plugins` と `run-tests` Check 7 が落ちる）。文言・配置の source of truth は `.claude/rules/project.rules.md` § プラグイン構造 の「**bundle 全メンバーに複製する横断ディレクティブは byte-identical を保ち、メンバー追加時に必ず同梱する**」bullet。

- ### wrapper 共通: 開発・テスト用シンボリックリンク作成

- ```bash

- # スキル

- ln -s ../../skills/<skill-name> .claude/skills/<skill-name>

- # エージェント（サブパターン A のみ）

- ln -s ../../plugins/<plugin-name>/agents/<agent-name>.md .claude/agents/<agent-name>.md

- ```

- ### wrapper 共通: CHANGELOG.md 更新

- /verify-plugins --full # 完全検証（CLI更新確認を含む）

- /test-skills # スキル・エージェント動作テスト

- ## コーディング規約

-

- ### 命名規則

-

- - スキル名: kebab-case（例: `security-scanner`, `ask-claude`）

- - プラグイン名: kebab-case（例: `peer`, `translate`）

- - エージェント名: kebab-case（例: `peer`, `tr`）

-

- ### allowed-tools

-

- - 必要最小限の権限のみ付与

- - `Bash(*)` は避け、具体的なコマンドを指定（例: `Bash(git *)`, `Bash(jq *)`）

- - セキュリティスキャンで警告される可能性のあるパターンは正当な理由がある場合のみ使用

-

- ### バージョン管理

-

- - セマンティックバージョニング（SemVer）を使用

- - `marketplace.json` と `plugin.json` のバージョンは常に一致させる

- ### ドキュメント

- - README.md: ユーザー向けのドキュメント（使い方、機能、設定など）

- - SKILL.md: Claude向けの指示（処理フロー、出力形式など）

- プラグイン追加時は `/security-scanner --project` でセキュリティスキャンを実行し、問題がないことを確認してください。