安装与升级

环境要求

• Git，用于获取固定源码提交；
• Python 3；当前版本由 Python 3.13 验证；
• 支持 Agent Skills 目录发现的宿主。

三个运行脚本只使用 Python 标准库，不需要额外安装依赖。

获取已验证源码

git clone https://cnb.cool/mliev/entmesh/skills.git entmesh-skills-src
git -C entmesh-skills-src checkout 2431a2425d09146874ab391f5bbf903a309694b9

python3 entmesh-skills-src/scripts/validate.py
python3 -m unittest discover -s entmesh-skills-src/tests

不要用当前 v0.1.0 Release 压缩包安装三个 Skill；该旧包不包含 entmesh-experiment。

安装到 Codex

mkdir -p ~/.codex/skills
cp -R entmesh-skills-src/entmesh-analysis ~/.codex/skills/
cp -R entmesh-skills-src/entmesh-experiment ~/.codex/skills/
cp -R entmesh-skills-src/entmesh-profile ~/.codex/skills/

安装到 Claude Code

mkdir -p ~/.claude/skills
cp -R entmesh-skills-src/entmesh-analysis ~/.claude/skills/
cp -R entmesh-skills-src/entmesh-experiment ~/.claude/skills/
cp -R entmesh-skills-src/entmesh-profile ~/.claude/skills/

其他兼容宿主把相同的三个自包含目录复制到宿主规定的 Skills 目录。复制完成后启动新会话，确认能够识别 $entmesh-analysis、$entmesh-experiment 和 $entmesh-profile。

安装后检查

以 Codex 为例：

python3 ~/.codex/skills/entmesh-analysis/scripts/entmesh_analysis.py --help
python3 ~/.codex/skills/entmesh-experiment/scripts/entmesh_experiment.py --help
python3 ~/.codex/skills/entmesh-profile/scripts/entmesh_profile.py --help

安全升级

1. 把新源码克隆到新的目录并切换到要审核的固定提交。
2. 运行仓库校验和客户端测试。
3. 阅读 SKILL.md、脚本和参考文件差异。
4. 把宿主中的旧目录移动为带版本号的备份，再复制新目录。
5. 启动新会话，先执行只读 --help 和能力查询。
6. 验证正常后再清理备份。

不要在已有 Skill 目录上直接覆盖合并；旧版本遗留文件可能改变路由或安全说明。