美团技术服务合作中心 AI Coding 套件管理中心
下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-tzvk0vz3--mt-openplatform-integrator.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-tzvk0vz3/mt-openplatform-integrator。- 美团技术服务合作中心 AI Coding 套件管理中心。负责合作中心AiCoding公共配置的初始化与管理(企业类型、企业ID、Token等)、子Skills版本同步与更新。当用户提到:初始化合作中心配置、配置开发者信息、更新合作中心Skills、同步Skills版本、修改合作中心配置、查看当前配置,或用户意图模糊地提到"
- 美团技术服务合作中心"
- 但不明确属于生码/问答/排障时使用。
阅读全文 (展开查看完整说明)
概述
技术服务合作中心 AI Coding 套件管理中心
约定
{SUITE_DIR}:本 Skill 的安装目录,即包含本 SKILL.md 文件的目录路径。
使用指南
本 Skill 是合作中心 AI Coding 套件的必装入口与管理中心,本身不承载业务能力(生码、鉴权诊断、知识问答由子 Skill 提供)。完整的能力介绍、触发方式、典型使用场景与最佳实践,请参考官方文档:
首次使用请先完成下方「初始化配置」,并参考同目录下《安装指南》完成整套 Skill 的安装。
能力概览
本 Skill 是技术服务合作中心 AI Coding 套件的公共服务提供者,不承载业务逻辑。提供两类能力:
- 配置管理:初始化、查看、修改开发者公共配置
- 版本同步:从远端拉取子Skills最新版本
套件成员
本套件统一管理以下子 Skill(实际可用项以远端 list_skills 返回为准):
| 子 Skill | 职责 |
|---|---|
| mt-openplatform-aicoding | 生成和修改技术服务合作中心对接代码,查询实时接口契约并按规范生成完整对接代码 |
| mt-openplatform-knowledge-recall | 技术服务合作中心知识召回,检索平台文档/规则/常见问题等知识 |
| mt-openplatform-auth-diagnose | ISV 鉴权诊断,排查接入方鉴权失败、签名/Token 等问题 |
本套件本身(mt-openplatform-integrator)只提供公共配置与版本同步服务,不承载上述业务能力。各子 Skill 的本地安装状态以
registry/local-state.json为准。
一、配置管理
查看当前配置
执行以下命令获取当前配置状态:
bash {SUITE_DIR}/scripts/get-config.sh输出格式:
- 正常:JSON 格式的有效配置
- 未初始化:
{"status": "NOT_INITIALIZED", "message": "..."} - 字段缺失:
{"status": "INCOMPLETE", "missing": [...]}
初始化配置
当配置不存在或用户主动要求初始化时,按以下流程引导:
Step 1:收集 toolsToken
首先向用户收集 toolsToken(工具访问凭证),用于 Skill MCP Tool 鉴权与版本同步接口的身份识别。
| 字段 | 说明 | 获取方式 |
|---|---|---|
| toolsToken | 工具访问凭证 | 从开放平台控制台获取,或通过企业 Token 申请页面申请:服务商 https://developer.meituan.com/zh/v2/isv/aiHub/tokenManage ,品牌商 https://developer.meituan.com/zh/v2/brand/aiHub/tokenManage |
toolsToken 是所有子 Skill 的公共鉴权凭证,远端据此识别身份,务必正确填入。
Step 2:确认 Token 类型并按需收集企业信息
向用户确认 toolsToken 的类型:
- 企业 Token:网关可从 Token 中自动解析出企业身份(principalType、principalId),无需额外填写 principalType 和 principalId
- 个人 Token:网关无法解析企业身份,需要额外填写 principalType 和 principalId
如果用户使用的是个人 Token,继续收集以下字段:
| 字段 | 说明 | 可选值/示例 |
|---|---|---|
| principalType | 企业类型 | 1(服务商)/ 2(品牌) |
| principalId | 企业ID | 从开发者控制台获取 |
如果用户不确定自己的 Token 类型,可先只填 toolsToken 尝试使用。若子 Skill(如 aicoding)调用接口时因缺少企业信息而失败,再补充 principalType 和 principalId。
Step 3:写入配置文件
将收集到的信息写入 {SUITE_DIR}/config/profile.json:
{
"toolsToken": "",
"principalType": "",
"principalId": ""
}principalType 和 principalId 为可选字段,使用企业类型toolsToken时可留空。
Step 4:验证配置
执行 bash {SUITE_DIR}/scripts/get-config.sh 验证配置有效性。若验证通过(toolsToken 非空),告知用户配置完成。
修改配置
用户要求修改某个字段时,读取当前 config/profile.json,修改对应字段后写回,再执行 get-config.sh 验证。
二、版本同步
版本同步会对比本地与远端版本,并按需更新子Skills。
版本对比规则
- 版本不一致即更新:只要本地版本号与远端不一致就触发更新(包括远端回滚到更低版本的场景),始终对齐到远端,不保留本地旧版本。
- 未安装标记为
-1:本地未安装或版本号无法识别时记为-1,在对比中视为"新增",在展示中显示为"未安装"。 - 版本号经归一化处理:
V12 → 12、1.0.0 → 1、空/非数字 →-1。
触发方式
版本同步支持两种触发方式:
- 主动触发(
--check/--pull):用户直接要求检查或同步时使用,不判断时间,每次都执行。 - 被动触发(
--passive-check):由子 Skill(如 aicoding)在启动时自动调用,3 天内检查过则跳过;若有更新则自动安装,全程不阻塞调用方流程。
检查更新(主动)
bash {SUITE_DIR}/scripts/sync.sh --check仅对比并列出可更新/新增/最新项,不执行安装(但会更新 lastCheckAt)。该模式调用远端 list_skills 接口时,请求体中 needSyncUrl 传 false(检查阶段无需下载地址)。
被动检查
bash {SUITE_DIR}/scripts/sync.sh --passive-check供子 Skill 在自身流程启动时静默调用。判断 registry/local-state.json 中的 lastCheckAt 字段,若 3 天内(259200 秒)已检查过则直接返回 {"status":"skipped",...},否则执行版本对比;若发现有更新或新增项,会自动调用 do_pull 下载并安装。整个过程中任何失败(网络异常、安装失败等)均不会阻塞调用方(静默 exit 0)。时间差计算使用 jq 内置函数,跨平台无兼容问题。
执行同步
bash {SUITE_DIR}/scripts/sync.sh --pull下载并安装有更新或新增的子Skills。该模式调用 list_skills 时 needSyncUrl 传 true(需要下载地址)。
子Skill 安装采用原子替换:旧目录先重命名为 .bak,新内容就位后删除 .bak,失败则回滚,避免出现半更新的损坏状态。安装前会备份本地 config/profile.json,安装后再还原,避免本地配置被包内默认值覆盖。
每次成功安装/更新子Skill 后,registry/local-state.json 中对应记录会刷新三个字段:localVersion(对齐到刚安装的版本)、status(置为 installed)、installedAt(记录本次安装的 UTC 时间)。--check / --passive-check 在展示已是最新的子Skill 时会一并显示其 installedAt。
--check、--passive-check、--pull 成功执行后均会更新顶层 lastCheckAt;--pull 还会额外更新 lastSyncAt。
版本对比始终以
registry/local-state.json为唯一本地版本源。远端返回的主套件自身记录会被忽略,仅同步子Skills。
约束
- 本Skill不生成任何业务代码,不执行知识召回,不做鉴权诊断
- 配置文件
config/profile.json是所有子Skill的唯一配置来源 toolsToken为必填字段,principalType和principalId为可选字段(使用企业 Token 时可留空)- 密钥类信息(toolsToken)存储在本地文件中,不传输到非必要的远端