From 844d4a3683145fa44ebf0744449f496e2f2cd058 Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Sat, 6 Jun 2026 19:54:55 +0800 Subject: [PATCH] docs: document caserun serverless debugging rule --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index f8416337..1119f2e2 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,6 +2,12 @@ HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引，只放入口、一句话规则和长期参考链接；细则统一维护在 `docs/reference/`。 +## P0 CaseRun 无服务与单步调试规则 + +- P0: v0.2 HWPOD CaseRun、case registry 产物整理、trace 语义化、harness 诊断、短连接 CLI 和 D601/G14 目标 host 上可直接运行的 runner 调试，默认是无服务工作流；只要不需要变更 cloud-api、web、gateway、GitOps、k3s runtime 或其他常驻服务，就必须直接无服务运行和验证，禁止为了运行 CaseRun 触发 CI/CD、rollout 或服务发布。 +- P0: CaseRun 卡在 hwpod-node、workspace prepare、编译、下载、串口、artifact 收集或其他基础设施步骤时，必须先把卡点拆成同一目标运行面的单步命令验证；禁止用反复全量 CaseRun 大回环替代单步定位。 +- P0: 只有单步卡点已经验证通过，且需要验证完整编排、trace 和 registry 产物时，才启动一次完整 CaseRun；完整 CaseRun 仍必须按 cli-spec 异步启动、短轮询状态、收集 trace，不得加入 evidence 自动评价、门禁或自动判断。 + ## P0 文档/CLI 直接主 worktree 规则 - P0: 单纯文档、AGENTS.md、docs/reference、SPEC、短连接 CLI、trans/tran/helper 这类轻量变更，禁止为了“隔离开发”新建 git worktree；必须在当前工作线固定主 worktree 直接修改、提交并 push 到对应 remote 分支，v0.2 默认 `/root/hwlab-v02` -> `origin/v0.2`。