建Brief，讓AI開發(fā)不跑題)
【免費下載鏈接】three-man-teamA structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.項目地址https://gitcode.com/gh_mirrors/th/three-man-team點擊查看免費下載用 AI 寫代碼時有沒有遇到過這種情況AI 默默加了沒人要的功能、做到一半突然跑題、或者反復(fù)重讀文件浪費 tokenthree-man-team是一個由 Architect架構(gòu)師、Builder構(gòu)建者、Reviewer評審者組成的三角色 AI 開發(fā)團隊框架源于真實生產(chǎn)環(huán)境的打磨。本文是角色拆解系列的第一篇帶你拆解 Architect 如何寫出零歧義的構(gòu)建 Brief讓 AI 開發(fā)不跑題、不超支。為什么 AI 開發(fā)總?cè)菀着茴}大多數(shù) AI 編碼工具的問題是有能力但沒紀(jì)律明明只需要一個函數(shù)它去讀整個代碼庫順手加功能沒人要求的也寫上任務(wù)中途漂移做著做著方向就變了每次會話都燒 token 做不必要的工作three-man-team 給出的答案不是更好的提示詞而是一套流程三個角色、明確的交接文件、防止最昂貴失敗模式的規(guī)則。三角色默認名字是Arch架構(gòu)師、Bob構(gòu)建者、Richard評審者安裝時可自由改名。其中 Architect 是整個團隊的固定點——方向不清時大家都看它。它的設(shè)定見 ARCHITECT.md。Architect 的三大職責(zé)先對齊再開工在 ARCHITECT.md 中Arch 的職責(zé)被清晰地分為三件事和項目負責(zé)人對話——先判斷問題是產(chǎn)品缺口還是代碼缺口描述代碼當(dāng)前行為讓對方確認是否符合預(yù)期再給出修復(fù)建議指揮 Bob 和 Richard——寫 Brief、啟動 Builder、完成后再啟動 Reviewer全程鎖定范圍擁有部署權(quán)——沒有 Arch 的確認和項目負責(zé)人的許可任何東西都不上生產(chǎn)這套設(shè)計背后的研究思路寫在 METHODOLOGY.md 里給 AI 一個人設(shè)背景故事、價值觀、聲音比一句你是架構(gòu)師能激活更精準(zhǔn)的行為模式。零歧義 Brief 怎么寫看懂這份模板Brief 不是聊天而是一份寫入handoff/ARCHITECT-BRIEF.md的結(jié)構(gòu)化文件。每步覆蓋重寫它不是日志而是當(dāng)前生效的構(gòu)建指令。模板見 ARCHITECT-BRIEF.md。一份合格的 Brief 由四個板塊組成一個都不能少## Step N — [要構(gòu)建什么] ### Decisions - [決策或約束只寫決定不寫散文] ### Build Order 1. [先構(gòu)建什么] ### Flags - Flag: [Builder 不允許猜的任何事] ### Definition of Done - [ ] [可驗證的完成標(biāo)準(zhǔn)]四個板塊各自消滅一類歧義Decisions只寫決策和約束。用框架內(nèi)置校驗器不要自己寫正則就是一句決策省掉 Builder 一次錯誤嘗試Build Order構(gòu)建順序明確避免 Builder 自己發(fā)明一個順序Flags這是靈魂板塊——Builder 不能猜的東西全部顯式聲明。AI 跑題的根源往往是替人做決定Flag 直接掐斷這個空間?Definition of Done完成標(biāo)準(zhǔn)必須可驗證。做好郵件校驗是模糊的服務(wù)端返回的錯誤格式與現(xiàn)有錯誤一致是可檢查的一個完整 Sprint從需求到部署看完模板用官方示例 sprint-walkthrough.md 走一遍完整流程。項目負責(zé)人提出注冊表單的服務(wù)端沒有校驗郵箱格式只有 JS 前端校驗。 Arch 讀相關(guān)文件、確認缺口、對齊方案后寫出 Step 12 的 Brief## Step 12 — 注冊流程的服務(wù)端郵箱校驗 - 注冊處理器中增加服務(wù)端郵箱格式校驗 - 在數(shù)據(jù)清洗之后、寫入數(shù)據(jù)庫之前校驗 - 返回的錯誤信息與現(xiàn)有錯誤格式保持一致 - JS 校驗已存在 —— 不要修改它 - Flag: 使用框架內(nèi)置校驗器不要用自定義正則注意 Brief 里的每一條都對應(yīng)一個具體動作或禁令Builder 拿到手不需要做任何理解意圖的工作。隨后流程嚴格沿著工作流走Bob 讀完 Brief 先報計劃、得到確認才動代碼Richard 按 REVIEWER.md 對照 Brief 逐條核對揪出錯誤信息不可翻譯的問題打回Bob 修完復(fù)審?fù)ㄟ^最后由 Arch 部署并更新日志。沒有任何一步被跳過。為什么文件交接既省 token 又不跑題three-man-team 的 agent 之間不用對話溝通而是通過結(jié)構(gòu)化文件交接詳見 how-it-works.mdArchitect 寫ARCHITECT-BRIEF.mdBuilder 寫REVIEW-REQUEST.mdReviewer 寫REVIEW-FEEDBACK.md這意味著每個角色都以干凈的上下文啟動只讀自己崗位需要的文件Builder 永遠不加載完整項目規(guī)格Reviewer 永遠不加載數(shù)據(jù)庫 schema。token 浪費從行為問題變成結(jié)構(gòu)問題——結(jié)構(gòu)對了行為自然對。配合每次會話自動加載的 token 規(guī)則見 CLAUDE.md 與 token-optimization.md紀(jì)律是內(nèi)建在基礎(chǔ)設(shè)施里的?？焖偕鲜秩阶?Arch 開始寫 Briefgit clone https://gitcode.com/gh_mirrors/th/three-man-team.git .claude/skills/three-man-team cd .claude/skills/three-man-team ./setupsetup 會接管后續(xù)步驟并給出精確指令。每個項目使用團隊時的啟動提示詞整理在 session-start.md首次會話只需要一句You are the Architect on this project. Please read new-setup.md.Arch 會自動完成項目上下文文件、團隊命名和首次會話提示詞的搭建。本篇小結(jié) 跑題的根源不是模型能力而是缺乏結(jié)構(gòu)和交接紀(jì)律Architect 的零歧義 Brief 四板塊模板Decisions / Build Order / Flags / Definition of Done其中Flags不許猜的清單 可驗證的完成標(biāo)準(zhǔn)是讓 AI 開發(fā)不跑題的關(guān)鍵文件交接 token 規(guī)則讓流程既是質(zhì)量保障也是成本保障下一篇角色拆解將繼續(xù)拆解BobBuilder 如何嚴格執(zhí)行 Brief敬請期待。贊分享【免費下載鏈接】three-man-teamA structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.項目地址https://gitcode.com/gh_mirrors/th/three-man-team點擊查看免費下載相關(guān)推薦three-man-team角色拆解③Reviewer三級反饋機制如何守住代碼質(zhì)量最后一道門three man team角色拆解③Reviewer三級反饋機制如何守住代碼質(zhì)量最后一道門 three man team 是一個由 Architect架構(gòu)AI開發(fā)團隊框架three-man-team完整指南Architect、Builder、Reviewer三人協(xié)作如何重塑你的AI編程流程AI開發(fā)團隊框架three man team完整指南Architect、Builder、Reviewer三人協(xié)作如何重塑你的AI編程流程 你是否遇到過這樣的困Android 手勢檢測實戰(zhàn)基于 GestureDetector 捕獲與識別常用觸摸手勢android-training-course-in-chinese 課程解讀Android 手勢檢測實戰(zhàn)基于 GestureDetector 捕獲與識別常用觸摸手勢android training course in chinese上一篇如何利用Siddhi實現(xiàn)實時數(shù)據(jù)處理5個核心功能解析與實戰(zhàn)下一篇Win11Debloat免費可回滾的 Windows 11 去臃腫與隱私清理完整指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 three-man-team角色拆解①：Architect如何寫出零歧義的構(gòu)建Brief，讓AI開發(fā)不跑題
【免費下載鏈接】three-man-teamA structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.項目地址https://gitcode.com/gh_mirrors/th/three-man-team點擊查看免費下載用 AI 寫代碼時有沒有遇到過這種情況AI 默默加了沒人要的功能、做到一半突然跑題、或者反復(fù)重讀文件浪費 tokenthree-man-team是一個由 Architect架構(gòu)師、Builder構(gòu)建者、Reviewer評審者組成的三角色 AI 開發(fā)團隊框架源于真實生產(chǎn)環(huán)境的打磨。本文是角色拆解系列的第一篇帶你拆解 Architect 如何寫出零歧義的構(gòu)建 Brief讓 AI 開發(fā)不跑題、不超支。為什么 AI 開發(fā)總?cè)菀着茴}大多數(shù) AI 編碼工具的問題是有能力但沒紀(jì)律明明只需要一個函數(shù)它去讀整個代碼庫順手加功能沒人要求的也寫上任務(wù)中途漂移做著做著方向就變了每次會話都燒 token 做不必要的工作three-man-team 給出的答案不是更好的提示詞而是一套流程三個角色、明確的交接文件、防止最昂貴失敗模式的規(guī)則。三角色默認名字是Arch架構(gòu)師、Bob構(gòu)建者、Richard評審者安裝時可自由改名。其中 Architect 是整個團隊的固定點——方向不清時大家都看它。它的設(shè)定見 ARCHITECT.md。Architect 的三大職責(zé)先對齊再開工在 ARCHITECT.md 中Arch 的職責(zé)被清晰地分為三件事和項目負責(zé)人對話——先判斷問題是產(chǎn)品缺口還是代碼缺口描述代碼當(dāng)前行為讓對方確認是否符合預(yù)期再給出修復(fù)建議指揮 Bob 和 Richard——寫 Brief、啟動 Builder、完成后再啟動 Reviewer全程鎖定范圍擁有部署權(quán)——沒有 Arch 的確認和項目負責(zé)人的許可任何東西都不上生產(chǎn)這套設(shè)計背后的研究思路寫在 METHODOLOGY.md 里給 AI 一個人設(shè)背景故事、價值觀、聲音比一句你是架構(gòu)師能激活更精準(zhǔn)的行為模式。零歧義 Brief 怎么寫看懂這份模板Brief 不是聊天而是一份寫入handoff/ARCHITECT-BRIEF.md的結(jié)構(gòu)化文件。每步覆蓋重寫它不是日志而是當(dāng)前生效的構(gòu)建指令。模板見 ARCHITECT-BRIEF.md。一份合格的 Brief 由四個板塊組成一個都不能少## Step N — [要構(gòu)建什么] ### Decisions - [決策或約束只寫決定不寫散文] ### Build Order 1. [先構(gòu)建什么] ### Flags - Flag: [Builder 不允許猜的任何事] ### Definition of Done - [ ] [可驗證的完成標(biāo)準(zhǔn)]四個板塊各自消滅一類歧義Decisions只寫決策和約束。用框架內(nèi)置校驗器不要自己寫正則就是一句決策省掉 Builder 一次錯誤嘗試Build Order構(gòu)建順序明確避免 Builder 自己發(fā)明一個順序Flags這是靈魂板塊——Builder 不能猜的東西全部顯式聲明。AI 跑題的根源往往是替人做決定Flag 直接掐斷這個空間?Definition of Done完成標(biāo)準(zhǔn)必須可驗證。做好郵件校驗是模糊的服務(wù)端返回的錯誤格式與現(xiàn)有錯誤一致是可檢查的一個完整 Sprint從需求到部署看完模板用官方示例 sprint-walkthrough.md 走一遍完整流程。項目負責(zé)人提出注冊表單的服務(wù)端沒有校驗郵箱格式只有 JS 前端校驗。 Arch 讀相關(guān)文件、確認缺口、對齊方案后寫出 Step 12 的 Brief## Step 12 — 注冊流程的服務(wù)端郵箱校驗 - 注冊處理器中增加服務(wù)端郵箱格式校驗 - 在數(shù)據(jù)清洗之后、寫入數(shù)據(jù)庫之前校驗 - 返回的錯誤信息與現(xiàn)有錯誤格式保持一致 - JS 校驗已存在 —— 不要修改它 - Flag: 使用框架內(nèi)置校驗器不要用自定義正則注意 Brief 里的每一條都對應(yīng)一個具體動作或禁令Builder 拿到手不需要做任何理解意圖的工作。隨后流程嚴格沿著工作流走Bob 讀完 Brief 先報計劃、得到確認才動代碼Richard 按 REVIEWER.md 對照 Brief 逐條核對揪出錯誤信息不可翻譯的問題打回Bob 修完復(fù)審?fù)ㄟ^最后由 Arch 部署并更新日志。沒有任何一步被跳過。為什么文件交接既省 token 又不跑題three-man-team 的 agent 之間不用對話溝通而是通過結(jié)構(gòu)化文件交接詳見 how-it-works.mdArchitect 寫ARCHITECT-BRIEF.mdBuilder 寫REVIEW-REQUEST.mdReviewer 寫REVIEW-FEEDBACK.md這意味著每個角色都以干凈的上下文啟動只讀自己崗位需要的文件Builder 永遠不加載完整項目規(guī)格Reviewer 永遠不加載數(shù)據(jù)庫 schema。token 浪費從行為問題變成結(jié)構(gòu)問題——結(jié)構(gòu)對了行為自然對。配合每次會話自動加載的 token 規(guī)則見 CLAUDE.md 與 token-optimization.md紀(jì)律是內(nèi)建在基礎(chǔ)設(shè)施里的?？焖偕鲜秩阶?Arch 開始寫 Briefgit clone https://gitcode.com/gh_mirrors/th/three-man-team.git .claude/skills/three-man-team cd .claude/skills/three-man-team ./setupsetup 會接管后續(xù)步驟并給出精確指令。每個項目使用團隊時的啟動提示詞整理在 session-start.md首次會話只需要一句You are the Architect on this project. Please read new-setup.md.Arch 會自動完成項目上下文文件、團隊命名和首次會話提示詞的搭建。本篇小結(jié) 跑題的根源不是模型能力而是缺乏結(jié)構(gòu)和交接紀(jì)律Architect 的零歧義 Brief 四板塊模板Decisions / Build Order / Flags / Definition of Done其中Flags不許猜的清單 可驗證的完成標(biāo)準(zhǔn)是讓 AI 開發(fā)不跑題的關(guān)鍵文件交接 token 規(guī)則讓流程既是質(zhì)量保障也是成本保障下一篇角色拆解將繼續(xù)拆解BobBuilder 如何嚴格執(zhí)行 Brief敬請期待。贊分享【免費下載鏈接】three-man-teamA structured 3-agent AI dev team — Architect, Builder, Reviewer. Built from production use. Token-optimized. Works with Claude Code, VS Code, Cursor, and any AI that supports context files.項目地址https://gitcode.com/gh_mirrors/th/three-man-team點擊查看免費下載相關(guān)推薦three-man-team角色拆解③Reviewer三級反饋機制如何守住代碼質(zhì)量最后一道門three man team角色拆解③Reviewer三級反饋機制如何守住代碼質(zhì)量最后一道門 three man team 是一個由 Architect架構(gòu)AI開發(fā)團隊框架three-man-team完整指南Architect、Builder、Reviewer三人協(xié)作如何重塑你的AI編程流程AI開發(fā)團隊框架three man team完整指南Architect、Builder、Reviewer三人協(xié)作如何重塑你的AI編程流程 你是否遇到過這樣的困Android 手勢檢測實戰(zhàn)基于 GestureDetector 捕獲與識別常用觸摸手勢android-training-course-in-chinese 課程解讀Android 手勢檢測實戰(zhàn)基于 GestureDetector 捕獲與識別常用觸摸手勢android training course in chinese上一篇如何利用Siddhi實現(xiàn)實時數(shù)據(jù)處理5個核心功能解析與實戰(zhàn)下一篇Win11Debloat免費可回滾的 Windows 11 去臃腫與隱私清理完整指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考