FR-057 派工監督棒 — 中繼交接(2026-07-28)

項目	內容
緣由	FR-057 設計/開卡/派工 prompt 全部完成,三條實作線已交外部 session 執行;本棒剩「監督進度 + 驗收」。原 session context 已長,寫此 handoff 當保險——2026-07-29 06:00 排程檢查若發現原 session 變笨或已關,下一棒照本文冷接
Branch	BE `feature/instance-agent`(FR-057 文件 commits 未 push);agent/FE repo 由實作 session 各自處理
本棒角色	首腦/監督,不親自實作——實作在另外三個 session(見 §2)
接手前必讀	本文 §0 讀序
預估時間	檢查一輪約 10 分鐘;驗收視完成量

🧭 原始需求 / WHY

FR-057 = 在 FR-056 檢測工具整合平台上接入第二個掃描工具 OpenSCAP(CIS/STIG 組態合規稽核),並開出 connector 第三種連線型態 SSH。

大圖:FR-056(已隨 v1.11.0 上線)讓租戶設定檢測工具 → 任務按開始 → 客戶端 Agent(evidence-agent,Docker)心跳領派工 → 掃描 → 報告自動回收成任務證據。第一版只有 OpenVAS(API 型)。本案價值:①客戶多了組態合規稽核能力(不只弱掃)②connector 架構證明可擴(SSH 型開出後,未來 Lynis 等 CLI/SSH 工具同軌)。

關鍵設計事實(討論中 user 反覆確認過的):

OpenSCAP 是純 CLI 無 API,遠端掃描=官方 oscap-ssh 模式:Agent(Docker,不變)SSH 登入目標主機、在目標上執行目標自己的 oscap、報告拉回。目標主機需一次性裝 openscap-scanner+scap-security-guide——這是官方正規用法(Red Hat Satellite 同模式),不是我們的妥協
憑證=租戶層一組共用稽核帳號(Tenable 同款業界標準),金鑰/密碼二擇一推薦金鑰+sudo,沿用既有加密鏈
證據=每台一份 HTML 原樣上傳 → 牽動 result 回收鏈單檔→多檔(FR-057.3 的由來)
設計全文:docs/features/FR-057-2607-openscap-ssh-connector/design.md(D1–D7);討論稿 Artifact https://claude.ai/code/artifact/e3f6864b-501e-474f-b6c3-cdc97dd59879

§0 接手讀序

🔒 先懂需求 gate:本文「🧭 原始需求」全讀 + design.md §1–§2(背景與 D1–D7)全讀
本文 §2(三條實作線狀態模型)+ §3(檢查 SOP)
Notion 母案(全案索引):https://app.notion.com/p/3ab346da4cd081af9cfac78397f7acfb
需要細節時才開:design.md §4(詳細設計)/ §5(拆分表)

冷接自檢:①FR-057 解決什麼問題?②為什麼目標主機要裝 scanner 而 Agent 不用改實體安裝?③三條實作線各自範圍與依賴?④本棒的角色是什麼(監督驗收,不是實作)?——答不出回去讀。

§1 現況:已完成 vs 進行中

已完成(本棒/前棒做完):

design.md + discussion.html(mermaid 已修三輪,init 內嵌圖首)+ README FR 登記——commits 3e39607e/81301ee1/8c17aefa
Notion 12 張卡:CM-938 母案 / CM-939~941 三子需求 / CM-942~949 八子任務,全 Not started 起始,母子 mention 已回填
.claude/skills/big-feature-workflow/ skill(commit 92b28070)
三份派工 prompt 已交 user,由 user 發給外部 session

進行中(外部 session,狀態以 Notion 為準):見 §2

§2 三條實作線狀態模型

線	卡	依賴	執行方式
FR-057.1	CM-942(T-1.1 BE migration)→ CM-943/944(FE 欄位型態)	無,先行	user 已拿 prompt 發外部 session
FR-057.2	CM-945→946→947(agent connector)	只等 CM-942 變「修正待驗證」(該 session 每小時輪詢)	同上
FR-057.3	CM-948(agent task_executor 多檔)→ CM-949(BE handler 多檔)	無,立即開工	同上

跨線契約(驗收時要盯):connector run() 回 list[ScanResult];.2 不動 core/task_executor.py,.3 不動 core/task_executor_connectors/*;result_ref 多檔=upload_uids 陣列且向下相容單數 upload_uid;OpenVAS 迴歸不可壞。

§3 排程檢查 SOP(2026-07-29 06:00 觸發時做)

Notion 查 CM-942~949 八張卡「狀態」property(搜尋或逐卡 fetch properties,不用讀全文)
彙報格式:三條線各自進度(幾張修正待驗證/幾張 Not started)、卡住的線與原因
有卡變「修正待驗證」→ 提醒 user 可驗收,但不自動驗收不自動改卡狀態(驗收是 user 的事;user 下令後才做獨立抽查:實查 commit diff + 跑測試,不信卡上自報)
全部 Not started 且超過半天 → 提醒 user 外部 session 可能沒起跑
檢查後回報即停,不往收尾跑

§8 行為規範提醒

不切 branch / 不 push(等 user 明示)/ 顯式 git add
文件產出派 subagent(1M model);監督/抽查/派工 prompt 主 session 做
驗收=獨立實查,不信 runner 自報(cf. memory feedback_brain_worker_orchestration_pattern)
收尾(spec/SUMMARY/Notion Done 標記)一律等 user 下令

§10 不在本棒 scope

不親自實作任何一張卡(外部 session 的事)
不做 FR-057 收尾文件(全案完成後 user 下令才走 closing-and-handoff)
install.sh 安裝精靈(user 明示最後再做)、Nessus/SonarQube connector、ARF findings 解析——都不碰

§11 本棒 commits(BE repo,未 push)

92b28070 feat(skills): big-feature-workflow skill
8c17aefa fix(fr057): mermaid init 內嵌圖首(Artifact 雲端渲染)
81301ee1 fix(fr057): mermaid 深色模式配色(頁尾 script,後證僅本機有效)
3e39607e docs(fr057): 設計定案 design.md + discussion.html + FR 登記

§12 給 fresh session 的超短 prompt

請讀 ~/Projects/Billows/Audit-Manager/compliance-manager-be/docs/features/FR-057-2607-openscap-ssh-connector/handoff/2026-07-28-fr057-dispatch-watch-handoff.md,
先過「🧭 原始需求」與冷接自檢,然後照 §3 SOP 檢查 FR-057 三條實作線的 Notion 卡狀態並彙報。
你是監督棒:只檢查、彙報、等 user 指令,不實作不收尾。