MeshLink 服务发布 Skill
使用 meshlink CLI 将服务发布到集团内网 Mesh
你拥有的能力
meshlink CLI 已安装，可直接用 Bash 执行：
meshlink <command> [flags]
所有命令输出 JSON 到 stdout，ok: true 表示成功，ok: false 包含 error 和 message。
环境变量（需提前设置）：
export ZTM_MESH_NAME=<你的mesh名> # 例如 "mesh" 或 "company-mesh"
发布流程：严格按顺序执行，不得跳步
第 0 步：判断是否触发发布
只有用户明确表达"发布/分享/让某人访问我的服务"时才进入此流程。 询问"如何发布"只需解释，不要执行任何命令。
第 1 步：确认端口
- 如果上下文中端口已知且服务已启动 → 直接使用
- 否则询问用户："请告诉我服务运行的端口号"
第 2 步：检查 Agent 状态和端口（并行执行）
meshlink agent-status
meshlink check-port --port <port>
| 情况 | 处理 |
|---|---|
agent-status → ok: false 或 connected: false | 告知用户 ZTM Agent 未运行，终止流程 |
check-port → listening: false | "端口 {port} 未检测到服务，需要我帮您启动吗？" 等待用户处理后重试 |
| 两者都 ok | 继续第 3 步 |
第 3 步：生成服务名
规则：项目名 → kebab-case 英文（全小写，只含字母/数字/连字符）
示例：
- "客户反馈系统" →
customer-feedback - "AI 数据看板" →
ai-dashboard - "设计规范工具" →
design-spec-tool
如果不确定，提供 2-3 个候选让用户选择，不要强行猜测。
第 4 步：展示发布预览（必须，绝对不可跳过）
在用户确认前，绝对不能执行 meshlink publish。
📋 发布预览
─────────────────────────────────────
服务名称 {service_name}
访问地址 http://127.0.0.1:{分配端口}（发布后本地可访问）
来源端口 :{port}（已检测到 {process_hint}）
发布范围 当前仅自己可访问（Phase 0 模式）
─────────────────────────────────────
确认发布？[y/n]
等待用户明确确认后再执行。
第 5 步：执行发布
用户确认后：
meshlink publish --name <service_name> --port <port>
解析输出：
ok: true→ 继续第 6 步ok: false, error: "NAME_CONFLICT"→ 用suggestion字段的备选名询问用户，重试ok: false, error: "AGENT_ERROR"→ "ZTM Agent 异常，请检查后重试"- 其他失败 → 展示
message，告知用户无需额外操作（无脏数据）
第 6 步：输出发布结果
✅ 发布成功！
访问地址：http://127.0.0.1:{inbound_port}
服务名称：{name}
来源端口：:{target_port}
当前仅您自己可访问。需要分享给更多同事吗？（下一阶段功能）
其他命令使用时机
| 用户意图 | 执行命令 |
|---|---|
| "我发布了哪些服务" | meshlink list |
| "帮我下线 {name}" | meshlink unpublish --name {name} |
| "ZTM 连接正常吗" | meshlink agent-status |
你不能做的事
- 在用户确认前执行
meshlink publish - 跳过
check-port检查直接发布 - 自行构造
curl localhost:7777/...（用 meshlink CLI，不要绕过它） - 修改其他用户的服务