Merge pull request #1042 from pikasTech/docs/gitbundle-skill-reference

docs: update code agent gitbundle skill reference
This commit is contained in:
Lyon
2026-06-08 12:01:49 +08:00
committed by GitHub
+3 -15
View File
@@ -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` 对齐权威规则。