SuperAPI AI 工具集

mex

编程与开发

查看项目

更新于 10-15 19:53

技能介绍

用途:Mex 为 AI 编程智能体提供持久化项目记忆。它把代码映射为确定性代码图谱,将智能体学到的内容整理成结构化 Markdown,并让这些知识与对应实现保持关联,使每次编码会话从相关架构上下文开始,而不是重复全仓库扫描。

主要能力:一键脚手架生成可生长的维基;构建与源码位置绑定的符号级维基;自动生成项目锚点文件(AGENTS.md、CLAUDE.md、.cursorrules 等),让智能体把 mex 上下文当作常驻规则;保持架构笔记、决策与约定同代码同步;漂移检测(mex-agent check);变更后同步维基(mex-agent sync);按任务检索紧凑上下文(mex-agent graph scope "<task>");把 0.7 之前的旧项目迁移到图谱接地(mex-agent graph ground)。支持 TypeScript、JavaScript、Python 和 Rust。

使用方式:推荐一次性自动安装:bash .agent-skills/mex/scripts/install.sh /path/to/project。它会注册技能、解析 mex-agent 可执行文件、非交互运行 mex-agent setup(若 .mex/ 已存在则跳过,可用 --force 重跑)、确保默认 Codex/jeo 路径有根 AGENTS.md 桥接、构建代码图谱并运行 check。常用命令:mex-agent graph、mex-agent check、mex-agent sync、mex-agent graph scope "<task>"。只读环境检查:bash .agent-skills/mex/scripts/mex.sh doctor [project_path]。

限制:mex-agent setup 只生成空模板,不会读取代码库填充内容,需把打印的提示粘贴进编码智能体对话,由该会话写入项目专属内容;非交互运行会跳过接地捕获,需在填充后手动运行 mex-agent graph ground。MCP 包(packages/mex-mcp)尚未发布到 npm,也没有 mcp 子命令,不能声称已作为 MCP 服务器安装,只能从源码构建。mex-agent check 可能刷新 .mex/graph.db,只读审计请在副本上运行。遥测默认开启,可用 DO_NOT_TRACK=1、MEX_TELEMETRY=0 或 mex-agent config set telemetry off 关闭。若机器装有 TeX Live,mex 命令会冲突,mex --version 可区分。项目无值得保留的历史或架构、仅需源码注释生成文档、或更需实时代码检查时,不适合使用本技能。