Merge pull request #1042 from pikasTech/docs/gitbundle-skill-reference
docs: update code agent gitbundle skill reference
This commit is contained in:
@@ -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` 对齐权威规则。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user