FixMyPrompt

面向 Claude Code 和 Codex 的 FixMyPrompt

别再让 Claude Code 和 Codex 把同一个问题解决两遍。

你花了一个小时和 Claude 一起让一个不稳定的测试通过。它终于找到了可行的修复方法。下周，另一个文件里又出现了类似的故障，Claude 却要从头开始，因为 CLAUDE.md 里没有记录这个修复，而自动记忆顶多只记住了一句话。

这个插件会保存修复本身：适用条件、有效的步骤、检查方法，以及看似正确但实际无效的做法。在该文件夹中每次开始会话时，Claude 都会收到已解决问题的列表，并且只在某条记忆适用于当前任务时才会获取完整步骤。

Example, for illustration

> claude
  SessionStart hook: This folder is billing-api. Before you start work,
  call the fmp mem_index tool with project "billing-api" ...

● fmp - mem_index (project: "billing-api")
  #12 Flaky date tests: freeze the clock and seed the RNG
  #9  Stripe webhook 400s locally: forward with the CLI, not ngrok
  #4  Running migrations: never db push, add a file under supabase/migrations

> the invoice tests are failing randomly again

● Using #12. Same symptom as the date tests: ...

功能

• 自动加载记忆。 会话开始钩子会告诉 Claude 当前所在的文件夹，并让它检查为该文件夹保存的内容。无需提示它记忆。
• 边工作边保存经验。 Claude 从犯错到找到有效修复方法时，会将其保存为草稿记忆，并简短告知你。不会打断工作。
• 导入过往会话。 /fmp:import 会读取你本机上该文件夹的 Claude Code 日志，并保存其中的经验。
• 检查 Agent 文件。 /fmp:doctor 会为 CLAUDE.md、AGENTS.md 和 .cursorrules 评分，找出缺失的防护规则和复制进去的文本工具，并生成修正后的文件。你也可以先在网上免费试用：CLAUDE.md 检查器。

通过 MCP 使用记忆属于 FixMyPrompt Pro 计划，提供 7 天试用。钩子本身只有约 130 行纯 Node 代码，位于 plugins/fmp/hooks/session-start.mjs，安装前你可以准确查看它会发送哪些内容。

刚接触 Claude Code 中的钩子或记忆？这些指南介绍了本插件的基础功能：Claude Code 记忆详解 和 Claude Code 钩子详解。

安装

在 Claude Code 中运行：

/plugin marketplace add GDM-Digital-Media-Group/fmp-plugins
/plugin install fmp@fmp-plugins

然后重启 Claude Code，以加载插件。

在 Codex 中使用

同一个插件也适用于 Codex CLI 和 Codex 应用。在终端中运行：

codex plugin marketplace add GDM-Digital-Media-Group/fmp-plugins
codex plugin add fmp@fmp-plugins
codex mcp login fmp

最后一条命令会在浏览器中打开 FixMyPrompt，让你批准连接。每台机器只需操作一次。然后在项目中启动 codex 并运行 /hooks：Codex 会要求你审核并信任插件的会话开始钩子，然后才会运行；每当钩子发生变化时，它都会再次征求许可。在你信任钩子之前，记忆工具仍可使用，但 Codex 不会在会话开始时收到检查这些工具的提示。

在 Codex 中，插件的三个技能是 fmp:sign-in、fmp:import 和 fmp:doctor。按名称调用它们，或从 /skills 中选择。以下所有功能在两个应用中的用法都相同；在一台机器上登录一次插件即可同时用于两者。

登录

插件会添加一个名为 fmp 的 MCP 服务，指向 https://fixmyprompt.net/api/mcp。插件文件中不会存储任何机密信息。

Claude Code 首次使用时，运行 /mcp，选择 fmp，然后选择登录。浏览器会打开 FixMyPrompt，你批准连接即可完成。每台机器只需操作一次。

此钩子的作用

会话开始时，一个小型钩子会为 Claude 添加上下文。它以这句话开头：

此文件夹是 <folder name>。开始工作前，请调用 fmp mem_index 工具，项目设为“<folder name>”，并使用它列出的内容。

文件夹名称是 Claude Code 打开的文件夹的最后一部分。然后，Claude 会向 FixMyPrompt 请求该文件夹已保存记忆的简短索引，并且只在有记忆适用于当前任务时才获取完整记忆。如果该文件夹尚未保存任何内容，索引会说明这一点，且不会创建任何内容。

在你登录插件之前，钩子不会读取文件、保存凭据或发起网络请求。运行 /fmp:sign-in 后，钩子还会在会话开始时及每次压缩后，从 FixMyPrompt 获取公司的页面和该文件夹的会话备注，并直接提供给 Claude，这样 Claude 就不必自行查找。这次登录信息会保存在此计算机的 ~/.claude/fmp/plugin.json 中，并绑定到一个 FixMyPrompt 账户；它只能读取你的页面和会话备注，你可以在 FixMyPrompt 的 Settings、MCP connections 中撤销授权。

