From e86cf0b271d919a1f725957b9a4261e2781b367f Mon Sep 17 00:00:00 2001
From: Codex Agent <codex@hwlab.local>
Date: Mon, 8 Jun 2026 12:00:51 +0800
Subject: [PATCH] docs: update code agent gitbundle skill reference

---
 skills/hwlab-code-agent/SKILL.md | 18 +++---------------
 1 file changed, 3 insertions(+), 15 deletions(-)

diff --git a/skills/hwlab-code-agent/SKILL.md b/skills/hwlab-code-agent/SKILL.md
index 4b5d9f84..29d85df9 100644
--- a/skills/hwlab-code-agent/SKILL.md
+++ b/skills/hwlab-code-agent/SKILL.md
@@ -21,7 +21,6 @@ cd ~/.agents/skills/hwlab-code-agent
 
 bun scripts/hwlab-code-agent-cli.ts spawn --message "say hello" --profile dsflash-go
 HWLAB_CODE_AGENT_PROVIDER_PROFILE=dsflash-go bun scripts/hwlab-code-agent-cli.ts spawn --message "say hello from env"
-bun scripts/hwlab-code-agent-cli.ts spawn --message "..." --profile dsflash-go --spec-path /path/to/hwpod-spec.yaml
 bun scripts/hwlab-code-agent-cli.ts poll <traceId> [--timeout 600000]
 bun scripts/hwlab-code-agent-cli.ts result <traceId>
 bun scripts/hwlab-code-agent-cli.ts trace <traceId> [--full]
@@ -31,22 +30,11 @@ bun scripts/hwlab-code-agent-cli.ts trace <traceId> [--full]
 
 输出均为 JSON。`spawn` 创建 session + 提交 prompt，立即返回 `sessionId` + `traceId`，并暴露 `resolvedProviderProfile`、`profileSource`、`parentTraceId`。`poll` 阻塞轮询至 terminal 或超时。
 
-### hwpod spec 自动继承
+### HWPOD spec 与 runtime assets
 
-子 agent 需要 `.hwlab/hwpod-spec.yaml` 才能使用 hwpod。spec 按优先级自动注入：
+HWLAB v0.2 的工具和 skill 注入已经收敛到 AgentRun `ResourceBundleRef.kind="gitbundle"`，权威语义见 `../../docs/reference/agentrun-code-agent-dispatch.md`：repo `tools/` 复制到 runner workspace `tools/`，repo `skills/` 复制到 `.agents/skills`。旧 `workspaceFiles`、seed、`skillRefs` 和 tool alias 注入路径已经移除；不要再用 `--spec-path`、`HWPOD_SPEC_CONTENT` 或 CWD `.hwlab/hwpod-spec.yaml` 通过 direct helper 向子 agent 注入文件。
 
-1. `--spec-path <file>` — 显式指定本地 spec 文件
-2. CWD 下的 `.hwlab/hwpod-spec.yaml` — caserun 注入后自动检测
-3. 环境变量 `HWPOD_SPEC_CONTENT` — yaml 或 base64
-
-Caserun -> Leader -> Coder/Reviewer 继承链：
-
-```
-caserun 注入 .hwlab/hwpod-spec.yaml 到 Leader workspace
-  -> Leader CWD 自动有该文件
-    -> Leader 调用 spawn 时 auto-detect -> 注入子 agent workspaceFiles
-      -> Coder/Reviewer 拿到相同 spec
-```
+CaseRun/HWPOD spec 的启动前准备仍由 HWLAB #1011 跟踪。排障时优先使用 G14 workspace 的正式 `hwlab-cli client agent` Web-equivalent 路径，并从 trace/result 中确认 `resource-bundle-materialized.kind=gitbundle`、`bundles`、`tools`、`skillDirs` 和 `promptRefs`。
 
 provider profile 继承语义不在本 skill 重复定义；排障时只检查 `spawn` JSON 中的 `resolvedProviderProfile`、`profileSource`、`parentTraceId`，再到 `../../docs/reference/agentrun-code-agent-dispatch.md` 对齐权威规则。