2.3 KiB
2.3 KiB
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-mgr和hwlab-agent-worker的 skills commit/version readiness 对齐。 - 不保存用户数据,不保存 Secret,不执行用户代码。
内部架构
- artifact runtime 以 health-only server 方式运行,暴露
/health和/health/live。 - 镜像包含
skills/目录,构建身份来自HWLAB_COMMIT_ID、HWLAB_IMAGE、HWLAB_IMAGE_TAG。 HWLAB_SKILLS_COMMIT_ID由 GitOps render 注入;HWLAB_SKILLS_VERSION是 skills manifest readiness 需要的稳定字段。
API 接口说明
| 接口 | 说明 |
|---|---|
GET /health、GET /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 未稳定注入 version,manager/worker readiness 仍可能报告缺失。 |
| 作为 Code Agent 运行时依赖 | 不采用 | Code Agent 读取镜像内 skills,不应每轮依赖该服务。 |