登录插件

登录插件与上文的 fmp 连接彼此独立，只有在需要使用公司页面和会话备注时才需要登录。运行：

/fmp:sign-in

Claude 会显示一个 8 位字母代码，并在浏览器中打开 FixMyPrompt。确认你登录的是所需账户，在终端中输入该代码，然后点击 Approve。只批准你刚刚在自己的计算机上发起的代码。回到 Claude Code 后，登录即会完成，Claude 会告诉你当前登录的是哪个账户。

从此以后，每次会话开始时都会加载公司已批准的页面（公司规则、你的角色页面和你自己的规则）以及该文件夹的会话备注，并在每次压缩后重新加载。让 Claude 检查插件登录状态即可查看账户；让 Claude 退出插件登录即可在此计算机上结束登录。你也可以在 FixMyPrompt 的 Settings、MCP connections 中撤销授权。授权撤销、你离开公司或连续 180 天未使用后，登录都会失效。

会话备注

Claude 会为每个文件夹保留一条简短的私人备注，记录你正在做的事、已作出的决定、有效的修复方法以及接下来要做的事。它会在重要节点更新备注，而不是每轮对话都更新；备注中绝不会包含代码、机密或对话内容。只有你能看到这条备注；同一公司的团队成员也看不到。

备注会在上次保存 3 天后过期，除非你在 FixMyPrompt 的 Context 页面中将其保留，这会把它保存为你的私人记忆之一。Claude Code 和 Codex 都可通过此插件使用会话备注。

自动保存经验

在那句话之后，钩子会让 Claude 在工作过程中自行保存经验。经验是指一个错误，接着是一次纠正（来自你、失败的测试、构建错误或文档），再接着是有效的版本。错别字和一轮对话中的小失误不算。Claude 会先检查已有内容，将经验保存到此文件夹，并在不停下工作的情况下显示一行 Saved a lesson: <title>。它绝不会保存超过 10 行的代码、机密或对话内容。

每条经验都会作为草稿保存到 FixMyPrompt，并标记为“自动保存，需查看”。下次会话开始时就能读取这些内容。打开 Memories，即可保留、编辑、合并或删除经验。

自动保存和导入功能包含在 Pro 及更高版本中。要关闭自动保存，请在 FixMyPrompt 中打开 Settings，并关闭“自动保存经验”。此后，FixMyPrompt 会拒绝自动保存的经验，Claude 也会在本次会话剩余时间内停止尝试保存。公司所有者可以为整个公司关闭此功能。

导入过往会话

/fmp:import 会读取你在这台机器上当前文件夹对应的过往 Claude Code 和 Codex 会话（~/.claude/projects 和 ~/.codex/sessions 下的日志），并将其中的经验教训保存为同类草稿。它会优先列出最近 30 天的会话，并询问你要读取哪些；默认选中尚未导入的会话。

Claude 会读取你机器上的日志，只将它选出的经验教训发送给 FixMyPrompt，绝不会发送代码、日志或完整会话。会话读取器是插件中的一个小脚本，不使用网络。它会仅在你的机器上，将已导入会话的列表保存在 ~/.claude/fmp/imported-sessions.json 中，因此再次运行导入时会跳过这些会话。完成后，Claude 会告诉你保存了多少条经验教训、略过了多少条，以及原因。

检查你的 Agent 文件

/fmp:doctor 会对代码库中的 Agent 指令文件运行 FixMyPrompt Agent Doctor：当前文件夹及其父级目录中的 CLAUDE.md、AGENTS.md、.cursorrules、.cursor/rules/* 和 .github/copilot-instructions.md，以及 ~/.claude/CLAUDE.md 和 ~/.codex/AGENTS.md。它还会发送 package.json 和锁文件的名称，以便检查了解你的技术栈。它绝不会发送源代码。

Claude 会向你展示报告，并针对文件中缺少的规则提出几个简短问题（跳过的问题会变成 TODO 行，而不是猜测），然后展示完整的更改列表，并使用其常规 Edit 或 Write 工具写入修复后的文件，因此是否先征求你的许可取决于你的权限设置。除非代码库在 git 中是干净的，否则会先将每个旧文件复制为 <name>.fmp-backup。

Agent Doctor 是 Pro 的一部分。

关闭它

要停止会话启动钩子、自动保存和 fmp 服务，请禁用该插件：

/plugin disable fmp@fmp-plugins

运行 /plugin enable fmp@fmp-plugins 可重新启用它，或运行 /plugin uninstall fmp@fmp-plugins 将其移除。

如果你想保留记忆工具，但不需要会话启动行，请卸载该插件，然后手动添加服务：

claude mcp add --transport http fmp https://fixmyprompt.net/api/mcp

帮助

如有疑问或遇到问题：[email protected]