Files
pikasTech-HWLAB/docs/reference/spec-v02-hwlab-agent-skills.md
T
2026-05-28 20:57:22 +08:00

2.3 KiB
Raw Blame History

v0.2 hwlab-agent-skills 服务规格

hwlab-agent-skills 是 v02 agent 技能包的部署可见服务,运行在 hwlab-v02 namespace,内部端口 7430。它用于暴露 skills bundle 的构建/health 元数据,不应成为 hwlab-cloud-api 每次 Code Agent 对话的运行时必依赖;Code Agent 实际读取的是镜像内 /app/skills

在系统中的职责划分

  • 证明当前 lane 中 skills bundle 随 source commit 发布,并为 live-build inventory 和 M4/M5 agent-loop 验收提供 health metadata。
  • hwlab-agent-mgrhwlab-agent-worker 的 skills commit/version readiness 对齐。
  • 不保存用户数据,不保存 Secret,不执行用户代码。

内部架构

  • artifact runtime 以 health-only server 方式运行,暴露 /health/health/live
  • 镜像包含 skills/ 目录,构建身份来自 HWLAB_COMMIT_IDHWLAB_IMAGEHWLAB_IMAGE_TAG
  • HWLAB_SKILLS_COMMIT_ID 由 GitOps render 注入;HWLAB_SKILLS_VERSION 是 skills manifest readiness 需要的稳定字段。

API 接口说明

接口 说明
GET /healthGET /health/live 返回 service identity、revision、image/build metadata 和 skills 相关 env。
GET /help 返回 health-only runtime 的可用 route。

测试规格

T1

阅读 docs/reference/spec-v02-hwlab-agent-skills.md,然后用 cli 手动测试以下内容:访问 hwlab-agent-skills:7430/health/live,确认 serviceId=hwlab-agent-skills、revision 与 v02 source commit 对齐。

T2

阅读 docs/reference/spec-v02-hwlab-agent-skills.md,然后用 cli 手动测试以下内容:检查 Deployment env,确认 HWLAB_SKILLS_COMMIT_ID 存在;若 HWLAB_SKILLS_VERSION 缺失,必须在验收结果中标记未完全实现。

规格的实现情况

规格项 状态 说明
health-only 服务 已实现 Deployment/Service 存在,端口 7430。
skills bundle 随镜像发布 已实现 Dockerfile 复制 skills//app/skills
HWLAB_SKILLS_COMMIT_ID 已实现 v02 render 已注入 source commit。
HWLAB_SKILLS_VERSION 未完全实现 当前 render 未稳定注入 versionmanager/worker readiness 仍可能报告缺失。
作为 Code Agent 运行时依赖 不采用 Code Agent 读取镜像内 skills,不应每轮依赖该服务。