refactor: converge hwpod node-ops channel

2026-06-05 16:47:50 +08:00
parent 8a1cd5c725
commit 3e7131f6ab
117 changed files with 1056 additions and 19327 deletions
@@ -0,0 +1,33 @@
+---
+name: hwpod-cli
+description: Use HWLAB HWPOD from a code agent runner for hardware-development tasks. The hwpod-cli skill reads workspace-local hwpod-spec, calls hwpod-compiler-cli, submits hwpod-node-ops through hwlab-api, and waits for hwpod-node results.
+---
+
+# hwpod-cli
+
+This skill follows Skill(cli-spec). It is the standard task entry for operating an HWPOD from the HWLAB v0.2 Code Agent workspace.
+
+## Standard Path
+
+```text
+hwpod from PATH
+  -> tools/hwpod-cli.ts
+    -> tools/hwpod-compiler-cli.ts
+      -> /v1/hwpod-node-ops on hwlab-api
+        -> hwpod-node on the host side
+```
+
+The HWPOD spec is code-agent-side state. The default path is `.hwlab/hwpod-spec.yaml`; pass `--spec <path>` only when a task explicitly uses another workspace-local spec.
+
+## Commands
+
+- Inspect the HWPOD path: `hwpod inspect --spec .hwlab/hwpod-spec.yaml`.
+- Workspace read: `hwpod workspace ls . --spec .hwlab/hwpod-spec.yaml`.
+- Build/download/reset: use `hwpod build`, `hwpod download`, and `hwpod reset`; the compiler must translate these to `debug.build`, `debug.download`, and `debug.reset` node ops.
+- For early debug bindings, put command bindings in `.hwlab/hwpod-spec.yaml` with `spec.workspace.buildCommand`, `spec.debugProbe.downloadCommand`, or `spec.debugProbe.resetCommand`.
+
+## Boundaries
+
+- Do not pass manual API URLs in locked AgentRun runtimes. Let `HWLAB_RUNTIME_API_URL` / `HWLAB_RUNTIME_NAMESPACE` select the current lane.
+- Do not put full `hwpod-spec` on `hwpod-node`. The node only accepts `hwpod-node-ops`.
+- If HWPOD returns a blocker, report and fix that blocker in this path.