← 回到系統構想

05 / SYSTEM CONCEPT

DayOne:讓新人第一天就看見完整開發路徑

這份設計筆記不預設再做一個問答 bot,而是先驗證能否把工具、權限、環境與第一個 MR 串成可量測的 onboarding journey;目前尚無 bot、CLI 或新人試點。

SYSTEM NOTE / 本頁記錄仍在驗證的產品判斷,不是已完成案例。所有成果指標都要等可重現實驗或實際使用資料成立後,才會升級為 shipped case study。

CURRENT STATUSDESIGN NOTE / NOT STARTED
WHAT EXISTS TODAY

已有 onboarding journey、阻塞分類與 environment doctor 的輸出契約;尚無 bot、doctor CLI 或新人試點。

NEXT EXPERIMENT

挑一個 repository,陪一位新人完成 access → local run → first test → first MR,記錄每個阻塞與人工求助。

SUCCESS CRITERION

首次 local run 與首次 MR 時間縮短,且 environment doctor 的建議能直接解除多數可重現阻塞。

KILL CRITERION

若卡點主要來自組織權限或隱性 mentoring、工具無法提供可行下一步,就停止把它包裝成 AI onboarding 產品。

THE OPPORTUNITY

新人缺的通常不是更多文件,而是不知道現在卡在哪一層。

環境建不起來可能來自 CLI、runtime、VPN、憑證、IAM、repository 或資料依賴。靜態 checklist 無法判斷實際狀態,也無法根據不同 team 與角色調整路徑。

DayOne 以 environment doctor 驗證真實狀態,再由 RelayOps 解釋架構與流程,最後用一個安全的 first-MR journey 讓新人走過完整 delivery loop。

SYSTEM BLUEPRINT

從身分與環境,到第一個可 review 變更

01Profile

依角色、team、repository 與學習目標建立 journey

02Diagnose

檢查 CLI、runtime、VPN、權限、憑證與 dependencies

03Explain

用 service map、request flow 與 ownership 建立系統心智模型

04Practice

在 sandbox 演練 branch、test、debug、MR 與 rollout

05Deliver

引導完成真實但低風險的 first MR

06Improve

把 setup failure 與問答缺口轉成平台 backlog

MEASUREMENT PLAN

把『上手了』改成可以量化與持續改善的結果。

BOOT

Time to first successful local run

MR1

Time to first reviewable merge request

HELP

Senior engineer interruption count

GAP

Documentation and permission gaps discovered

這些是實驗的量測方法,不是現在已達成的成果。

RELATED SYSTEM VISION

若 onboarding 實驗通過,未來可銜接 RelayOps,提供可追溯的工作脈絡。

閱讀 RelayOps 案例