Agent Skills 概览

Entmesh Agent Skills 让 Codex、Claude Code 和其他兼容 Agent 通过项目级 API Token 执行受治理的统计分析、实验和用户画像任务。

本手册验证的源码版本：

• 仓库：cnb.cool/mliev/entmesh/skills
• VERSION：0.3.0
• Controller Proto：4.29.0
• 固定提交：2431a2425d09146874ab391f5bbf903a309694b9

当前旧 v0.1.0 Release 压缩包未包含 entmesh-experiment，本手册不使用该制品，统一从上述固定源码提交安装。

三个 Skill

• entmesh-analysis：指标、数据完整性、事件/漏斗/留存、保存分析、看板、事件标注和访问明细。
• entmesh-experiment：实验草稿、Feature Flag、Release、部署、流量治理、健康、结果与决策。
• entmesh-profile：已识别用户画像、动态标签、条件/ID/受限 SQL 分群。

三个目录都包含 SKILL.md、宿主元数据、Python CLI 和按需加载的参考资料，可以单独安装，也可以同时安装。

推荐顺序

1. 安装与升级
2. 配置项目 API Token
3. 根据任务选择 entmesh-analysis、entmesh-experiment 或 entmesh-profile
4. 执行写操作前阅读安全边界与排障

调用方式

可以在对话中显式点名 Skill：

使用 $entmesh-analysis 检查 production 最近 30 天支付金额指标的数据完整性。
使用 $entmesh-experiment 查看当前环境需要处理的实验健康问题，不执行写操作。
使用 $entmesh-profile 查询 user_id=customer-10086 的画像和标签历史。

也可以直接运行各目录的 Python CLI。CLI 向 stdout 输出 JSON、向 stderr 输出诊断信息；Token 不应出现在输出、日志或对话中。

权限模型

项目 Token 只访问一个项目、明确环境和明确 scopes。它不能管理组织、项目配置、采集密钥或其他 Token，也不能用于事件采集。套餐授权被撤销后，即使 Token 尚未到期，相应请求仍会被拒绝。