常見問答
瞭解 DahTahDoc 如何讓 Spec、版本差異與 QA 測試案例保持對齊
DahTahDoc 是給小型軟體團隊使用的可追溯 Spec-to-QA 交付平台。它不是單純的文件編輯器,而是把規格文件、版本差異、引用脈絡與 QA 測試案例串在一起,讓 PM、SA、工程與 QA 能針對同一份交付基準討論。
DahTahDoc 目前仍處於 Alpha 預覽階段,主要用來驗證 Spec-to-QA、版本差異、雙向錨點與 QA 交付追蹤等核心概念。功能、介面與流程仍可能調整,目前不應視為成熟商業產品或完整測試管理平台。
Notion 與 Confluence 很適合整理知識庫、會議紀錄與一般團隊文件;DahTahDoc 則更聚焦在軟體交付文件。它把 Spec 發布、版本 diff、雙向錨點、QA 測試案例與更新提醒放在同一條鏈路上,讓需求不是「寫完就放進知識庫」,而是能一路追到後續測試與交付。
Jira 更適合管理 issue、sprint 與工程任務;TestRail 這類工具更適合大型測試計畫與測試執行管理。DahTahDoc 不是要取代它們,而是補上小型軟體團隊最常斷掉的前段交接:Spec 寫完、改版後,QA 如何知道哪些測試案例要建立或更新。若團隊已經有 Jira 或 TestRail,DahTahDoc 可以作為需求與測試交接的上游脈絡。
如果團隊只是需要整理內部知識,一般文件工具通常就足夠。若你的痛點是 Spec 改版後 QA 不知道改了哪裡、測試案例和需求分散在文件與試算表、交付靠人工記憶提醒,DahTahDoc 會更適合。它特別適合 PM、SA、工程與 QA 人數不多,但仍需要讓需求、版本差異與測試案例保持對齊的小型軟體團隊。
Spec-to-QA 是 DahTahDoc 的核心流程:當 Project 內的 Spec 發布時,系統可以建立一份 linked QA 測試案例文件;之後同一份 Spec 再次發布,系統不會建立第二份 QA 文件,而是把 Spec 更新提醒送進既有 QA 文件,讓測試人員知道哪些案例可能需要檢查。
雙向錨點可以把不同文件或段落連在一起。例如一段需求可以連到設計說明、技術決策、外部資源或 QA 測試內容。讀者不只能從來源跳到目標,也能從目標反向看到自己被哪些內容引用,建立可追溯的交付脈絡。
不會。DahTahDoc 會把穩定的 QA 文件前置資訊交給範本處理,例如測試範圍、狀態定義、測試環境與中止/再繼續準則;LLM 只負責協助產生測試案例內容。測試統計與實際結果不會由 AI 憑空產生,仍需要 QA 依照實際執行狀態維護。
會。DahTahDoc 目前把 AI 預設指令分成一般文件、Spec 與 QA 文件三種。一般文件偏向整理、改寫與補充內容;Spec 文件偏向需求、流程、規則與技術細節;QA 文件則偏向測試案例產出。個別文件仍可以在 toolbar 的文件 AI 指令中覆寫。
不是。Role Review 只會在可編輯的 Spec 文件中出現,目的是讓 SA 或 PM 快速看到 PM、SA、前端、後端、QA、Designer 可能會問的問題或注意事項。它只讀目前文件內容,不會讀整個 Project、外部資源、分割視窗文件、留言或連結,也不會給分、判斷通過、自動建立留言或自動建立 QA。結果可能不完整或不正確,仍需要人工判斷。
不會。Spec 變更落點只會在可編輯的 Project Spec 出現。使用者先描述想新增或修改的內容,或從單則留言明確帶入變更描述後,AI 才會根據目前這份 Spec 提醒可能要改的地方、可能新增的內容、QA 補測方向與需要先問清楚的問題。它不讀整個 Project、QA 文件、所有留言、anchor、links、外部資源或版本歷史,也不會自動修改 Spec、建立留言、建立 QA 或保存結果。
不會。Reader Brief 只會出現在已發布的 Spec 版本中,由有編輯權限的人主動使用自己的 AI API Key 產生或重新產生。Viewer 只能查看已保存的摘要,不會觸發 AI,也不會消耗 token。摘要只讀該發布版本內容,不讀留言、外部資源、關聯文件或整個 Project,Spec 原文仍是唯一依據。
不會。資料夾 AI 問答只會根據目前資料夾內可見且未刪除的文件回答,並列出來源文件。它不會讀其他資料夾、整個 Project、外部資源、留言或 trash;進入問答頁不會消耗 token,只有送出問題才會呼叫您設定的 AI provider。每位使用者會保留自己在該資料夾的問答紀錄,可以重新提問先前問題,也可以只清除自己的保存紀錄。舊回答會保存當時的來源文件資訊,以便在文件更新或刪除後提示可能過期。
是的,DahTahDoc 會儲存您的 API Key,但不會把已保存的原始金鑰回傳瀏覽器: • 儲存位置:金鑰透過 HTTPS 傳輸後,儲存在 Supabase 雲端資料庫,並受到 Row Level Security (RLS) 與帳號權限保護。 • 永不回傳前端:金鑰儲存後不會再傳回瀏覽器。系統只回傳「是否已設定」的狀態。 • 僅限伺服器流程使用:每次呼叫 AI 功能時,DahTahDoc 的已驗證伺服器 API 會讀取您的金鑰並呼叫您選擇的 AI 提供商,金鑰不會出現在瀏覽器網路請求中。 ⚠️ 安全建議:強烈建議您在 API 供應商的控制台為金鑰設定每日或每月用量上限。
是的。DahTahDoc 採用 Yjs CRDT 技術支援即時協作。PM、SA、工程與 QA 可以在同一份文件中共同編輯與檢視內容,避免用多份檔案來回覆蓋。
可以。DahTahDoc 內建版本發布與 diff preview。您可以命名並發布正式版本,之後用唯讀差異檢視確認這次改了什麼;QA 也可以從更新提醒另開 diff,保留原本測試案例文件的工作脈絡。
可以。您可以邀請成員並設定檢視或編輯權限。Project 文件也會依照 Project 成員角色管理存取,適合把同一個開發目標下的 Spec、QA 文件與外部資源放在同一個工作空間。
可以。DahTahDoc 目前支援匯出 Microsoft Word (.docx)、PDF 以及 Markdown (.md),方便交付給客戶、團隊或留存正式文件。
不需要。DahTahDoc 是 Web 平台,只要透過瀏覽器登入即可使用。桌機適合完整編輯與協作,手機和平板則適合瀏覽、查閱與追蹤文件狀態。
是的。DahTahDoc 內建 SA 規格範本與 QA 測試文件前置資訊範本。SA 可以快速建立規格骨架,QA 文件也能保留一致的測試範圍、準則、環境與統計區塊。使用者也可以把常用文件骨架保存成個人自定義範本,在 Template Picker 的 My Templates 中重複使用。