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

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

我們是 1 位人類（文科背景）+ 多個 AI agent 組成的軟體開發團隊。開發各種應用——Think9（macOS App）、Taxi 學習站、提案展廳、接案與 SaaS。本站在固化我們自己的「智能體時代軟體工程方法論」。

緣

緣起

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

點我看詳細 →

標

目標

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

點我看詳細 →

論

證據承諾

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

點我看詳細 →

の字序：中下#1 → 順時針推完 #8。8 格填滿才准查漏。

#4 左上🏗️

專案產線

五步：folder → repo(private) → obsidian → host → 其他

四方矩陣

#5 中上👨‍💻

開發執行

Planner/Generator/Evaluator、Spec-Driven、sprint contract

五行環扣

#6 右上✅

驗收品質

證據鏈驗收包、獨立 reviewer、測試閘、你「不看 code 核准」

六維行動

#3 左中🔬

研究知識

NLM 深度研究、Obsidian SSoT、上下文工程、業界最佳實踐

三位一體

🧭 方法論總指揮

8 格填滿 → 檢查有沒有漏

兩形共用

#7 右中🚀

發布營運

上架/接案/SaaS 差異、host 選擇(CF/VPS/Vercel)、版本回滾

七政規律

#2 左下⚖️

治理分工

你管什麼、agent 管什麼、maker/checker 分離、HITL 邊界

二元對立

#1 中下🎯

願景定位

公司是什麼、「1 人文科生 + 多 agent」的第五項修練

核心聚焦

#8 右下🔄

迭代學習

pilot 試行、回饋→SOP v2、週期 NLM 更新、健康指標

八卦演化

👈 #1 願景定位 · 核心聚焦

公司是什麼：「1 人文科生 + 多 AI agent」組成的軟體開發組織。不是單一產品公司，而是「1 人 + agent 艦隊」。

第五項修練：這是整個團隊的作業規畫與治理——L0 公司 SOP 層（不是產品開發 L2 層）。

核心哲學：8 格填滿才准查漏。治理 ≠ 單一工具 SOP，而是整個團隊怎麼作業。

👉 怎麼驗證 / 證據

此格填滿的標準：

一句話講得清楚「我們公司是什麼」
三層定位（L0 SOP / L1 知識層 / L2 產品層）各自成立
每格都對應到一個「可執行」的 SOP 產物

證據：b.nqio.dev 緣起 overlay + 20-Projects/b.nqio.dev.md 產線五步

👈 #2 治理分工 · 二元對立

夏哥（人類）管：goal/價值/品味、對外發布、花錢、刪除/破壞、不可逆、私密憑證、法遵。

Agent 管：技術 strategy/tactics、深度與跨模型核實、產線執行。發起的技術變更深度核實是自己的責任，不是丟選擇題給夏哥。

maker/checker 分離：產出者 ≠ 評分者。subagent 說 done 未經獨立核實不算數。

👉 HITL 邊界

人機介入點設計：

只有 goal/價值/對外/花錢/刪除/不可逆/憑證/法遵才問夏哥
技術選擇 agent 自己負責（一個推薦，不丟選項）
派工是成本優化，當前殼自負驗證與統合

證據：soul.md §2 治理；FLOOR.md WHO/WHERE 段落

👈 #3 研究知識 · 三位一體

NLM CLI = 深入研究主力：有憑有據、token 節省，應第一時間使用。b.nqio 研究已建立 notebook（44+ sources imported）。

Obsidian = agent 知識層 SSoT：agent 讀寫，夏哥主要輸入。不是產品資料庫。

上下文工程：Tier 0~3 分層載入，避免常載憲法過肥。

👉 研究流程

NLM 建 notebook → imported sources → 有憑有據深度研究
研究完 → 寫入 Obsidian 25-Concepts / 30-Resources
網頁只放 pointer，不放常識正文（解 Sync Debt）

證據：NLM notebook 518ab896（44+ sources）；vault 4563 note、SSoT audit script

👈 #4 專案產線 · 四方矩陣

五步產線（每個新專案照走）：

① project folder
② github repo (private)
③ obsidian 專案 note
④ virtual host（CF Pages / VPS / Vercel）
⑤ 其他（NLM / checkpoint / HITL）

👉 已驗證案例

b.nqio.dev 已照此執行 ①②③：

folder：~/Documents/b-nqio
repo：xysb-lab/b-nqio (private)
obsidian：20-Projects/b.nqio.dev.md
host：待 CF Pages

證據：README.md 產線五步；gh CLI 確認 xysb-lab org

👈 #5 開發執行 · 五行環扣

Anthropic 最佳實踐（NLM 研究帶回）：

Planner：一句話 → 完整 spec（不過早定技術細節）
Generator：一次一個 feature
Evaluator：獨立評分、真的點開 app 測
Spec-Driven：先定義預期行為，嚴禁先寫後補

👉 Harness 三層

brain / hands / session 分離：

brain：策略決策層（誰是 agent、管什麼）
hands：執行層（跑指令、寫檔）
session：對話/上下文生命週期
Manager：long-running app 用 Planner/Generator/Evaluator

證據：Anthropic Engineering blog（NLM notebook 518ab896）；THE LINE 三層架構

👈 #6 驗收品質 · 六維行動

夏哥「不看 code 核准」：

證據鏈驗收包：影片 / 截圖 / 覆蓋率 / 安全掃描 → PR
夏哥只看證據包一鍵核准，不用看 code
獨立 reviewer：producer 不得自評 PASS
測試閘、lint、斷路器（3 次失敗即凍結）

👉 反欺騙核心

EVIDENCE 原則：

檔案存在 / build pass / HTTP 200 ≠ 完成
宣稱 done 前用外部證據驗「使用者可見 / 目的達成」
產出者 ≠ 評分者，跨模型審

證據：FLOOR.md EVIDENCE 段落；corrections.md 案例 D1-D12

👈 #7 發布營運 · 七政規律

上架 / 接案 / SaaS 差異：

host 選擇：CF Pages / VPS / Vercel 依專案型態
版本與回滾：git tag、wrangler 部署慣例
對外發布 = 夏哥硬閘（HARD_GATE）

👉 部署慣例

既有範例：

taxi.nqio.dev → 2026-Taxi repo（wrangler.toml name="2026-taxi"）
all.nqio.dev → fleet-navigator repo
hitl.superportia.dev → HRS registry + portal

證據：wrangler.toml 部署慣例；xysb-lab org 所有 repo

👈 #8 迭代學習 · 八卦演化

方法論自身也在演化：

M4 Pilot：選一專案試行 SOP v1
回饋 → SOP v2：pilot 學到的痛點回寫
週期 NLM 更新：研究持續追最新最佳實踐
健康指標：孤兒率、frontmatter、Base 數

👉 成長閉環

每週紀錄：

Pain Points / Root Cause / Countermeasure / Growth Signals / Owners
週週用證據回答「痛點被解決」與「成長有進步」
global harness 固化 → solidify-global-harness.sh

證據：agent-harness-weekly.sh --write；global harness 底盤

📋 行動計畫 · 可勾選追蹤：0/0 ↺ 重置

b.nqio.dev · Bible 公司方法論聖經 · 數據來源：NLM 深度研究 + Obsidian SSoT