用 MEX 给你的编码智能体一份共享项目记忆

智能体的上下文死在会话边界。一位工程师知道某条约束为什么存在，另一位留着那次调试的历史，而发现边界情况的那个智能体明天就没了。MEX，一个 2k star 的工具，给这些知识一个持久的家：就放在仓库里，是全团队通过 Git 共享的可读 Markdown 文件，外加一层你的智能体可以查询的本地检索。

为什么这个 Skill 重要

MEX 把仓库的两个互补视图结合起来。Wiki 用人能审阅的文字解释架构、约定、决策和模式；Code Graph 用内置的 Tree-sitter 语法把实现中的符号与关系映射进本地 SQLite 索引（TypeScript/TSX、JavaScript/JSX、Python 和 Rust，C# 部分支持）。Wiki 的论断可以锚定到具体的图节点；代码后来变了，代码关联漂移会把受影响的解释标记出来等复审。

权威知识是 .mex/ 下的结构化 Markdown，靠正常的 commit-push-pull 共享。索引是可重建的本地状态，每位团队成员保留在自己的检出目录里。没有托管服务：Hub 跑在 127.0.0.1，MEX 从不自己推送、拉取或提交。

安装

在仓库根目录运行（需要 Node.js 22.5 或更新、Node 构建带 SQLite FTS5，以及一个 Git 仓库）：

npx mex-agent@0.8.5 setup

设置流程跑一个键盘驱动的终端 HUD：选好工具后，它会安装项目入口指令，外加你选择的 Claude Code 或 Codex 集成的官方 Inbox、Relay、Statechart 技能。结束后，审阅确切的设置文件差异，点击 Commit setup。然后开一个新的智能体会话，验证它读到了项目记忆。

加入一个已经在用 MEX 的仓库，三条命令代替整个设置：

npx mex-agent@0.8.5 graph rebuild
npx mex-agent@0.8.5 wiki rebuild-index
npx mex-agent@0.8.5 hub

实战：把一条决策沉淀为团队记忆

你和智能体刚搞清楚为什么重试处理必须幂等。让智能体把它记下来：

• 智能体先查现有 Wiki 记录，然后起草一份 Inbox 提案——对相关知识领域的一条补充或修正。
• 发布会把一份 Markdown 提案写进你的检出目录、进入仓库评审；批准后更新权威知识，提案本身留作历史。
• 真正把内容带给队友的是一次 commit 和 push。智能体永远不会自行发布——技能激活不等于批准。

同样的边界约束 Relay——给下一位接手者的交接记录：智能体可以起草摘要（改了什么、跑了哪些测试、还剩什么），但由人审阅并发布。

实战：用状态图解释一个流程

0.8.5 版本的招牌功能把解释变成经过检查的图：

• 在 Claude Code 里调用 /mex-statechart，在 Codex 里调用 $mex-statechart，或者直接让智能体「用状态图解释这个生命周期」。
• 托管技能底层使用 TLA+ 和 TLC，在支持的聊天里输出 Mermaid。
• 生成留在草稿区；Review Save 会在任何内容进入 .mex/diagrams/ 之前展示确切的快照文件，共享仍是独立的 Git 动作。

技巧

• Cursor、Windsurf、GitHub Copilot 和 OpenCode 拿到的是指令入口，0.8 中没有官方 MEX 技能命令——它们通过项目指令读同一份 .mex/ 记忆。
• mex check 跑全部确定性检查，不用 AI、不写入；mex sync 在一次交互式智能体会话里修好它标记的问题。
• 已有的 MEX 项目有一条独立路径：npx skills add mex-memory/mex 只装技能——仍然需要 MEX CLI 和已配置的项目，所以每个集成只选一种安装方式，别混用。
• 假名标识的使用遥测默认开启；用 mex telemetry inspect 检查，或用 mex telemetry disable 关闭。

何时不用这个 Skill

MEX 不是文档站、任务跟踪器或鉴权层——README 自己的「MEX 不是什么」清单排除了托管同步、通知、RBAC 和 Jira 式管理。在一次性分支上单打独斗？没人会读的 Wiki 就是纯开销；README 的定位是团队记忆，只是「下一个人」有时不过是新会话里的你自己。另外 Code Graph 只索引上面列出的语言——之外的仓库只能得到没有代码证据锚定的 Wiki。

查看 排行榜 了解更多 skill。