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

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

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

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

支柱一 · 插件 marketplace

每个插件自包含，代码在 plugins/<name>/ 下。

插件一览

插件	一句话	文档
intercom	Agent 会话间通信：让同一仓库内并发的多个 Claude Code 会话互为「同伴」——钩子自主投递 + 可选 `channel` 实时推送、点对点/聊天室/项目室广播、advisory 区段锁。	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

安装

/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/ — 一批聚焦 PoC / 逆向：如 cc-internals（Claude Code internals 逆向）、notify-mechanism、mcp-shared-instance-probe、teleport、channel-dedup-poc、bun-native-redis、patch-the-claude-binary 等。原始二进制提取片段（Anthropic 专有）仅本地、不入库（有的目录点进去只见 .gitignore），入库的是分析结论（各目录的 FINDINGS.md / findings/ / README）与可复现脚本。
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/ — 逆向 / 对照用的参考资料与外部快照（多为本地专有物，不入库）。

支柱三 · 私有云子项目

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

在本 base 开发

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