From 3dd7b2d1da3ca04b02d2aabc3dfc4f12300319f7 Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Sun, 7 Jun 2026 13:08:49 +0800 Subject: [PATCH] docs: cross-ref hwlab-code-agent skill from long-term reference docs --- AGENTS.md | 4 +++- docs/reference/spec-v02-code-agent-trace.md | 2 ++ docs/reference/spec-v02-hwlab-cli.md | 2 ++ 3 files changed, 7 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 1119f2e2..89d701e1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -101,6 +101,7 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥 - v0.2 `hwlab-agent-skills` 技能包服务规格：[docs/reference/spec-v02-hwlab-agent-skills.md](docs/reference/spec-v02-hwlab-agent-skills.md)。 - v0.2 `hwlab-cli` 固定 repo 短连接 client 规格：[docs/reference/spec-v02-hwlab-cli.md](docs/reference/spec-v02-hwlab-cli.md)。 - HWPOD Harness 快速迭代规格，定义 workspace-local `hwpod-spec`、`hwpod-cli`、`hwpod-ctl`、`hwpod-compiler-cli`、`hwpod-node-ops` 和 `hwpod-node`：[docs/reference/spec-hwpod-harness.md](docs/reference/spec-hwpod-harness.md)。 +- hwpod-node 运维（G14/D601 启停、cloud-api 注册、源码同步、故障排查）见 `hwpod-ops` skill。 - v0.2 `hwlab-gateway` 硬件 transport 边界规格：[docs/reference/spec-v02-hwlab-gateway.md](docs/reference/spec-v02-hwlab-gateway.md)。 - v0.2 `hwlab-edge-proxy` API edge proxy 规格：[docs/reference/spec-v02-hwlab-edge-proxy.md](docs/reference/spec-v02-hwlab-edge-proxy.md)。 - v0.2 Observability Monitoring 接入规格，应用侧 `/metrics`、ServiceMonitor、PrometheusRule 和 G14 共享监控边界：[docs/reference/spec-v02-observability-monitoring.md](docs/reference/spec-v02-observability-monitoring.md)。 @@ -149,7 +150,8 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥 - DEV 依赖 runtime base 构建：`npm run dev-runtime-base:build` - Legacy D601 DEV CD：旧脚本入口已删除；事故回放只读历史 issue/commit，不恢复旧命令。 - v0.2 WEB 等价短连接 CLI：在 `G14:/root/hwlab-v02` 或当前 v0.2 worktree 直接运行 `bun tools/hwlab-cli/bin/hwlab-cli.ts client ... --base-url http://74.48.78.17:19666`，默认走 Cloud Web 同源 API；细则见 [docs/reference/spec-v02-hwlab-cli.md](docs/reference/spec-v02-hwlab-cli.md)。 -- v0.2 HWPOD CaseRun 无服务入口：`bun tools/hwlab-cli/bin/hwlab-cli.ts case run --case-repo /root/hwlab-case-registry`，第一阶段默认 compile-only 并把 evidence 写回 case registry repo，细则见 [docs/reference/spec-hwpod-harness.md](docs/reference/spec-hwpod-harness.md)。 +- Code Agent session/trace/result/inspect/steer 操作见 `hwlab-code-agent` skill。 +- v0.2 HWPOD CaseRun 无服务入口：用法见 `hwlab-caserun` skill；第一阶段默认 compile-only 并把 evidence 写回 case registry repo，开发/架构细则见 [docs/reference/spec-hwpod-harness.md](docs/reference/spec-hwpod-harness.md)。 - D601 k3s 只读观测：legacy 回溯入口，仅在确认需要 D601 事故复盘时使用；当前 G14 运行面观察使用 UniDesk route `G14:k3s`。 - DEV runtime hotfix 只读审计计划：`npm run dev-runtime:hotfix-audit` - Gateway 主动出站本地 smoke：`npm run gateway:demo:smoke`；经本地 edge-proxy 验证用 `npm run gateway:demo:edge-smoke`。 diff --git a/docs/reference/spec-v02-code-agent-trace.md b/docs/reference/spec-v02-code-agent-trace.md index 56a4ec32..f58446a8 100644 --- a/docs/reference/spec-v02-code-agent-trace.md +++ b/docs/reference/spec-v02-code-agent-trace.md @@ -1,5 +1,7 @@ # v0.2 Code Agent Trace 规格 +> **Code Agent 操作见 `hwlab-code-agent` skill**。以下仅保留 trace renderer 架构和组合复用原则。 + 本文定义 HWLAB v0.2 Code Agent trace、result 和 Cloud Web trace 展示的数据权威、读写路径和回归判定。Trace 是 Workbench 最复杂的用户可见状态面；实现必须先收敛 source of truth，再生成派生 UI/cache，不得通过叠加 fallback、多路径或兼容快照掩盖状态污染。 ## 当前态总览 diff --git a/docs/reference/spec-v02-hwlab-cli.md b/docs/reference/spec-v02-hwlab-cli.md index 30ca2ab5..04d38dc3 100644 --- a/docs/reference/spec-v02-hwlab-cli.md +++ b/docs/reference/spec-v02-hwlab-cli.md @@ -1,5 +1,7 @@ # v0.2 hwlab-cli 短连接 Client 规格 +> **Code Agent 操作见 `hwlab-code-agent` skill**（`~/.agents/skills/hwlab-code-agent/SKILL.md`），包含 session 管理、send、trace/result/inspect、steer、Web 等价路径和 auth。以下仅保留架构和行为规范。 + `hwlab-cli` 是 v0.2 固定开发目录里的短连接业务 client。它用于让 Codex 和人工在 `G14:/root/hwlab-v02` 直接调用与 Cloud Web 相同的 HTTP API，完成除视觉展示以外的真实业务交互和 E2E 排障。 `hwlab-cli` 不属于常驻服务，不发布镜像，不创建 Kubernetes Service、Deployment、CronJob 或 suspended Job template，不进入 GitOps desired state，不作为 CI/CD artifact 构建对象。CLI 源码变更仍属于 `origin/v0.2` source branch：开发时在 `G14:/root/hwlab-v02` 的独立 worktree 修改并提交，按变更风险运行最小单元测试和 `git diff --check`；推送后 v0.2 CI/CD 只应把它识别为 source-only/CLI-only 变化，复用所有 runtime artifact，不新增 `hwlab-cli` image、TaskRun、Deployment 或 Job。