内容
# coryking 插件
**适用于 Claude Code 的插件市场,适用于管理多个代理的团队,并了解这些代理实际执行的操作。**
三个插件,一个安装命令。我使用最多的插件是 **cc-explorer** —— 它是我了解 Claude Code 转录的窗口,否则我将无法阅读这些转录。我使用它来:
- **跨会话保持上下文** —— 将一个会话的上下文带入我当前的工作环境。
- **运行设计和代码审查,使用经历过该工作的会话** —— 克隆过去的会话到一个子代理,并让它进行审查。
- **挖掘聊天历史以获取洞察力和数据** —— 查找决策、实现、转折点,即使我忘记了它发生在哪个项目中。
- **观察代理如何实际使用我编写的工具** —— 查看哪些 MCP 工具有效,哪些失败,以及子代理在哪里出现问题。
- **询问旧会话而不是搜索它们的转录** —— 问一个过去的对话它是什么意思,而不是它说什么。
其他工具也源于同样的需求:用于挖掘项目历史的证据、审查代理编写的代码以及编写更好的 MCP 服务器。
```
/plugin marketplace add coryking/coryking-plugins
```
这将注册插件市场。然后启用您需要的插件(使用 `/plugin` 命令)。跳转到 **[安装](#安装)** 以获取完整的安装路径,包括一个环境变量。
---
## 插件列表
| 插件 | 用途 | 主要功能 |
|---|---|---|
| **项目挖掘** | 读取自己的历史记录 | **`cc-explorer`** (核心功能)+ 证据挖掘协调器 + 注意力反思报告 |
| **工程循环** | 在交付代码之前进行审查 | 并行多角色代码审查,适用于独立工作 |
| **MCP 编写** | 编写模型实际使用的 MCP 工具 | 工具描述的参考资料 |
> cc-explorer 内置于项目挖掘插件中,但它是核心功能 —— 启用该插件即可使用 cc-explorer,无需启用其他功能。
---
## cc-explorer —— 与聊天历史记录对话,而不是搜索它
**最重要的工具。我使用最多的工具。**
`cc-explorer` 是一个 FastMCP 服务器,它解析 `~/.claude/projects/` 中的 JSONL 对话日志,并将它们暴露为 MCP 工具。启用插件后,Claude Code 会自动启动它 —— 工具直接出现在调色板中,无需 shell 命令,无需 `pip install`,`uv` 处理依赖。
以下是关于聊天历史记录的事项:关键字搜索可以找到**内容**,但您通常需要的是**原因**。这两个问题是不同的。cc-explorer 同时解决了这两个问题。
**在忘记会话发生的位置时查找会话。** 同时搜索所有项目 —— 工作树展平,包括子代理体 —— 缩小到一个会话,读取完整记录。流程是 `search_projects` → `grep_session` → `read_turn`,从粗略到精细。我经常使用这个功能来回答诸如 *"我们什么时候意识到猫健身房是空的?"* 这样的问题 —— 一个**原因**问题,普通的 grep 无法解决,因为实现这一点的会话中没有使用我搜索的词语。
**查看子代理的实际操作。** 这是其他工具无法提供的功能。`list_session_agents` 显示会话调度的每个代理;`get_agent_detail` 提供一个代理的完整提示、结果和工具跟踪;`audit_session_tools` 汇总每个工具的计数、错误率和重试次数,以便您回答 *"我的代理是否正确使用我的工具?"* —— 并捕获构建/审查/集成子代理的静默失败和欺骗。
**重建您的注意力。** `get_activity_timeline` 将所有项目的转录记录在一个时间窗口内滚动成一个回合计数网格和预计算的汇总 —— 有多少会话同时运行,峰值,手動 vs. 自動时间。它是注意力报告(如下所述)的确定性基础。
**将过去的会话转换为子代理并** 让它工作。** 这是我最自豪的功能,我也总是向同事推荐它:cc-explorer 可以克隆过去的会话,**克隆它**,并将其重新连接到一个子代理 —— 然后您可以与它对话。问它是什么意思。问它总结自己的过程。或者给它一个任务:它仍然保留着该会话所知道的一切,因此它可以成为设计或代码审查的优秀审查者。我的描述是:**"一个转换器,可以将某物进行转换,在一个您可以连接和询问的代理和一个您可以附加到的会话之间..."** 将**原因**从源头拉出来。(`rewind_transcript` 将克隆的工件回滚到较早的回合,以便您可以从已知点重放;`delete_conversions` 在完成后清理分叉。)
> ⚠️ **会话询问需要代理团队。** 克隆会话在没有它的情况下是无害的,但是**恢复** 克隆的子代理(`SendMessage`)仅在调用会话以 `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` 启动时存在。没有它,您将得到 *"没有转录记录可以恢复。"* 快速检查:`SendMessage` 是否在您的工具集中?请参阅 **[安装](#安装)** 以获取一行设置更改。
所有 cc-explorer 工具都是只读的,除了转换工具,而转换工具拒绝触及任何其他工件 —— 真实会话或已调度子代理永远不会被修改。
## 项目挖掘插件的其他功能
cc-explorer 是核心,但同一插件还提供两个更高级别的工具,基于您的转录记录值得挖掘的想法。
### 项目挖掘 —— 将项目历史记录转变为证据
将项目和**镜头** —— *"找出我展示技术领导力的地方"* , *"找出成为突破口的挣扎"* , *"它实际上是什么"* —— 指向它,它会生成一个丰富、有来源引用的叙述,您可以将其转化为简历要点、面试故事、绩效评估证据或只是自我理解。
诀窍在于证据很少用镜头的词汇标记。 *"大规模系统思维"* 不是通过搜索 *"系统思维"* 找到的 —— 它是 `dispatcher.py` 中的架构决策,加上您说 *"等一下,这在 5 万个事件每小时的情况下不会成立。"* 的会话。将抽象框架转换为具体观察是重点,这就是为什么您要问模型而不是 grep。
在幕后,它是一个 Opus 协调器,它首先与您进行对齐对话(它**会** 在调度前提问 —— 这是一个硬性门槛,因为一个清晰的镜头是所有质量的源头),然后在三个语料库中分发研究代理:**过程** (聊天 + git),**代码库** (源代码 + 文档),和**输出** (运行系统实际产生的内容)。发现被编织,而不是简单地堆叠。
### 注意力反思 —— 饲养税
在一个时间窗口内,您在整个舰队中实际花费注意力的报告:拉入 vs. 委托,以及**类型** 拉入 —— 漂移响应 babysitting vs. 真正的设计 vs. 清洁调度。它调度一个分析师代理,具有隔离的上下文(因此您的先验知识不会污染分类),它将确定性的 `get_activity_timeline` 地图与校准的转录记录配对,因为原始回合计数会系统地过度计算饲养。使用一周后,您将获得一个趋势线,显示舰队是否在为您带来杠杆作用还是抢走您的注意力。
---
## 工程循环
[EveryInc 的复合工程插件](https://github.com/EveryInc/compound-engineering-plugin) 的刻意精简版本 —— 适用于**独立运营** 的部分,团队规模的脚手架被移除。上游提供约 36k 个 tokens 的环境上下文,适用于具有问题队列、Slack 和完整计划→工作→审查→复合方法的內容公司 AI 团队。其中大部分在您和一个长期存在的代码库之间不适用,token 成本是实际的。
剩下的是真正有价值的东西:
- **`/el:review`** —— 并行多镜头代码审查。多个审查者角色同时运行(正确性、测试、维护性、简单性、安全性和性能等),每个角色返回结构化结果,一个合并/去重管道将它们合并为一个置信度门控报告。多个模型通过不同的镜头查看,仍然可以捕获一个过程遗漏的内容。
- **`/el:claude-md-doctor`** —— 诊断您的 `CLAUDE.md` / `.claude/rules` 指令表面是否有膨胀、疤痕和错误机制内容(一种应该成为技能的程序,一个 "始终执行 X" 应该成为钩子)。它生成一个分解图和一个 10 分钟的检查清单,然后**停止** —— 它不会重写您的指令,设计如此。正在测试的假设:干预性,而不是自动化,是有价值的部分。
- **精选研究代理** —— 用于 "在做出决定之前扫描先前技术" 和 "X 的当前最佳实践是什么" 的单一目的系统提示,具有正确的认识论。
有关完整的角色阵容和精简账目(删除、降级或释放的内容),请参阅 [engineering-loop/README.md](engineering-loop/README.md),以及 [engineering-loop/NOTICE](engineering-loop/NOTICE) 中的出处。
---
## MCP 编写
如果您构建 MCP 服务器,您会遇到这种情况:模型会忽略您的工具,或者选择错误的 sibling,您无法知道为什么。通常是描述 —— 它同时是规范**和**提示,值得与系统提示一样多的关注。(97.1% 的受调查 MCP 工具至少有一个组件的描述不合格。这不仅仅是您。)
**`tool-descriptions`** 技能是 MCP 规范、Anthropic 的工具使用指南、FastMCP 惯例和经验性 "糟糕的描述" 研究的参考资料 —— 涵盖描述、服务器 `instructions`、参数模式、输出模式、注释和可恢复的错误设计。它是 eat-your-own-dogfood:cc-explorer 自己的工具就是这样编写的。
---
## 安装
在 Claude Code 中注册插件市场:
```
/plugin marketplace add coryking/coryking-plugins
```
然后打开 `/plugin`,选择您要启用的插件。重启 Claude Code 以加载插件内容和 MCP 服务器。
这是所有功能除了一个功能所需的全部内容。
### 启用会话询问(一个环境变量)
cc-explorer 的核心功能 —— 将过去的会话克隆到一个您可以**交谈** 的子代理中 —— 需要代理团队,该功能在实验性标志后面。将其添加到 `settings.json` (项目 `.claude/settings.json`、`.claude/settings.local.json` 或 `~/.claude/settings.json`)并**重启** (环境变量在会话启动时读取):
```json
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
```
其他功能 —— 搜索、grep、代理取证、活动时间线、转换器的**写入** 端 —— 无需此功能即可工作。只有恢复路径(`SendMessage`)需要它。如果 `SendMessage` 显示在您的工具集中,则表示您已设置。
### 要求
- **Claude Code CLI**
- **`uv`** —— 用于 cc-explorer MCP 服务器的 Python 依赖项。Claude Code 通过 `uv run` 启动服务器,这解决了所有问题;无需手动虚拟环境,无需 `pip install`。
### 更深入的了解
[INSTALLATION.md](INSTALLATION.md) 涵盖了手动安装、在实时存储库检查中进行本地开发(目前尚无插件的可编辑安装 —— 它记录了变通方法)、版本更新记账和您会遇到的陷阱。
---
## 许可证
MIT。`engineering-loop` 插件包含从 EveryInc 的复合工程插件中派生的内容,同样是 MIT 许可证 —— 请参阅 [engineering-loop/NOTICE](engineering-loop/NOTICE)。