mirrors/pikasTech-unidesk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: keep HWLAB evidence in issues

Browse Source
This commit is contained in:
Codex
2026-06-14 14:10:05 +00:00
parent c828529570
commit b40a37ce77
5 changed files with 9 additions and 168 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.agents/skills/unidesk-oa/SKILL.md
+2 -1
View File
@@ -16,7 +16,8 @@ description: UniDesk 项目管理运行技能。用户提到 UniDesk 项目管
## 运行模型
- 将 `project-management/PJ2026-01` 下的 Markdown 视为长期规格真相源。
- 将 GitHub issue 视为执行控制面和历史讨论入口：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
- 将 GitHub issue 视为执行控制面、历史讨论入口和长证据承载处：状态、讨论、跨仓引用、PR 链接和收口证据可以在 issue 中流转，但规格正文不得只写在 issue 中。
- 长证据、trace、CaseRun registry、运行日志、历史 issue 摘要和证据索引保留在 GitHub issue 或具体执行 issue 中，禁止以 `evidence/` 目录或长证据文件形式污染 `project-management/PJ2026-01`。
- 不要让日报或阶段报告成为总规划。阶段报告只总结相对总规格的移动，不能替代中心规划。
- 当任务缺少上级方向、验收标准或原始验证入口时，先归类为规划/调查，不要直接变成实现任务。
- L1 方向必须是直接服务 L0 使命的能力域。文档整理、阶段报告、项目管理机制、看板维护、技能维护、仓库名、工具名和临时执行路径都不能作为 L1 方向。
.agents/skills/unidesk-oa/references/project-planning.md
+4 -2
View File
@@ -28,8 +28,10 @@ HWLAB Cloud M1 需要一个项目控制结构，避免局部 issue/PR 工作偏
- PR 和 commit 链接。
- 运行 trace、session、job ID。
- 收口评论。
- 长证据索引、CaseRun registry、运行日志、历史 issue 摘要。
不要把稳定需求的唯一副本放在 issue 评论里。长期有效的需求必须蒸馏到 `project-management/PJ2026-01`，再从 issue 链接过去。
不要把长证据正文放进项目管理目录。项目管理目录只承载规格、治理和阶段中心；长证据保留在 GitHub issue。
## 当前 HWLAB issue 锚点
@@ -63,10 +65,10 @@ specs/stage-cloud-spec-20260601.md # 既有阶段材料
specs/PJ2026-010N-*.md # L1 方向规格
specs/spec-governance.md # 编号、层级、回写与偏离规则
specs/current-center.md # 当前中心和非中心边界
evidence/*.md # 迁出的长证据索引
```
优先维护 L0 总规格作为入口索引。只有当某个部分具有独立生命周期和评审需要时才拆分到 L1、治理、阶段或证据文件。
优先维护 L0 总规格作为入口索引。只有当某个部分具有独立生命周期和评审需要时才拆分到 L1、治理或阶段文件。
禁止在本目录新增 `evidence/` 或其他长证据目录；证据入口在 L0/L1 规格中引用 GitHub issue。
每个长期规格文件最前面必须有修改历史表格，字段固定为：
project-management/PJ2026-01/evidence/agent-orchestration-evidence.md
-102
View File
@@ -1,102 +0,0 @@
# Agent编排证据索引：Code Agent 与 AgentRun 基线归档
## 修改历史
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1223 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1223 |
| 原标题 | Agent编排证据索引：Code Agent 与 AgentRun 基线归档 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1223 |
| 原状态 | open |
| 原更新时间 | 2026-06-14T13:22:33Z |
| 原 body SHA | 7fd86b09fb503174cd14651eeb5af9dc5bfb38c9bbe734cd0245342f02d44192 |
## 正文
上级总项目: #1194
所属方向: #1204 PJ2026-0102 Agent编排
性质: 证据索引，不是 L1 方向，不是 L2 课题，不定义新的产品需求。
迁出/整理时间: 2026-06-14（北京时间）
## 使用规则
- 本文档只保存 Agent编排相关的规格来源、AgentRun SPEC、历史 issue 和开放风险索引。
- #1204 已迁移到 `project-management/PJ2026-01/specs/PJ2026-0102-agent-orchestration.md`，正文只保留稳定需求、边界、L2 分配、验证矩阵和追踪关系。
- 当前 #1204 只保留两个 active L2：PJ2026-010201 任务生命周期、PJ2026-010202 资源装配。
- 证据新增时更新本文档或对应 L2/L3 issue；只有稳定需求变化才回写规格文档。
## 规格来源
- L0 总规格: #1194，要求 Agent编排提供 Code Agent、AgentRun、workspace、session、provider profile、任务生命周期和任务恢复能力。
- 阶段规格: #644，提出云端协同、多用户同时访问 Code Agent、远程协作 AI Coding、Code Agent 长程稳定性和 session resume。
- HWLabOA: 迁移前 HWLabOA `SPEC-CLOUDE-M1.md`，作为迁移前来源材料。
- AgentRun source truth: `G14:/root/agentrun-v01`，分支 `v0.1`，AGENTS.md 定义 AgentRun 是 UniDesk 与 HWLAB 的共享 Agent 执行基础设施。
## AgentRun 长期 SPEC 来源
- `docs/reference/spec-v01-hwlab-manual-dispatch.md`: HWLAB 作为业务 dispatcher，AgentRun 作为执行事实 authority；定义 `run + command + runner-job`、SessionRef、ResourceBundleRef、trace/result、cancel 和 HWLAB canary。
- `docs/reference/spec-v01-runtime-assembly.md`: 定义 `BackendImageRef`、`ProfileRef`、`SessionRef`、`ResourceBundleRef` 四要素，禁止 credential、host path、prompt、skill 和 workspace 文件绕过装配模型。
- `docs/reference/spec-v01-agentrun-mgr.md`: 定义 manager REST API、durable facts、command/run terminal 分离、result envelope、failureKind、session send 和 runner job 查询。
- `docs/reference/spec-v01-agentrun-runner.md`: 定义 runner Job、claim/lease、同 run 多 command loop、SessionRef/PVC、ResourceBundle materialization、event normalization 和 redaction。
- `docs/reference/spec-v01-backend-adapter.md`: 定义 Codex stdio adapter、profile 隔离、assistant/tool/output 事件归一、completed 判定和 failure mapping。
- `docs/reference/spec-v01-provider-profile-management.md`: 定义 provider profile 管理、动态 slug、Secret/config 写入、validate canary 和 HWLAB 委托边界。
- `docs/reference/spec-v01-queue.md`: 定义 AgentRun Queue 直接吸收旧 Code Queue，Queue 与 Session 分层，用户级 follow-up 走 Session。
- `docs/reference/spec-v01-validation.md`: 定义真实运行面验收、短返回 JSON、terminal completed + 非空 reply、event pagination、cancel、SessionRef、ResourceBundleRef 和 bounded output。
## HWLAB issue 历史索引
| Issue | 状态 | 归属切片 | 结论 |
| --- | --- | --- | --- |
| #643 | closed | 任务生命周期 / 资源装配 | HWLAB v0.2 通过 adapter 接入 AgentRun v0.1，HWLAB 对外 API 不变，AgentRun 承接执行事实和运行装配。 |
| #792 | closed | 任务生命周期 | 固化 HWLAB session 与 AgentRun run/job、providerProfile/backendProfile、project/workspace、runner lease 的 authority 边界；session/resume 属于生命周期。 |
| #770 | closed | 任务生命周期 | per-session RWO PVC 直接挂载验证同 session/thread/PVC 跨 runner pod 删除后可继续。 |
| #716/#723/#761/#812 | closed | 任务生命周期 | stale continuation、总超时、继续会话、sessionReuse 元数据等历史问题并入生命周期恢复语义。 |
| #679/#1034/#1038/#1144/#1173 | mixed | 资源装配 | provider profile 从 MiniMax-M3/dfcx-go 到动态配置、权限、默认 Secret 缺口，归入 RuntimeAssembly/ProfileRef 装配。 |
| #1045/#1129/#1130/#933 | mixed | 资源装配 | gitbundle source commit、Web/CaseRun 工具包同步、手动刷新和 CI/GitOps source 对齐形成 ResourceBundle/source truth 需求。 |
| #1189 | open | 任务生命周期 | v0.3 trace 卡在 runner-job-created、真实 tool/stdout 不可见，要求生命周期状态、result pointer 与 runnerjob/liveness 一致。 |
| #1146 | open | 任务生命周期 / 资源装配 | 计费链路成功后 AgentRun 执行 FailedToOpenSocket，说明执行层失败必须与用户账本分离，并检查 provider/profile 装配。 |
| #1197 | open | 任务生命周期 | CaseRun timeout 后 AgentRun claimed、trace raw error/rendered running 不一致，要求 timeout/cancel/terminal 语义统一。 |
| #1129 | open | 资源装配 | CaseRun 与 Web v0.2 使用同类 gitbundle，但 live Web source commit 可能落后，需要暴露 materialized commit。 |
## AgentRun issue 历史索引
| Issue | 状态 | 归属切片 | 结论 |
| --- | --- | --- | --- |
| pikasTech/agentrun#28 | open | 资源装配 | backend image、profile、session、初始资源统一装配调研，后续沉淀到 RuntimeAssembly 和 provider profile 管理 SPEC。 |
| pikasTech/agentrun#31/#36 | mixed | 任务生命周期 / 资源装配 | 按 HWLAB v0.2 基线补齐 AgentRun 自身能力，确认 run/command/runner-job、result、cancel、SessionRef、ResourceBundleRef 和 failureKind。 |
| pikasTech/agentrun#79 | closed | 资源装配 | ResourceBundleRef `promptRefs` 与 gitbundle skill registry 已在 live AgentRun v0.1 验证，resume 后不重复注入 initial prompt。 |
| pikasTech/agentrun#84 | closed | 任务生命周期 | 异步 subagent Session 控制面与 CLI 跑通，session 默认视图、trace/output/read/cancel 建立，归入生命周期。 |
| pikasTech/agentrun#97 | closed | 资源装配 | `workspaceFiles` 支持 bounded UTF-8 seed file，CaseRun 可在 Agent 启动前放置 run-local spec。 |
| pikasTech/agentrun#118 | closed | 资源装配 / 平台交接 | runner 支持 G14 egress proxy 与真实 upstream source 获取，保留 NO_PROXY 和 Secret redaction 边界。 |
| pikasTech/agentrun#166 | closed | 任务生命周期 | timeout 改为空闲超时，持续输出时不按 wall-clock hard timeout 切断；恢复建议走同 session 续跑。 |
| pikasTech/agentrun#172 | open | 任务生命周期 | runnerjob phase/pod identity 可能与 run events/liveness 不一致，要求 describe run/session/runnerjob 语义统一。 |
| pikasTech/agentrun#179 | open | 资源装配 / 平台交接 | AgentRun v0.2 计划用 PK01 PostgreSQL 作为唯一 durable state，验证无状态服务和 HWLAB v0.3 内网接入。 |
## 证据到 #1204 L2 的映射
| #1204 active L2 | 主要证据 |
| --- | --- |
| PJ2026-010201 任务生命周期 | #643、#792、#770、#716、#723、#761、#812、#1146、#1189、#1197、agentrun#31/#36/#84/#166/#172、`spec-v01-hwlab-manual-dispatch.md`、`spec-v01-agentrun-mgr.md`、`spec-v01-agentrun-runner.md`、`spec-v01-validation.md` |
| PJ2026-010202 资源装配 | #643、#679、#917、#1034、#1038、#1045、#1129、#1130、#1144、#1173、agentrun#28/#31/#36/#79/#97/#118/#179、`spec-v01-runtime-assembly.md`、`spec-v01-provider-profile-management.md`、`spec-v01-backend-adapter.md`、`spec-v01-agentrun-runner.md` |
## 概念合并去向
| 原概念 | 当前归属 | 说明 |
| --- | --- | --- |
| 会话恢复 | PJ2026-010201 任务生命周期 | continuation、resume、session send、runner replacement 是任务生命周期恢复语义。 |
| 结果归档 | PJ2026-010201 任务生命周期；评价/展示/长期存储分别交接 #1205/#1206/#1208 | Agent编排只保留 result/trace/artifact pointer、failureKind、lastSeq 等生命周期证据。 |
| 工作区 | PJ2026-010202 资源装配；WebUI 工作区体验交接 #1206；硬件/资源状态交接 #1203/#1208 | workspace materialization、workspaceFiles、seed file 和 source commit 是资源装配输入证明。 |
| 模型配置 | PJ2026-010202 资源装配 | provider profile、backendProfile、model、auth/config SecretRef 是 RuntimeAssembly/ProfileRef 装配项。 |
## 回写规则
- 新增 AgentRun SPEC、HWLAB issue 或 AgentRun issue 证据时，优先更新本文档。
- 如果证据改变 Agent编排需求、L2 划分、验收标准或 authority 边界，再回写 #1204 对应规格文件。
- 如果证据只说明单次失败、PR、PipelineRun、runtime 验证或 provider 事故，不直接写入规格正文。
project-management/PJ2026-01/evidence/hardware-pool-evidence.md
-61
View File
@@ -1,61 +0,0 @@
# 硬件池证据索引：HWPOD 与 CaseRun 基线归档
## 修改历史
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1216 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
| 字段 | 内容 |
| --- | --- |
| 原 issue | pikasTech/HWLAB#1216 |
| 原标题 | 硬件池证据索引：HWPOD 与 CaseRun 基线归档 |
| 原 URL | https://github.com/pikasTech/HWLAB/issues/1216 |
| 原状态 | open |
| 原更新时间 | 2026-06-14T13:09:08Z |
| 原 body SHA | fb361115887931afe355c87ddcfd34ab166f9e9cd1aeef66296e37c7f1e7d2a2 |
## 正文
上级总项目: #1194
主责方向: #1203 PJ2026-0101 硬件池
性质: 证据索引，不是 L2 课题，不重新定义硬件池范围。
迁出来源: #1203 旧版“CaseRun 验证证据 / 当前基线证据”正文
迁出时间: 2026-06-14（北京时间）
## 使用规则
- 本文档 只保存长证据索引、CaseRun registry 路径、trace、runId、jobId 和关键读数摘要。
- L1/L2 规格正文只引用本文档，不展开长证据。
- 新增证据时优先追加评论，避免反复整篇替换。
- 证据可以支撑验收，但不能替代 #1203 的需求、边界和验证矩阵。
- 业务 pass/fail、aggregate、训练反馈归 #1205 HarnessRL；本文档 只记录硬件事实和原始证据入口。
- 支撑 L2 必须使用 #1203 原定 4 个 L2：PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具、PJ2026-010103 HWPOD服务、PJ2026-010104 AI网关。
## HWPOD / CaseRun 基线证据
| 能力 | 证据入口 | 关键证据 | 支撑 L2 |
| --- | --- | --- | --- |
| D601-F103 compile-only 基线 | case registry `d601-f103-v2-compile/issue968-postmerge-v02-20260606022031`；`d601-f103-v2-compile/issue992-summary-20260606-082818` | `status=succeeded`、`compileOnly=true`、Keil job `20260606_102030_0ddb720f`、`downloadSkipped=true`；隔离 subject worktree、trace `trc_case_d601-f103-v2-compile_e781775c67fd4a09bf29eae76a790ec7`、HWPOD build command 和 post-agent compile check | PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具 |
| D601-F103 build/download/UART 链路 | case registry `d601-f103-v2-main-marker-download-uart/issue1020-case2-r7-20260606-172930`；`d601-f103-v2-main-marker-download-uart-20260607052350-41954c34` | stage kinds `spec-validate, inspect, workspace-edit, build, download, uart-read`；trace `trc_case_d601-f103-v2-main-marker-download-uart_34ab5dff913a4eb09a8cdd4bd131d9a9`；后续 run 继续记录 build/download/uart-read 原入口 | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
| D601-F103 Arm2D 运行态 | case registry `d601-f103-v2-arm2d-stage-d/issue1077-stage-d-nosteer-20260609-131740` | HWPOD spec/inspect、workspace 读写、Keil build job `20260609_212320_42aa804f` rc=0/warnings=0、download job `20260609_212343_b81a7a86` completed/Verify OK/Application running、UART read；同时暴露 probe mismatch 风险，跟踪 #1092 | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
| ConStart 71-FREQ build | case registry `constart-71freq-build/constart-71freq-build-20260613150339-9bd9a5ef` | `caseRun=completed; agent=completed; command=completed; postValidation=completed rc=0 warnings=0`；trace `trc_case_constart-71freq-build_17bf45bec2aa4a7cb1aa1215b5ae6551`；验证 mono repo workspace、submodule `5ef2fc874782713d1e4752636a8db05cc4a18cd2`、`hwpod-ctl spec validate`、`hwpod inspect`、`hwpod build` 和 post-agent compile check | PJ2026-010101 HWPOD标准、PJ2026-010102 HWPOD工具、PJ2026-010103 HWPOD服务 |
| PLC AO/ioProbe 硬件闭环 | #1178、#1181、#1182、#1183、#1184、#1185；case registry `constart-71freq-ao-ioprobe-repair/constart-71freq-ao-ioprobe-repair-20260614052517-641c9492` | `caseRun=completed; agent=completed; command=completed; postValidation=completed rc=0 warnings=0`；trace `trc_case_constart-71freq-ao-ioprobe-repair_9f25ef24dfd6410ab64396cf1195d51b`；registry commit `82b04f1`；外部 41 AI0 读数：4000uA -> 3.998754mA，8000uA -> 7.998794mA，12000uA -> 11.995110mA，20000uA -> 19.964974mA，恢复 4000uA 后约 3.998mA | PJ2026-010102 HWPOD工具、PJ2026-010104 AI网关 |
| PLC 真实频率源扩展 | #1186 | 真实频率源端到端扩展仍 open，作为 ioProbe 与 HarnessRL 的交叉下一步 | PJ2026-010104 AI网关，关联 #1205 |
## 已知证据阅读限制
| Issue | 说明 | 支撑 L2 |
| --- | --- | --- |
| #1196 | HWPOD commandExecution trace 主阅读区仍有 wrapper JSON 噪声，影响阅读但不改变硬件事实。 | PJ2026-010103 HWPOD服务 |
| #1197 | CaseRun timeout 后 AgentRun claimed / trace raw error / rendered running 状态不一致，影响超时收口判断。 | PJ2026-010103 HWPOD服务 |
| #1200 | `641c9492` run 的 `final-response.md` 截断但 `present=true`；该 run 的硬件闭环证据以 `aggregate.md`、`agent-transcript.md`、trace 和 registry commit 为准。 | 关联 #1205 HarnessRL，不改变硬件池 L2 划分 |
## 回写规则
- 新证据追加到本文档 评论，或在对应 L2/L3 issue 收口评论中引用本文档。
- 需求、边界或验收口径变化回写 #1203；业务评价变化回写 #1205。
- 不得在本证据索引中新增或重命名硬件池 L2；L2 划分以 #1203 的 4 个原定 L2 为准。
project-management/PJ2026-01/specs/PJ2026-01-HWLAB.md
+3 -2
View File
@@ -4,6 +4,7 @@
| 版本 | 对应 commit id | 更新日期 | 变更说明 |
| --- | --- | --- | --- |
| v0.2 | 待提交 | 2026-06-14 | 移除项目管理目录中的 evidence 文件，长证据保留在 GitHub issue。 |
| v0.1 | 37de91c653c055bf19ac271bdb687b54072639fa | 2026-06-14 | 从 pikasTech/HWLAB#1194 迁移到 UniDesk 项目管理目录。 |
## 迁移来源
@@ -31,8 +32,8 @@
| L1 平台运维 | [PJ2026-0106-platform-ops.md](PJ2026-0106-platform-ops.md) | pikasTech/HWLAB#1208 |
| 治理规则 | [spec-governance.md](spec-governance.md) | pikasTech/HWLAB#1217 |
| 当前中心 | [current-center.md](current-center.md) | pikasTech/HWLAB#1218 |
| 硬件池证据 | [../evidence/hardware-pool-evidence.md](../evidence/hardware-pool-evidence.md) | pikasTech/HWLAB#1216 |
| Agent编排证据 | [../evidence/agent-orchestration-evidence.md](../evidence/agent-orchestration-evidence.md) | pikasTech/HWLAB#1223 |
长证据不进入项目管理目录。硬件池证据保留在 pikasTech/HWLAB#1216，Agent编排证据保留在 pikasTech/HWLAB#1223；规格文件只引用证据 issue，不复制证据正文。
## 正文