# my-claude-plugins — xp 的 Claude Code 工作基地

本仓库是 xp 围绕 **Claude Code** 的自研基地，由**三支柱**构成：

1. **插件 marketplace** — 多个自研插件集中托管、统一分发（[`plugins/`](plugins/)、[`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json)）。
2. **Claude 机制探索** — 对 Claude Code 内部机制的逆向研究、PoC 与工具（[`exp/`](exp/)、[`tools/`](tools/)、[`refs/`](refs/)）。
3. **私有云子项目** — 第三方 Claude Code session/bridge 栈，自成一个带完整文档骨架的子项目（[`claude-remote-3rd/`](claude-remote-3rd/)）。

仓库根承载 marketplace 壳、跨支柱的协作纪律与共享记忆；各插件 / 子项目**自包含**（自带 README / CHANGELOG / docs）。

## 支柱一 · 插件 marketplace

每个插件自包含，代码在 [`plugins/<name>/`](plugins/) 下。

### 插件一览

| 插件 | 一句话 | 文档 |
|---|---|---|
| **intercom** | Agent 会话间通信：让同一仓库内并发的多个 Claude Code 会话互为「同伴」——钩子自主投递 + 可选 `channel` 实时推送、点对点/聊天室/项目室广播、advisory 区段锁。 | [plugins/intercom/README.md](plugins/intercom/README.md) |
| **codex-subagent** | 让一个 Claude 会话**主动发起**私有、task-scoped、运行中可 steer 的 codex subagent（MCP server：`codex_start`/`send`/`poll`/`answer`/`interrupt`/`stop`）。 | [plugins/codex-subagent/README.md](plugins/codex-subagent/README.md) |

### 安装

```
/plugin marketplace add puxu-msft/my-claude-plugins      # 或本地路径
/plugin install intercom@xps-marketplace
/plugin install codex-subagent@xps-marketplace
```

各插件**安装即用**：marketplace cache 整拷 `plugins/<name>/` 即自包含，运行时依赖按需自动装入 `${CLAUDE_PLUGIN_DATA}`。装法/配置/约束详见各插件自己的 README。

### 版本与更新

本 marketplace 内的插件**均不固定 `version` 字段**——Claude Code 按 git 源回退到 **commit SHA 当版本**，每次提交即一个新版本，无需手动 bump。使用方拉最新：

```
/plugin marketplace update xps-marketplace
/plugin update <plugin>        # 然后新开会话让新 hooks/MCP 生效
```

## 支柱二 · Claude 机制探索

对 Claude Code 内部机制的逆向研究、概念验证与工具化。结论沉淀在各自的 `FINDINGS.md` / `findings/` 或 README，可复用工具收进 `tools/`。

- **[`exp/`](exp/)** — 一批聚焦 PoC / 逆向：如 [cc-internals](exp/cc-internals/)（Claude Code internals 逆向）、[notify-mechanism](exp/notify-mechanism/)、[mcp-shared-instance-probe](exp/mcp-shared-instance-probe/)、[teleport](exp/teleport/)、[channel-dedup-poc](exp/channel-dedup-poc/)、[bun-native-redis](exp/bun-native-redis/)、[patch-the-claude-binary](exp/patch-the-claude-binary/) 等。原始二进制提取片段（Anthropic 专有）仅本地、不入库（有的目录点进去只见 `.gitignore`），入库的是分析结论（各目录的 `FINDINGS.md` / `findings/` / README）与可复现脚本。
- **[`tools/`](tools/)** — 打磨成型的工具：[unbun](tools/unbun/)（`bun build --compile` 单文件产物的静态提取 / 分析 + 运行时内省 + 就地功能补丁 `cc patch`）。原 `channels-patch` / `agent-patch` 两个 Python 补丁工具的能力已全面吸收进 unbun 的 `cc patch <feature>`（JS 重写、纳入 `bun test`）；原始 Python 工具已移出仓库、留存于 `~/.claude/scripts/channels-patch/` 作 provenance 对照。
- **[`refs/`](refs/)** — 逆向 / 对照用的参考资料与外部快照（多为本地专有物，不入库）。

## 支柱三 · 私有云子项目

**[`claude-remote-3rd/`](claude-remote-3rd/)** — 一个第三方 Claude Code session/bridge 栈：从外部重建 Claude Code 驱动其云端「remote」界面（web / Remote Control / Teleport）的内部引擎，由三个互相消费的逆向 server 各自扮演一面。自带独立的 [README](claude-remote-3rd/README.md)、[ROADMAP](claude-remote-3rd/ROADMAP.md)、[CHANGELOG](claude-remote-3rd/CHANGELOG.md) 与 [docs/](claude-remote-3rd/docs/)——它是子项目，开发从其自身文档入。

## 在本 base 开发

- **协作纪律（必读）**：本仓库常被多个并发 Claude 会话共享同一 git 工作树开发——共享工作树 git 铁律、同伴协调、知识路由、活文档与归档纪律见 [CLAUDE.md](CLAUDE.md)。
- **贡献路径**：加 / 维护插件、往 `exp/` 加 PoC、在子项目里贡献的约定见 [CONTRIBUTING.md](CONTRIBUTING.md)。
- **可复用工作经验记忆库**：[docs/memory/MEMORY.md](docs/memory/MEMORY.md)（每轮自动载入，是背景召回；已横跨三支柱）。