Conductor Setup 命令深度解析用交互式問答初始化 Claude Code 的上下文驅(qū)動開發(fā)項目【免費下載鏈接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity項目地址: https://gitcode.com/GitHub_Trending/agents24/agentsConductor 是 Claude Code 生態(tài)中的“上下文驅(qū)動開發(fā)”Context-Driven Development插件核心流程為Context → Spec Plan → Implement。本篇聚焦其中最關(guān)鍵的第一步setup命令即本倉庫 plugins/conductor/commands/setup.md 定義的 conductor:setup它通過一套高度可中斷、可恢復(fù)的交互式問答把“產(chǎn)品愿景、產(chǎn)品準(zhǔn)則、技術(shù)棧、工作流、代碼風(fēng)格指南”沉淀為項目根目錄conductor/下的結(jié)構(gòu)化文檔為后續(xù) new-track、implement、revert 等命令奠定一致的上下文基礎(chǔ)。讀完本篇你將掌握 setup 命令的完整執(zhí)行協(xié)議預(yù)檢、五段式問答、產(chǎn)物生成、狀態(tài)管理、續(xù)跑與容錯并能將它與倉庫內(nèi)templates/模板一一對應(yīng)用于實際項目初始化。一、Setup 在整個 Conductor 工作流中的定位先看全景本倉庫的 conductor/README.md 將 Conductor 定義為一套把 Claude Code “變成項目管理工具”的機制其核心哲學(xué)是把上下文當(dāng)作和代碼并列的一等管理資產(chǎn)Product vision產(chǎn)品愿景作為活的文檔Technical decisions技術(shù)決策作為結(jié)構(gòu)化產(chǎn)物Work units / tracks工作單元攜帶 spec 與分階段 planTDD workflow 帶驗證檢查點/conductor:setup處于流水線最前端——在創(chuàng)建任何 track功能/缺陷/chore/重構(gòu)之前必須先完成它。倉庫命令家族的關(guān)系如下表命令職責(zé)是否依賴 setup 產(chǎn)物/conductor:setup初始化項目上下文文檔無自身創(chuàng)建/conductor:new-track創(chuàng)建 track 的 spec.md 與 plan.md是需先校驗 product.md / tech-stack.md / workflow.md 存在見 new-track.md 的 Pre-flight Checks/conductor:implement按 plan 執(zhí)行任務(wù)是/conductor:status展示項目進度是/conductor:revert按 track/phase/task 做 Git 語義回滾是/conductor:managetrack 生命周期管理是new-track.md里的 Pre-flight 校驗邏輯可以反向印證 setup 的產(chǎn)出標(biāo)準(zhǔn)它檢查conductor/product.md、conductor/tech-stack.md、conductor/workflow.md是否存在任一缺失就提示先運行 setup。因此 setup 生成的三份“上下文文檔”是整條 Conductor 工作鏈的事實前提。二、Setup 生成的目錄結(jié)構(gòu)與產(chǎn)物全覽完成 setup 后會在項目根目錄生成conductor/文件夾。README 中的產(chǎn)物樹給出了最終目標(biāo)形態(tài)conductor/ ├── index.md # 導(dǎo)航中心 ├── product.md # 產(chǎn)品愿景與目標(biāo) ├── product-guidelines.md # 準(zhǔn)則與信息傳達(dá) ├── tech-stack.md # 技術(shù)偏好 ├── workflow.md # 開發(fā)實踐TDD、提交規(guī)范 ├── tracks.md # track 總注冊表 ├── setup_state.json # 可續(xù)跑的狀態(tài)文件 ├── code_styleguides/ # 各語言約定 └── tracks/ ├── _archive/ # 已歸檔 track └── track-id/ ├── spec.md ├── plan.md ├── metadata.json └── index.md其中tracks/及其子文件由后續(xù)的new-track創(chuàng)建setup 本身聚焦于上層七類產(chǎn)物的生成具體見下文“產(chǎn)物生成”一節(jié)。三、Pre-flight Checks進入問答前的三次判定setup.md 明確要求在任何提問之前完成三項預(yù)檢其順序與語義如下1. 檢測 conductor/ 是否已存在決定 reinitialize 還是 resume若conductor/product.md已存在詢問用戶是恢復(fù)resume還是重新初始化reinitialize若conductor/setup_state.json存在且狀態(tài)為 incomplete主動提議從上次步驟繼續(xù)。這套邏輯與文檔中 Resume Handling 一節(jié)相互呼應(yīng)setup命令天然支持--resume參數(shù)見文件頭部 frontmatter 的argument-hint: [--resume]允許用戶在多次會話之間分段完成初始化。2. 探測項目類型決定問答策略通過檢查以下任一“項目已存在”的信號區(qū)分兩種模式Greenfield全新項目當(dāng)前目錄沒有.git、package.json、requirements.txt、go.mod、src/等任何痕跡Brownfield已有項目上述任一信號存在。該判定會直接影響 Tech Stack 問答環(huán)節(jié)brownfield 項目會先用Glob掃描并解析包清單文件預(yù)填技術(shù)棧后請用戶確認(rèn)而 greenfield 則從零開始選擇。3. 加載或創(chuàng)建 setup_state.json這是 setup 可續(xù)跑能力的落點。文件的標(biāo)準(zhǔn)形態(tài)為{ status: in_progress, project_type: greenfield|brownfield, current_section: product|guidelines|tech_stack|workflow|styleguides, current_question: 1, completed_sections: [], answers: {}, files_created: [], started_at: ISO_TIMESTAMP, last_updated: ISO_TIMESTAMP }字段職責(zé)可概括為status標(biāo)記整體進度in_progress / completeproject_type固化預(yù)檢結(jié)果current_sectioncurrent_question精確記錄中斷位置completed_sections、files_created分別用于跳過已完成段落與校驗產(chǎn)物是否落盤answers暫存原始回答供模板填充時回讀。四、交互式問答協(xié)議每節(jié)一個話題、逐問推進setup.md 強調(diào)五條CRITICAL RULES是整套問答的紀(jì)律紅線每輪只問一個問題等待用戶回答后再繼續(xù)每個問題提供23 個建議答案外加“Type your own”自定義選項每個 Section 最多 5 個問題每成功一步就更新setup_state.json只有確認(rèn)文件寫入成功后才繼續(xù)下一步。問答被劃分為五個 Section覆蓋從“做什么”到“怎么做”的完整決策鏈。各節(jié)的規(guī)模上限和關(guān)注點匯總?cè)缦隆ection名稱問題上限覆蓋主題1Product Definition5項目名、一句話描述、要解決的問題、目標(biāo)用戶、關(guān)鍵目標(biāo)可選2Product Guidelines3語氣/口吻、設(shè)計原則3Tech Stack5主語言、前端框架、后端框架、數(shù)據(jù)庫、基礎(chǔ)設(shè)施4Workflow Preferences4TDD 嚴(yán)格度、提交策略、代碼評審、人工驗證檢查點5Code Style Guides2需要生成哪些語言指南、是否吸收既有 lint/format 配置Section 1Product Definition產(chǎn)品定義最多 5 問Q1 項目名建議從目錄名推斷greenfield或從package.json/go.mod推斷brownfieldQ2 項目描述一句話說清項目是什么Q3 問題陳述項目要解決什么問題、用戶的痛點Q4 目標(biāo)用戶誰是最主要的使用者Q5 關(guān)鍵目標(biāo)可選寫下 23 個關(guān)鍵目標(biāo)允許直接回車跳過。該節(jié)回答將直接填充product.md模板詳見 templates/product.md中的產(chǎn)品名、標(biāo)簽行、詳細(xì)描述、問題陳述、目標(biāo)用戶、核心價值主張等占位符。Section 2Product Guidelines產(chǎn)品準(zhǔn)則最多 3 問Q1 語氣與口吻建議項包括 Professional and technical / Friendly and approachable / Concise and directQ2 設(shè)計原則建議項包括 Simplicity over features / Performance first / Developer experience focused / User safety and reliability自定義可逗號分隔多選。對應(yīng)模板 templates/product-guidelines.md 里不止有 Brand Voice 與 Design Principles還預(yù)置了各上下文的語氣變化表、可訪問性標(biāo)準(zhǔn)WCAG 2.1 AA 及四大原則清單與錯誤處理哲學(xué)。Setup 問答取得的高層偏好正是這些章節(jié)的錨點。Section 3Tech Stack技術(shù)棧最多 5 問Brownfield 分支先執(zhí)行Glob找出package.json、requirements.txt、go.mod、Cargo.toml等清單文件解析后預(yù)填技術(shù)棧再用類似 “I detected: Python 3.11, JavaScript. Is this correct?” 的方式請用戶確認(rèn)或增補。隨后五問依次為Q1 主語言建議 TypeScript / Python / Go / Rust可逗號分隔多選Q2 前端框架React / Vue / Next.js / None·CLI onlyQ3 后端框架Express·Fastify / Django·FastAPI / Go 標(biāo)準(zhǔn)庫 / None·Frontend onlyQ4 數(shù)據(jù)庫PostgreSQL / MongoDB / SQLite / None·StatelessQ5 基礎(chǔ)設(shè)施AWS Lambda·ECS / Vercel·Netlify / Self-hosted·Docker / Not decided yet。生成目標(biāo)模板 templates/tech-stack.md 是一個相當(dāng)完整的《Technology Stack》文檔除語言/框架/數(shù)據(jù)庫/托管外還包括狀態(tài)管理、樣式方案、CI/CD 流水線階段、監(jiān)控三件套APM/Logging/Alerting、開發(fā)工具包管理器、測試、lint/format、Decision Log 決策日志與版本兼容矩陣適合長期演進時持續(xù)維護。Section 4Workflow Preferences工作流偏好最多 4 問Q1 TDD 嚴(yán)格度Strict實現(xiàn)前必須寫測試/ Moderate鼓勵不阻塞/ Flexible僅復(fù)雜邏輯建議測試Q2 提交策略Conventional Commitsfeat:/fix: 等/ 自由描述式 / 每任務(wù) squashQ3 代碼評審所有變更必須評審 / 非平凡變更需評審 / 可選·允許自審Q4 人工驗證檢查點每個 phase 完成后 / 每個 task 完成后 / 僅在 track 完成時。這些回答決定 templates/workflow.md 中“任務(wù)生命周期”的執(zhí)行方式——該模板把 TDD 拆成 Red先寫失敗測試→ Green最小實現(xiàn)通過→ Refactor 三步并定義了[ ] → [~] → [x]的狀態(tài)標(biāo)記、80% 覆蓋率閾值、checkpoint 提交格式[track-id] checkpoint: phase N complete以及 8 項質(zhì)量門禁Tests / Coverage / Style / Docs / Types / Linting / Mobile / Security。Workflow 問答應(yīng)答得越具體模板中被{{TEST_COMMAND}}、{{COVERAGE_COMMAND}}這類占位符預(yù)留的命令位就越容易被真實填充。Section 5Code Style Guides代碼風(fēng)格最多 2 問Q1 生成哪些語言的指南根據(jù)已探測語言預(yù)選選項含 TypeScript/JavaScript、Python、Go、Rust、All detected languages、Skip style guidesQ2 是否吸收既有配置brownfield 場景如檢測到.eslintrc、.prettierrc會詢問 “I found .eslintrc, .prettierrc. Should I incorporate these?”可選 Yes·use existing configs / No·generate fresh guides / Skip。五、產(chǎn)物生成一份模板、七個文件的落地清單QA 全部完成后進入產(chǎn)物生成階段。setup.md 明確了七個目標(biāo)conductor/index.md— 導(dǎo)航中心。setup.md 給出了最簡結(jié)構(gòu)Quick Links 指向 product / product-guidelines / tech-stack / workflow / tracksActive Tracks 區(qū)域由/conductor:new-track自動填充并有“運行/conductor:new-track創(chuàng)建第一條 track”的引導(dǎo)而倉庫中的真實母版 templates/index.md 更為豐富包含核心文檔狀態(tài)表、風(fēng)格指南入口general/typescript/javascript/python/go/csharp/dart/html-css、Active Tracks 表、Recent Activity、Milestone Tracker 與 Commands Reference。conductor/product.md— 用模板填充 Q1Q5 的答案。注意 templates/product.md 不僅覆蓋“名稱/描述/問題/用戶/目標(biāo)”還預(yù)留了現(xiàn)有方案與差距分析、核心價值主張、成功指標(biāo)KPI 表、北極星指標(biāo)、先行/滯后指標(biāo)、Out of Scope明確不做、未來考慮、非目標(biāo)等更深的章節(jié)setup 可據(jù)回答深度決定填充多少。conductor/product-guidelines.md— 填充語氣口吻與設(shè)計原則見上文 Section 2。conductor/tech-stack.md— 填充語言帶探測到的版本、前后端框架、數(shù)據(jù)庫、基礎(chǔ)設(shè)施brownfield 還會納入從包清單解析出的關(guān)鍵依賴。conductor/workflow.md— 填充 TDD 政策、提交約定、評審要求、驗證檢查點與任務(wù)生命周期定義。conductor/tracks.md— track 注冊總表setup.md 提供的骨架是四列表Status / Track ID / Title / Created / Updated行數(shù)據(jù)由 new-track 追加真實模板 templates/tracks.md 還包含狀態(tài)圖例[ ]Pending、[~]In Progress、[x]Completed、Active/Completed/Archived 分區(qū)與 Track Creation Checklist。conductor/code_styleguides/— 從模板目錄復(fù)制所選語言的風(fēng)格指南。風(fēng)格指南模板的來源setup.md 指出風(fēng)格指南來源于$CLAUDE_PLUGIN_ROOT/templates/code_styleguides/。就本倉庫而言對應(yīng)目錄是 plugins/conductor/templates/code_styleguides/內(nèi)含八個指南文件general.md通用原則、typescript.md、javascript.md、python.md、go.md、csharp.md、dart.mdDart/Flutter、html-css.md與 index.md 模板中的風(fēng)格指南鏈接一一對應(yīng)。Setup 只復(fù)制與項目語言匹配的子集。六、狀態(tài)管理與“每步落盤”的可靠性設(shè)計setup.md 要求“每次成功創(chuàng)建文件后”執(zhí)行三件事更新setup_state.json把文件名追加進files_created、刷新last_updated時間戳、若整節(jié)完成則加入completed_sections用 Read 工具復(fù)核文件確實存在確認(rèn)成功后才繼續(xù)下一問題/下一節(jié)。這意味著 setup 是“寫完即校驗、校驗過才記賬”的流程而不是一口氣批量寫盤后再匯報為任意時刻的用戶取消、會話中斷做好了恢復(fù)鋪墊。這正對應(yīng) README Features 中State Persistence: Resume setup across multiple sessions的設(shè)計承諾。七、Completion正常收尾的確認(rèn)清單與摘要當(dāng)全部文件創(chuàng)建完成要求將setup_state.json的status置為complete向用戶展示完成摘要包括產(chǎn)物清單Conductor setup complete! Created artifacts: - conductor/index.md - conductor/product.md - conductor/product-guidelines.md - conductor/tech-stack.md - conductor/workflow.md - conductor/tracks.md - conductor/code_styleguides/[languages] Next steps: 1. Review generated files and customize as needed 2. Run /conductor:new-track to create your first track注意摘要把“運行new-track創(chuàng)建第一條 track”作為下一步動作與 Pre-flight 校驗形成閉環(huán)——setup 之后的第一件事永遠(yuǎn)是建 track。new-track 命令詳解可繼續(xù)閱讀倉庫中的 new-track.md。八、Resume 與 Error Handling中斷續(xù)跑與異常兜底Resume Handling支持--resume參數(shù)或狀態(tài)觸發(fā)加載setup_state.json跳過已完成的completed_sections從current_section與current_question精確續(xù)問校驗先前已創(chuàng)建的files_created文件是否仍存在若發(fā)現(xiàn)文件缺失主動提議重新生成。值得注意Resume 的“文件存在性復(fù)核”與正常流程中的“寫后 Read 復(fù)核”用的是同一套校驗手段說明 Conductor 把“文檔即狀態(tài)”與“狀態(tài)文件即指針”兩種視圖做了對賬避免狀態(tài)文件聲稱完成、磁盤文件卻丟失的不一致。Error Handling文件寫入失敗立即中止并上報錯誤不更新狀態(tài)——防止files_created記錄到不存在的文件用戶取消保存當(dāng)前狀態(tài)以便未來 resume——這是對“允許半途退出”的顯式背書狀態(tài)文件損壞詢問用戶“從頭開始”還是“嘗試從損壞狀態(tài)中恢復(fù)”。從源碼結(jié)構(gòu)看這些分支與前面setup_state.json的完整字段設(shè)計是一體兩面status、current_section/current_question、files_created、last_updated四個字段分別服務(wù)于錯誤定位、斷點續(xù)問、文件對賬與狀態(tài)新鮮度判斷共同把“交互式初始化”從一次性腳本升級為可長期維護的項目引導(dǎo)流程。九、最小實操指南在 Claude Code 中運行 setup結(jié)合倉庫 README 的安裝方式與 setup 命令語義實際使用路徑如下# 1. 安裝 Conductor 插件 /plugin install conductor # 2. 在項目根目錄啟動交互式初始化 /conductor:setup # 3. 若初始化中途被中斷在任意新會話中續(xù)跑 /conductor:setup --resume # 4. 初始化完成后創(chuàng)建第一條功能 track /conductor:new-track使用約束與前提setup 面向“項目根目錄”產(chǎn)物默認(rèn)落在根目錄的conductor/Greenfield 項目建議先執(zhí)行g(shù)it init再運行便于后續(xù)revert的 Git 語義Brownfield 項目會依賴倉庫已有的包清單文件做技術(shù)棧預(yù)探測。文中提到的status、current_section等字段的實際行為均以當(dāng)前倉庫 setup.md 與配套 templates 為唯一依據(jù)。十、小結(jié)Setup 解決的問題與后續(xù)延伸conductor:setup的實質(zhì)是在每次 AI 協(xié)作會話都要重新理解項目的世界里用一次結(jié)構(gòu)化的問答把“產(chǎn)品為何存在、按什么準(zhǔn)則說話、用什么技術(shù)、按什么流程寫代碼”固化成機器可復(fù)讀、人可審閱的上下文文檔。它帶來的直接收益有三上下文一致后續(xù) new-track、implement、status 不再需要用戶重復(fù)交代背景可中斷可恢復(fù)setup_state.json讓初始化可跨會話完成--resume與文件對賬機制保證斷點續(xù)跑的可靠性模板即資產(chǎn)從 index.md 到 workflow.md 的占位符模板既是生成依據(jù)也是后續(xù)人工迭代的起點。讀完本文后你可以順藤摸瓜繼續(xù)閱讀倉庫內(nèi) conductor 命令族 中new-track.md如何把 setup 產(chǎn)出的上下文轉(zhuǎn)化為 spec 與 plan與implement.md如何按 workflow.md 的紀(jì)律執(zhí)行任務(wù)完整掌握 Conductor 的 Context → Spec Plan → Implement 全鏈路。【免費下載鏈接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity項目地址: https://gitcode.com/GitHub_Trending/agents24/agents創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考