🧑‍💼 1 人(文科生)領軍 🤖 多 AI agent 團隊 📚 Obsidian = agent 知識層 🌐 HTML = 夏哥閱讀出口

📖 我們公司的開發方法論聖經

我們是 1 位人類(文科背景)+ 多個 AI agent 組成的軟體開發團隊。 本頁自證:這個頁面本身就是用我們自己的建站 SOP(LAYOUT-SOP v8 + 施工指令)建出來的。 開發各種應用——Think9(macOS App)Taxi 學習站、 提案展廳、接案與 SaaS。本站在固化我們自己的「智能體時代軟體工程方法論」。

緣起

我們是 1 人文科生領軍的多 agent 開發團隊。治理與分工不好、沒有業界最佳實踐方法,所以要固化。

點我看詳細 →

目標

一套套用到每個專案的公司 SOP:業界最佳實踐 × 文科生領軍特色。含產線五步、治理分工、九宮格兩形。

點我看詳細 →

相關討論

從 UB 擱置、Obsidian SSoT、Think9 兩形、Anthropic 最佳實踐到專案產線五步——完整討論脈絡。

點我看詳細 →

證據承諾

每一項方法論都有證據:NLM 深度研究佐證(44+ sources)、Think9/Jig9 結構、業界最佳實踐對照。8 格填滿才准查漏。

點我看詳細 →
創意發想型:XY 開發標準八面向並列。8 格填滿才准查漏。
#4 左上🧭

三層 SOP

L0 公司統一 / L1 專案遵守 / L2 量身訂做
統一流程
#5 中上🔧

技術棧

Rust/Leptos + Better Auth + D1;功能維度選棧
業界對齊
#6 右上📦

元件庫八大類

以通用 SaaS 會員站為基準,功能維度分類
八大類
#3 左中🗂️

內容規劃

一頁一主題、資料驅動、進度管理、規畫書撰寫
點格進下一層 →

🎯 XY 開發標準 · 目標與驗收

中心格 = 目標 + 檢核 + 驗收標準(資料驅動)· 點此回頁頂

載入中…
自證:本頁用 SOP 建
#7 右中🏛️

決策紀錄 ADR

Architecture Decision Record:Context/Decision/Rationale/Consequences
業界標準
#2 左下🗄️

資料驅動

CF D1 存 todos/ADR/changelog/專案;跑資料不手刻
跑資料
#1 中下📋

專案管理

todos 打勾、各階段施工規劃、三層 SOP 對照
核心聚焦
#8 右下📖

施工指令

AGENT-BUILD-INSTRUCTIONS:任何 shell 照此手刻合規頁
可執行

👈 #1 專案管理 · 核心聚焦

todos 打勾追蹤:每個專案的行動計畫,完成就打勾,跨裝置同步。

各階段施工規劃:M0 定錨 → M1 研究 → M2 差距 → M3 草案 → M4 Pilot → M5 固化。

三層 SOP 對照:PROJECT-SOP-MATRIX:各專案 L1 是否遵守、L2 量身 SOP 位置。

👉 怎麼驗證 / 證據

此格填滿的標準:

  • todos 在網頁可打勾(存 CF D1)
  • M0-M5 階段各有一份產出
  • 每個專案有 SOP 對照狀態
證據:本頁行動計畫(D1);PROJECT-SOP-MATRIX.md

👈 #2 資料驅動 · 跑資料不手刻

CF D1 資料庫:todos / ADR / changelog / projects 四表,任一 shell 寫入即見。

頁面即時讀取:加一筆資料 → 網頁自動長出,不用改 HTML。

兩層分離:版面(手刻固定)與內容(D1 資料)完全分離,互不污染。

👉 怎麼驗證 / 證據

資料驅動的標準:

  • todos/ADR/changelog 都在 D1 可查
  • 新增資料不需改 HTML
  • command-center scanAdrs() 是典範
證據:/api/todos、/api/adr、/api/changelog、/api/projects

👈 #3 內容規劃 · 一頁一主題

一頁一主題:每頁只處理一個主題,hero 導覽 + 九宮格主體 + tabs 詳細。

九宮格遞迴:點格進下一層再走一遍;邏輯型(閉環前後)或創意型(發想)。

規畫書撰寫:用 Think9/Jig9 九宮格當規畫書格式,每格接 tabs 二欄式(左說明/右證據)。

👉 內容規劃的標準

  • 一頁一主題(不混多主題)
  • 九宮格型態判定可機械化
  • 揭露路徑不重複(hero→overlay、九宮格→tabs)
證據:LAYOUT-SOP v8「一頁一主題 × 九宮格遞迴」

👈 #4 三層 SOP · 統一流程

