Empirical

empirical-memory

由 Empirical 提供支持，为 Claude Code、Codex CLI 和 GitHub Copilot CLI 打造跨工具、跨项目记忆。

在 ChatGPT 中开启一个想法，再在编码 Agent 中接续，完整保留上下文。将潜在客户和关系作为持久记忆跟踪，而不是另用一套 CRM。将记忆整理到不同工作区，以适用于个人、团队或客户场景。在不同会话和项目中回忆以往的决策、偏好和约定，并在工作过程中保存新的持久记忆——这样你就不必重复解释已在其他地方提供过的上下文。

此插件市场提供的功能

• empirical-memory：必需的核心记忆 Skill 和 MCP 服务连接。
• empirical-work-history：可选的简洁已完成工作摘要。
• empirical-scar-tissue：可选的重复失败模式及预防指南。
• empirical-todo：可选的按项目整理的待办事项，包含状态和后续行动。
• empirical-voice：可选的使用你保存的 Empirical 写作风格进行写作（需要通过付费的 Writing Voice 访谈保存写作风格）。

每项功能都是独立的插件，因此用户可以安装或移除可选功能，而无需更改核心记忆连接。

软件包文档：

• Empirical 核心记忆
• 工作历史
• 失败经验
• 待办事项
• 写作风格

安装

Claude Code

claude plugin marketplace add mattgauzza/empirical-memory-plugin
claude plugin install empirical-memory --scope user
claude plugin install empirical-voice@empirical-memory --scope user   # optional, writing voice

Codex CLI

codex marketplace add mattgauzza/empirical-memory-plugin
codex plugin add empirical-memory@empirical-memory

或通过 /plugins 命令浏览并安装。

GitHub Copilot CLI

copilot plugin marketplace add mattgauzza/empirical-memory-plugin
copilot plugin marketplace update empirical-memory
copilot plugin install empirical-memory@empirical-memory

或使用 /plugin install 斜杠命令。

推荐：安装最新的 empirical CLI

MCP 工具可以独立运行，但只要有可用的 empirical CLI，Skills 就优先使用它。 CLI 提供最可靠的身份验证方式、直接的记忆命令，还能避免额外进行一轮 MCP 工具发现。此插件不附带 CLI；请单独安装或更新到最新版本：

npm install -g @empirical-gauzza/cli

首次设置时，运行交互式安装程序，将 CLI 与受支持的编码 Agent 连接起来：

empirical install

安装或更新最新 CLI 无需重新运行 empirical install。如果只想刷新原生插件，请使用 empirical plugin install all；如果交互使用期间检测到较新的 marketplace 插件，CLI 也会提示你进行一次性更新。 你可以立即使用 empirical plugin check --force 检查。

如果要正常交互使用 CLI，但不想永久保存 API 密钥，请运行 empirical auth login，通过浏览器登录并保存本地 OAuth 会话。无头引导仍可用于自动化和外部运行时。

如果你只想使用插件的 MCP 连接，可以跳过 CLI 安装。

如果已安装 CLI，且只需要安装或刷新原生插件，请使用：

empirical plugin install codex       # or copilot, claude, or all

使用 --work-history、--scar-tissue、--todo、--voice 或 --all-optional 显式添加可选功能。例如，empirical plugin install claude --voice 会安装 empirical-voice， 它会以你保存的 Empirical 写作风格撰写内容（这是一项付费功能；需先保存写作风格）。 你也可以使用原生 marketplace 命令：claude plugin install empirical-voice@empirical-memory --scope user。

这不会运行完整的 MCP/身份验证问卷，也不会修改全局指令文件。

通过 empirical install 问卷选择的可选功能，也会通过相同的 marketplace 流程安装。 两者都不会记录原始转录内容或机密信息。个性化回答会作为服务端 Empirical 策略存储，并在本地缓存供原生 skills 使用；不会写入全局 AGENTS.md、CLAUDE.md 或 Copilot 指令文件。

模式感知型技能内容

skills/empirical-memory/ 中包含四个文件，而不是一个：

• SKILL.mcp.md — 用于用户选择仅使用 MCP 的安装。以 MCP 工具为主，只顺带提及 CLI。
• SKILL.cli.md — 用于用户选择直接使用 CLI 的安装。将 empirical CLI 命令作为首选方案重点介绍，仅将 MCP 作为备用方案。
• SKILL.both.md — 用于用户选择同时使用两者的安装。有 CLI 时优先使用 CLI（如今两种路径都会去重并以相同方式自动建立链接，因此这只是对延迟和脚本编写的偏好，与安全无关），MCP 作为备用方案。
• SKILL.md — 每个宿主的原生插件机制实际读取的文件（Claude Code、Codex CLI 和 GitHub Copilot CLI 都会根据字面文件名 SKILL.md 查找插件的技能；它们的清单架构都不支持在安装时从同级变体文件中进行选择）。该文件与 SKILL.both.md 保持一致，因为对于尚未具备模式感知能力的使用方（旧版 CLI、直接克隆的 Git 仓库，或根本没有安装 CLI 的宿主）来说，“两者兼用”是最稳妥的默认值。

empirical CLI 才是让模式选择真正发挥作用的部分：原生插件安装或更新后，它会用与用户所选集成模式相匹配的变体覆盖该宿主磁盘上的 SKILL.md（参见主仓库 empirical_v2 中的 packages/cli/lib/installers/nativePlugin.js）。如果缺少、过时或未能完成覆盖步骤，所有安装仍会从此仓库获取可用的“两者兼用”技能，不会出现缺失或损坏的技能。

编辑技能内容时：请更新 SKILL.mcp.md、SKILL.cli.md 和 SKILL.both.md 中与模式相关的“如何查询”／“如何记录”机制；并手动确保三个文件中的共享策略部分（开始工作前、遵循当前用户策略、持久化耐用上下文、编写的技能和工具包、身份验证与失败）保持一致——没有构建步骤会强制检查这一点。编辑完 SKILL.both.md 后，将其复制到 SKILL.md，确保两者始终一致：

cp skills/empirical-memory/SKILL.both.md skills/empirical-memory/SKILL.md

维护清单

此仓库会发布到四个宿主，每个宿主都有自己的清单格式。所有清单都根据单一事实来源 meta/manifests.json 生成：

生成的文件	宿主
.claude-plugin/plugin.json、.claude-plugin/marketplace.json	Claude Code
.codex-plugin/plugin.json	Codex CLI
.github/plugin/marketplace.json	GitHub Copilot CLI
.agents/plugins/marketplace.json	通用 AGENTS.md

此外，plugins/ 中的每个目录下都有一组 .claude-plugin/ 和 .codex-plugin/。

不要手动编辑这些文件。请编辑 meta/manifests.json，然后重新生成：

node scripts/build-manifests.mjs           # write the manifests
node scripts/build-manifests.mjs --check    # verify nothing drifted (CI runs this)
claude plugin validate . --strict           # same validator the plugin directory runs
npm install --no-save yaml && node scripts/check-skills.mjs   # every SKILL.md frontmatter must be valid YAML

要更新版本号，只需在一个地方更改：meta/manifests.json 中插件的 version。市场清单的 metadata.version 会自动跟随根插件版本。

宿主专属字段应归属于对应宿主。interface 是 Codex/Copilot 区块；Claude Code 会静默忽略未知的顶层字段，因此在 .claude-plugin/ 文件中添加 interface 不会有任何效果。Claude 对应的字段是 displayName、description 和 homepage，且没有与 longDescription、category、capabilities 或 defaultPrompt 对应的字段。生成器会处理这种映射。

许可证

MIT