L0 公司統一流程:所有專案共用(LAYOUT-SOP gcode + 元件庫八大類 + 技術棧)。SSoT = b.nqio。

L1 各專案遵守:套用 template-layout + 過 L3 gate 才 deploy,不可跳過。

L2 各專案量身:專案自己的 SOP(taxi/Think9/fleet),只能加不能推翻 L0。

👉 三層 × 施工對應

  • L0 → b.nqio 方法論(M3 草案 → M5 固化)
  • L1 → 各專案套用(M4 Pilot)
  • L2 → 各專案量身(專案自訂)
證據:LAYOUT-SOP v8 三層 SOP 架構;PROJECT-SOP-MATRIX.md

👉 三層 × 施工對應

  • L0 → b.nqio 方法論(M3 草案 → M5 固化)
  • L1 → 各專案套用(M4 Pilot)
  • L2 → 各專案量身(專案自訂)
證據:LAYOUT-SOP v8 三層 SOP 架構;PROJECT-SOP-MATRIX.md

👈 #5 技術棧 · 業界對齊

核心:Rust 為基礎(Leptos 21.2k★ full-stack、Axum、Tauri 已是 Think9 底層)——記憶體安全 + WASM 性能,2026 企業主流。

認證/會員:Better Auth(29.5k★ framework-agnostic,2FA/多租戶)——不自己寫 login/registration。

資料庫:CF D1(serverless SQLite)+ 部署 CF Pages/Workers(零營運成本)。

功能維度選棧:內容站=純 HTML(現在)、功能站=Leptos/Rust、App=Tauri。

👉 技術棧選擇

功能維度決定選棧:

  • 內容站 → 純 HTML 單檔
  • 內容部落格 → Astro
  • 功能/會員站 → Rust + Leptos
  • 桌面 App → Tauri(已用)
證據:Fleet Navigator「技術棧現況盤點基線」;Leptos 21.2k★、Better Auth 29.5k★(已核實)

👈 #6 元件庫八大類 · 功能維度

以通用 SaaS 會員站為基準:

  • 1 天·導覽品牌:logo/favicon/nav/breadcrumb/login
  • 2 會員身份:註冊/登入/2FA(Better Auth)
  • 3 權限角色:admin/member/guest
  • 4 Hero:主標/副標/四卡/CTA
  • 5 內容結構:九宮格/tabs/卡片
  • 6 表單輸入:欄位/驗證/上傳
  • 7 資料管理:表格/CRUD/後台
  • 8 互動·商務·收尾:overlay/購物車/footer

👉 元件分類與尋找

八大類 × 元件路徑:

  • 功能維度分類(不按技術棧)
  • 每元件有路徑 breadcrumb(天.1.2…)
  • 藏到第八層也找得到(索引+路徑+搜尋)
證據:LAYOUT-SOP v8「八大類 + 元件路徑 breadcrumb」

👈 #7 決策紀錄 ADR

Architecture Decision Record(架構決策紀錄):

  • Status / Date:狀態(Accepted/Proposed)+ 日期
  • Context:決策背景
  • Decision:做了什麼決定
  • Rationale:為什麼
  • Consequences:影響後果

業界標準(Michael Nygard),command-center 也在用。

👉 既有 ADR(D1)

b.nqio 已記錄:

  • 0001 資料驅動架構(Accepted)
  • 0002 技術棧功能維度(Accepted)
證據:/api/adr;bridge docs/adr/ 格式

👈 #8 施工指令 · 可執行

AGENT-BUILD-INSTRUCTIONS v1:任何 shell 照此手刻合規主題頁。

  • 複製 template-layout.html,不重畫版面
  • 判斷九宮格型態(邏輯/創意,可機械化)
  • 三區結構:Hero + 九宮格 + Tabs 二欄式
  • 揭露路徑:hero→overlay、九宮格→tabs
  • 過驗收 gate 才 deploy

本頁就是用這套 SOP 建出來的——自證。

👉 驗收 gate

完成定義:

  • 九宮格 3 欄、中心 row2-col2
  • 8 tabs ↔ 8 panel 二欄式
  • RWD 三斷點 + tabs mobile 橫向捲動
  • deploy + curl 200
證據:AGENT-BUILD-INSTRUCTIONS.md;LAYOUT-SOP L3 gate
🎯 目標 · 檢核標準 · 驗收標準(資料驅動,全站規畫 SITE-PLAN) 載入中…
🗂️ 跨專案控制台 · 全貌視圖(資料驅動,一庫多專案) 載入中…
📋 行動計畫 · 可勾選追蹤:0/0 ↺ 重置
b.nqio.dev · Bible 公司方法論聖經 · 數據來源:NLM 深度研究 + Obsidian SSoT