我最近把自己日常摸魚(yú)用的幾個(gè) AI 編程流程固化成了 10 個(gè)中文命令全部裝進(jìn)了 Claude Code 里。這些命令不是花架子而是把代碼審閱、日志分析、單元測(cè)試補(bǔ)全、提交信息生成這些高頻動(dòng)作封裝成了一條條可以直接調(diào)用的工作流。這篇文章就把整套工作流包的設(shè)計(jì)思路、每個(gè)命令的實(shí)際寫(xiě)法、踩過(guò)的坑和最后落地的效果完整拆開(kāi)適合那些正在折騰 AI 編程助手、想把手頭重復(fù)勞動(dòng)交給工具的朋友。標(biāo)題里說(shuō)“中文命令”重點(diǎn)不在于把英文翻譯成中文而在于命令的觸發(fā)詞、輸出風(fēng)格、交互邏輯都貼合中文開(kāi)發(fā)者的習(xí)慣。比如團(tuán)隊(duì)里同事寫(xiě)的注釋是中文要求代碼規(guī)范描述也是中文那 AI 審閱代碼時(shí)如果讓它用中文輸出問(wèn)題清單大家溝通成本會(huì)低很多。Claude Code 對(duì)命令的定義方式支持設(shè)置命令名和參數(shù)我實(shí)測(cè)下來(lái)中文命令名在/觸發(fā)時(shí)完全沒(méi)問(wèn)題直接在終端里敲/代碼審閱就能喚起。這套命令一共 10 個(gè)分別是代碼審閱、提交信息生成、重構(gòu)建議、日志分析、單元測(cè)試補(bǔ)全、接口調(diào)試、文檔生成、依賴(lài)梳理、問(wèn)題修復(fù)、項(xiàng)目狀態(tài)巡檢。下面逐個(gè)聊。1. 整體工作流包設(shè)計(jì)為什么需要一套“中文命令”1.1 中文命令不是什么“炫技”而是降低心智開(kāi)銷(xiāo)先說(shuō)個(gè)大實(shí)話命令本身不會(huì)讓 Claude 變聰明真正起作用的是命令背后那套提示詞和上下文管理策略。那為什么非要用中文命令名我以前用英文命令名不是不行但有幾個(gè)痛點(diǎn)。第一是遺忘成本。日常用到的命令如果超過(guò) 10 個(gè)英文名容易混。比如/code-review和/review-code看著差不多敲錯(cuò)就白搭。換成/代碼審閱之后每次調(diào)用之前腦子里不需要“中英文互譯”這一步直接敲中文幾乎沒(méi)有記錯(cuò)的可能。第二是團(tuán)隊(duì)協(xié)作。如果團(tuán)隊(duì)里有人不習(xí)慣英文交互比如做后端的老同事你跟他說(shuō)“你敲一下 /commit-msg 生成提交信息”他可能需要反應(yīng)一下但你說(shuō)“敲 /提交信息”他直接就能操作。實(shí)測(cè)下來(lái)新人上手這套工作流包的時(shí)間從小時(shí)級(jí)降到了分鐘級(jí)。第三是輸出風(fēng)格的統(tǒng)一。命令觸發(fā)后Claude 會(huì)按照構(gòu)建好的提示詞輸出結(jié)構(gòu)化內(nèi)容比如代碼審閱會(huì)固定輸出“問(wèn)題清單 嚴(yán)重級(jí)別 修改建議”的表格。用戶(hù)平時(shí)對(duì)話可能口語(yǔ)化但命令輸出必須是嚴(yán)格的固定格式。中文命令名和中文輸出格式搭配整條鏈路風(fēng)格統(tǒng)一。1.2 命令篩選不是所有任務(wù)都適合做成命令把操作變成命令有個(gè)前提這個(gè)操作要么是高頻重復(fù)的要么是流程固定的要么是可以通過(guò) AI 輸出模板化的內(nèi)容來(lái)減少人工整理時(shí)間的。我最初列了一份 25 個(gè)候選命令的清單最后砍到 10 個(gè)篩選標(biāo)準(zhǔn)就三條。高頻這個(gè)動(dòng)作一周至少會(huì)用三次以上。比如“生成提交信息”每天提交代碼必用適合做成命令。低思考成本命令觸發(fā)后Claude 自動(dòng)帶上固定的上下文和規(guī)則用戶(hù)只需要給一個(gè)參數(shù)比如“改動(dòng)范圍”剩下的都交給命令本身。如果某個(gè)命令還需要用戶(hù)長(zhǎng)篇大論描述背景那說(shuō)明邏輯還沒(méi)設(shè)計(jì)好。輸出可模板化命令的輸出要是結(jié)構(gòu)化、可直接復(fù)用的。比如日志分析輸出必須包含“異常類(lèi)型、報(bào)錯(cuò)行、可能原因、建議修復(fù)方案”幾個(gè)字段如果輸出只是一段自然語(yǔ)言不能直接粘貼到工單里價(jià)值就少了半截。按這三條標(biāo)準(zhǔn)篩下來(lái)的 10 個(gè)命令基本覆蓋了日常開(kāi)發(fā)的四個(gè)階段讀代碼代碼審閱、項(xiàng)目狀態(tài)巡檢、依賴(lài)梳理、寫(xiě)代碼重構(gòu)建議、問(wèn)題修復(fù)、單元測(cè)試補(bǔ)全、交付提交信息生成、文檔生成、接口調(diào)試、排障日志分析。1.3 整體架構(gòu)命令層、規(guī)則層、上下文層這套工作流包的結(jié)構(gòu)其實(shí)很簡(jiǎn)單分三層命令層定義10個(gè)命令每個(gè)命令有自己的觸發(fā)詞和參數(shù)說(shuō)明。規(guī)則層存放在項(xiàng)目根目錄下的CLAUDE.md規(guī)則文件里。這里存的是“全局約束”比如代碼風(fēng)格偏好、禁止修改的文件范圍、輸出語(yǔ)言要求等。命令本身不需要重復(fù)寫(xiě)這些規(guī)則因?yàn)?Claude Code 在每次會(huì)話中會(huì)先讀取規(guī)則文件。上下文層命令的提示詞里只寫(xiě)“本次動(dòng)作要做什么”具體代碼結(jié)構(gòu)、文件路徑、項(xiàng)目背景都通過(guò) Claude Code 的自己讀文件能力實(shí)時(shí)獲取。不把項(xiàng)目代碼塞進(jìn)命令里命令保持輕量、通用。這層設(shè)計(jì)的好處是命令是通用的規(guī)則是項(xiàng)目的。比如/代碼審閱命令可以在任何項(xiàng)目里用但不同項(xiàng)目里它讀到的規(guī)則不同輸出建議會(huì)有差異 —— 項(xiàng)目 A 要求 TypeScript 嚴(yán)格模式項(xiàng)目 B 要求兼容舊瀏覽器規(guī)則文件不同審閱側(cè)重點(diǎn)自然不同。2. 命令清單逐個(gè)拆解每個(gè)命令怎么設(shè)計(jì)、怎么寫(xiě)這 10 個(gè)命令我從設(shè)計(jì)意圖、觸發(fā)形式、核心邏輯三個(gè)角度來(lái)拆。每個(gè)命令附一段簡(jiǎn)化版的寫(xiě)法示例幫助大家理解命令背后到底做什么。2.1/代碼審閱最常用的一個(gè)命令核心邏輯很簡(jiǎn)單讓 Claude 先讀取你指定的代碼文件然后按照規(guī)則文件里的代碼規(guī)范做一次靜態(tài)審閱。這個(gè)命令要做的不是“重新檢查一遍代碼是否有語(yǔ)法錯(cuò)誤”而是關(guān)注“可讀性、潛在 bug、邊界處理、性能隱患、一致性”這幾個(gè)維度。/code review 請(qǐng)審閱文件: $FILE實(shí)際的命令里我會(huì)指定一個(gè)參數(shù)$FILE用戶(hù)可以傳單文件也可以傳一個(gè)目錄。命令的核心不是讓 AI 泛泛而談而是要求輸出格式固定問(wèn)題清單按嚴(yán)重級(jí)別排序阻斷 / 重要 / 建議每個(gè)問(wèn)題關(guān)聯(lián)的代碼引用行號(hào) 代碼片段建議修復(fù)方案風(fēng)險(xiǎn)最高的 3 個(gè)點(diǎn)為什么這樣設(shè)計(jì)因?yàn)閷忛喭甏a最終還是要人來(lái)修改。如果 AI 只是說(shuō)“這個(gè)函數(shù)太長(zhǎng)了建議拆分”沒(méi)有給出具體行號(hào)開(kāi)發(fā)者還得自己翻代碼并沒(méi)有節(jié)省時(shí)間。強(qiáng)制固定輸出格式之后拿到結(jié)果可以直接對(duì)照處理工作效率提升明顯。2.2/提交信息給 Git 提交寫(xiě)規(guī)范信息這個(gè)命令服務(wù)的是“規(guī)范提交”讓每次提交信息符合團(tuán)隊(duì)約定比如type(scope): subject格式。以往我寫(xiě)提交信息總是隨手敲一句“修復(fù)了 bug”過(guò)一個(gè)月自己都看不懂。現(xiàn)在用命令觸發(fā)后它會(huì)自動(dòng)對(duì)比暫存區(qū)的改動(dòng)內(nèi)容生成符合規(guī)范的提交信息。/commit 生成提交信息類(lèi)型遵循 conventional-changelog 規(guī)范命令里不用傳任何參數(shù)。Claude Code 會(huì)自己執(zhí)行g(shù)it diff查看暫存區(qū)改動(dòng)然后自動(dòng)生成信息。生成完我可以復(fù)制或直接采用支持中文和英文兩種輸出。實(shí)測(cè)下來(lái)生成的信息在語(yǔ)義粒度上比我自己寫(xiě)的更準(zhǔn)確因?yàn)樗鼤?huì)根據(jù)改動(dòng)內(nèi)容自動(dòng)判斷是feat還是fix還是refactor。補(bǔ)充一點(diǎn)使用這個(gè)命令的前提是git add已經(jīng)執(zhí)行否則它看不到改動(dòng)內(nèi)容。我一開(kāi)始經(jīng)常忘記先暫存后來(lái)干脆把提示詞里加了“如果暫存區(qū)無(wú)改動(dòng)則提示用戶(hù)先執(zhí)行 git add”。2.3/重構(gòu)建議在動(dòng)大刀之前先問(wèn) AI 一聲重構(gòu)風(fēng)險(xiǎn)高容易把好端端的代碼改崩。這個(gè)命令的工作方式是先把目標(biāo)代碼讀進(jìn)來(lái)分析結(jié)構(gòu)、圈復(fù)雜度、潛在擴(kuò)展點(diǎn)然后輸出一份“重構(gòu)方案”。方案里包含當(dāng)前架構(gòu)的劣勢(shì)分析、推薦的目標(biāo)結(jié)構(gòu)、分幾步走、每一步的驗(yàn)證方式。實(shí)際產(chǎn)出是一張表格當(dāng)前問(wèn)題重構(gòu)目標(biāo)改動(dòng)范圍風(fēng)險(xiǎn)級(jí)別建議實(shí)施時(shí)機(jī)為什么單獨(dú)做一個(gè)命令而不是直接對(duì)話因?yàn)橹苯訉?duì)話時(shí)總會(huì)忘掉一些維度。命令規(guī)定必須先分析“圈復(fù)雜度”必須先評(píng)估“改動(dòng)影響面”這樣不會(huì)漏項(xiàng)。2.4/日志分析異常排查時(shí)最快的入口很多項(xiàng)目日志格式不統(tǒng)一服務(wù)一多日志文件混在一起。這個(gè)命令的價(jià)值在于把“人肉翻日志、找異常關(guān)鍵字、猜原因”的過(guò)程交給 AI。/日志分析 日志文件: $LOG_PATH 時(shí)間范圍: $TIME_RANGE命令內(nèi)置了解析邏輯先按時(shí)間線排序過(guò)濾掉無(wú)意義的心跳日志識(shí)別錯(cuò)誤級(jí)別日志之間的關(guān)聯(lián)關(guān)系最后輸出“異常事件 關(guān)聯(lián)日志 可能原因 排查建議”。有一個(gè)很實(shí)用的細(xì)節(jié)它會(huì)在分析前先統(tǒng)計(jì)日志級(jí)別的分布如果某個(gè)時(shí)間段 ERROR 比例突然飆升它會(huì)刻意標(biāo)注出拐點(diǎn)。我踩過(guò)的坑是日志文件太大時(shí)直接把整個(gè)文件灌給 Claude 會(huì)超過(guò)上下文窗口處理速度也很慢。現(xiàn)在的做法是命令里內(nèi)置一條“先做采樣優(yōu)先抽取 ERROR、WARN 級(jí)別以及時(shí)間相鄰的上下文日志”避免上下文爆炸。2.5/單測(cè)補(bǔ)全把測(cè)試覆蓋率補(bǔ)上編寫(xiě)單元測(cè)試是個(gè)精細(xì)活也是很多人拖延的重災(zāi)區(qū)。這個(gè)命令的目標(biāo)不是 AI 順手把所有測(cè)試都寫(xiě)了而是“參照已有測(cè)試風(fēng)格補(bǔ)全缺失場(chǎng)景”。命令會(huì)先讀取被測(cè)文件、已有測(cè)試文件、覆蓋率報(bào)告然后找出沒(méi)覆蓋的分支生成補(bǔ)充測(cè)試用例。如果有覆蓋率報(bào)告命令會(huì)讀報(bào)告如果沒(méi)有會(huì)讓 Claude 自己分析代碼分支。它的輸出是完整的測(cè)試代碼塊可直接粘貼到測(cè)試文件里。命令里會(huì)設(shè)置一條偏執(zhí)的規(guī)則“生成的測(cè)試用例至少包含正常輸入、邊界輸入、異常輸入三類(lèi)。”注意一個(gè)細(xì)節(jié)AI 生成的單測(cè)不能無(wú)腦相信。有一個(gè)常見(jiàn)問(wèn)題為了通過(guò)覆蓋率檢測(cè)AI 會(huì)生成一些看似覆蓋了分支、但實(shí)際只是空轉(zhuǎn)的測(cè)試用例。所以命令的提示詞里專(zhuān)門(mén)有一條“不允許為了覆蓋率而生成無(wú)斷言的測(cè)試。”加上這一條之后測(cè)試質(zhì)量明顯提升。2.6/接口調(diào)試快速生成請(qǐng)求示例、定位聯(lián)調(diào)問(wèn)題處理接口聯(lián)調(diào)問(wèn)題時(shí)最煩的是翻文檔找參數(shù)名、構(gòu)造請(qǐng)求體、確認(rèn)鑒權(quán)方式。這個(gè)命令會(huì)讀取接口定義文件OpenAPI / Swagger / 后端路由代碼然后按用戶(hù)指定的場(chǎng)景生成請(qǐng)求示例或者對(duì)返回結(jié)果做疑難點(diǎn)分析。觸發(fā)方式如/接口調(diào)試 接口路徑: /user/info 場(chǎng)景: 查詢(xún)用戶(hù)詳情輸出包含請(qǐng)求方法、請(qǐng)求頭、請(qǐng)求體示例、鑒權(quán)方式說(shuō)明、可能遇到的錯(cuò)誤碼及含義。這個(gè)命令對(duì)于前后端聯(lián)調(diào)很有用尤其是后端接口文檔更新不及時(shí)的時(shí)候直接從代碼里讀取路由定義省得來(lái)回問(wèn)人要文檔。2.7/文檔生成把散落的注釋變成可用文檔文檔任務(wù)在工程里往往優(yōu)先級(jí)很低但一旦接手維護(hù)舊項(xiàng)目沒(méi)有文檔就會(huì)被坑慘。這個(gè)命令會(huì)根據(jù)代碼里的注釋、函數(shù)簽名和模塊導(dǎo)出生成一份結(jié)構(gòu)清晰的文檔草稿。它生成的內(nèi)容包括模塊概覽、函數(shù)簽名、參數(shù)說(shuō)明、返回值、使用示例、注意事項(xiàng)。命令會(huì)要求“先讀取項(xiàng)目已有文檔的寫(xiě)作風(fēng)格再按同樣風(fēng)格生成”避免產(chǎn)出的文檔和團(tuán)隊(duì)已有的風(fēng)格不統(tǒng)一。2.8/依賴(lài)梳理搞清楚項(xiàng)目依賴(lài)之間的關(guān)系依賴(lài)關(guān)系混亂是舊項(xiàng)目的常見(jiàn)問(wèn)題。package.json里幾十個(gè)依賴(lài)哪些是直接依賴(lài)、哪些是間接依賴(lài)、哪些版本沖突人肉排查很痛苦。這個(gè)命令會(huì)讀取依賴(lài)清單并分析目錄結(jié)構(gòu)輸出一張依賴(lài)關(guān)系表和潛在風(fēng)險(xiǎn)點(diǎn)。輸出格式為| 依賴(lài)名 | 當(dāng)前版本 | 最新版本 | 直引/間接 | 風(fēng)險(xiǎn)說(shuō)明 | 建議操作 |生成的建議可以包括“升級(jí)到某個(gè)版本后需要回歸驗(yàn)證哪些模塊”這個(gè)信息對(duì)排期很有價(jià)值。2.9/問(wèn)題修復(fù)拿到報(bào)錯(cuò)直接修嚴(yán)格來(lái)說(shuō)這不是一個(gè)自動(dòng)修改器而是一個(gè)“診斷工具”。它接收?qǐng)?bào)錯(cuò)信息或異常堆棧再結(jié)合相關(guān)代碼上下文輸出“根因分析 修復(fù)建議 修改后的代碼”。與/代碼審閱的區(qū)別是代碼審閱面對(duì)的是整個(gè)文件盡量發(fā)現(xiàn)潛在問(wèn)題問(wèn)題修復(fù)是拿著明確報(bào)錯(cuò)去定位根因。命令會(huì)要求 Claude 先解釋報(bào)錯(cuò)產(chǎn)生的鏈路再動(dòng)手改代碼避免“只改了表面癥狀、沒(méi)有消除根因”。每次使用這個(gè)命令我都會(huì)讓它先輸出“根因是否確認(rèn)”這個(gè)字段。如果它沒(méi)有足夠信息確認(rèn)根因它會(huì)要求補(bǔ)信息而不是強(qiáng)行給修復(fù)方案。這個(gè)約束很關(guān)鍵防止 AI 在一知半解時(shí)瞎改代碼。2.10/狀態(tài)巡檢摸清項(xiàng)目全貌的第一站接手新項(xiàng)目或者剛打開(kāi)一個(gè)幾周沒(méi)碰的舊項(xiàng)目時(shí)內(nèi)心最迷茫的是“這項(xiàng)目現(xiàn)在什么狀態(tài)”。項(xiàng)目狀態(tài)巡檢這個(gè)命令就是把項(xiàng)目關(guān)鍵信息一次性拉出來(lái)框架、語(yǔ)言版本、構(gòu)建工具目錄結(jié)構(gòu)概覽技術(shù)棧亮點(diǎn)與風(fēng)險(xiǎn)點(diǎn)比如依賴(lài)了過(guò)時(shí)庫(kù)全部 TODO / FIXME 位置摘錄當(dāng)前分支狀態(tài)、未提交改動(dòng)數(shù)量實(shí)際體驗(yàn)下來(lái)這個(gè)命令是“開(kāi)局”命令。每次開(kāi)始干活前跑一次比盯著 README 發(fā)愁強(qiáng)。它會(huì)自動(dòng)跳到 README、配置文件、入口文件等關(guān)鍵位置讀信息不用用戶(hù)一點(diǎn)點(diǎn)翻。3. 工作流包的實(shí)現(xiàn)與落地怎么把命令變成可復(fù)用的工具3.1 命令目錄結(jié)構(gòu)與配置方法Claude Code 的命令目錄配置本質(zhì)上就是把每個(gè)命令寫(xiě)成一個(gè)帶有函數(shù)式聲明的配置文件。我實(shí)際用的目錄結(jié)構(gòu)大概是這樣.claude/ ├── commands/ │ ├── 代碼審閱.md │ ├── 提交信息.md │ ├── 重構(gòu)建議.md │ ├── 日志分析.md │ ├── 單測(cè)補(bǔ)全.md │ ├── 接口調(diào)試.md │ ├── 文檔生成.md │ ├── 依賴(lài)梳理.md │ ├── 問(wèn)題修復(fù).md │ └── 狀態(tài)巡檢.md └── CLAUDE.md每個(gè).md文件就是一個(gè)命令定義。文件開(kāi)頭寫(xiě)了觸發(fā)命令名、參數(shù)說(shuō)明、簡(jiǎn)短描述后面跟著命令真正執(zhí)行的提示詞。以/提交信息為例配置文件核心結(jié)構(gòu)如下--- name: 提交信息 description: 對(duì)比 git 暫存區(qū)改動(dòng)按規(guī)范生成提交信息 參數(shù): 無(wú) --- 按 Conventions 生成一條 git commit message。 先執(zhí)行 git diff --cached 查看暫存區(qū)改動(dòng)分析改動(dòng)文件和內(nèi)容。 要求 1. 提交信息格式 type(scope): subject 2. 如果包含破壞性變更在正文中說(shuō)明 BREAKING CHANGE 3. 簡(jiǎn)要描述為什么做這個(gè)改動(dòng)而不是僅描述改了什么 4. 主體內(nèi)容使用中文type 使用英文標(biāo)準(zhǔn)詞匯 5. 最多提供 3 條候選信息并給出簡(jiǎn)短的選擇理由CLAUDE.md文件放的是項(xiàng)目級(jí)偏好比如這個(gè)團(tuán)隊(duì)的風(fēng)格規(guī)范、禁止觸碰的文件、測(cè)試要求。每個(gè)命令在執(zhí)行過(guò)程中會(huì)自動(dòng)感知這個(gè)文件里的規(guī)則。3.2 參數(shù)設(shè)計(jì)怎么讓命令“好用、不容易用錯(cuò)”參數(shù)設(shè)計(jì)是一門(mén)分寸感很強(qiáng)的學(xué)問(wèn)。參數(shù)太少命令靈活度不夠參數(shù)太多使用門(mén)檻升高。我錄過(guò) 10 個(gè)命令里有 7 個(gè)不需要任何參數(shù)剩下 3 個(gè)最多 2 個(gè)參數(shù)。為什么偏好在“少參數(shù)”方向因?yàn)槊顓^(qū)別于腳本的本質(zhì)在于它應(yīng)該有“智能默認(rèn)值”。比如/日志分析如果不傳時(shí)間范圍就默認(rèn)分析最近一小時(shí)的日志如果傳時(shí)間范圍就按傳的來(lái)。Claude Code 在解析命令時(shí)能理解自然語(yǔ)言參數(shù)你可以說(shuō)“最近 2 小時(shí)”也可以說(shuō)“2025-12-01 當(dāng)天”。對(duì) AI 來(lái)說(shuō)這沒(méi)有區(qū)別但對(duì)人來(lái)說(shuō)輸入的自然語(yǔ)言比你記憶一套標(biāo)志位語(yǔ)法要好得多。參數(shù)盡量用$變量表示并在命令描述里寫(xiě)清楚參數(shù)格式--- name: 代碼審閱 description: 審閱指定文件的代碼質(zhì)量 參數(shù): $FILE 目標(biāo)文件或目錄 ---此外我強(qiáng)烈建議每個(gè)命令的描述里帶上“使用前提”比如“/日志分析 需要在項(xiàng)目目錄下執(zhí)行”“/提交信息 需要先 git add”。這些描述會(huì)展示在命令列表里能顯著減少用錯(cuò)的概率。3.3 規(guī)則文件命令效果差異最大的因素很多人的命令效果不穩(wěn)定最根本的原因是全局規(guī)則文件寫(xiě)得太粗糙。CLAUDE.md里我放了以下六塊內(nèi)容項(xiàng)目語(yǔ)言和框架基礎(chǔ)信息只有 Claude 知道項(xiàng)目用 Vue 還是 React、用 Python 還是 Java才能給對(duì)建議代碼風(fēng)格偏好分號(hào)要不要、縮進(jìn)兩個(gè)還是四個(gè)、組件命名用 PascalCase 還是 kebab-case禁止自動(dòng)修改的文件清單比如 lock 文件、dist 目錄、自動(dòng)生成的 SDK 代碼AI 看不懂這些文件千萬(wàn)別動(dòng)測(cè)試約定測(cè)試文件放哪、命令怎么跑文檔語(yǔ)言默認(rèn)輸出中文除非用戶(hù)明確要求英文常見(jiàn)坑比如某些第三方庫(kù)的已知問(wèn)題AI 檢查代碼時(shí)遇到相關(guān)模式要特別關(guān)注舉一個(gè)具體例子。某次在一個(gè)發(fā)版前的倉(cāng)庫(kù)里跑/代碼審閱Claude 一直報(bào)錯(cuò)說(shuō)某個(gè)第三方依賴(lài)的代碼有問(wèn)題。但實(shí)際上那是構(gòu)建工具自動(dòng)生成的、不能手改的文件。后來(lái)我在規(guī)則里加了“/src/libs/目錄下所有文件為自動(dòng)生成文件發(fā)現(xiàn)問(wèn)題時(shí)標(biāo)記為‘不可修改需上游修復(fù)’”這個(gè)問(wèn)題就消失了。規(guī)則文件不是擺設(shè)它是命令效果的放大器。3.4 配置進(jìn)團(tuán)隊(duì)倉(cāng)庫(kù)和個(gè)人全局配置的區(qū)別這套命令包有兩個(gè)層級(jí)個(gè)人全局配置和項(xiàng)目級(jí)配置。個(gè)人全局配置適合那些與項(xiàng)目無(wú)關(guān)的通用命令比如“提交信息”“文檔生成”。項(xiàng)目級(jí)配置適合綁定當(dāng)前項(xiàng)目上下文的內(nèi)容比如“數(shù)據(jù)庫(kù)表結(jié)構(gòu)”“目錄風(fēng)格”。我實(shí)際使用時(shí)分得很清楚與業(yè)務(wù)強(qiáng)相關(guān)的內(nèi)容API 路由、數(shù)據(jù)模型放項(xiàng)目級(jí)CLAUDE.md通用 AI 交互偏好、通用命令定義放個(gè)人配置。原因是項(xiàng)目級(jí)配置要跟著倉(cāng)庫(kù)走方便團(tuán)隊(duì)成員共享。通用命令挪到個(gè)人配置后無(wú)論在哪個(gè)項(xiàng)目里都能喚起不用每個(gè)倉(cāng)庫(kù)粘一份。3.5 版本管理與團(tuán)隊(duì)分享命令包本身也是一個(gè)代碼庫(kù)值得用 Git 管理。我會(huì)把命令包單獨(dú)建一個(gè)配置倉(cāng)庫(kù).dotfiles 倉(cāng)庫(kù)管理模式改完命令后提交一條feat: 增加接口調(diào)試命令。團(tuán)隊(duì)其他成員可以直接 pull 下來(lái)放入自己的配置目錄如果項(xiàng)目需要也可以把這套命令目錄拷貝到項(xiàng)目根目錄的.claude/下分享給參與這個(gè)項(xiàng)目的所有人。一份配置能不能在團(tuán)隊(duì)推廣很大程度取決于“命令文檔是否清晰”。我給每個(gè)命令都寫(xiě)了使用說(shuō)明包括這個(gè)命令解決什么問(wèn)題在什么場(chǎng)景下用執(zhí)行的先后順序是什么比如先 /狀態(tài)巡檢 再 /代碼審閱常見(jiàn)誤用方式命令文檔寫(xiě)在每個(gè)命令的description字段和配套 README 里。好的命令包應(yīng)該讓隊(duì)友拿到手之后不用再問(wèn)你“這個(gè)命令怎么用來(lái)著”。4. 真實(shí)場(chǎng)景中的完整工作流串聯(lián)從接手項(xiàng)目到提交上線光有命令清單還不夠真正順手的是把它們按場(chǎng)景串成工作流。我拿最近處理的一個(gè)遺留系統(tǒng)為例完整走一遍這套流程。4.1 開(kāi)局項(xiàng)目狀態(tài)巡檢活還沒(méi)開(kāi)始干先跑/狀態(tài)巡檢。輸出里能看到這個(gè)項(xiàng)目是一個(gè)內(nèi)部的報(bào)表系統(tǒng)后端用了 Python 加一個(gè)老版本 ORM前端是 Vue 2。依賴(lài)?yán)镉袔讉€(gè)已停止維護(hù)的包。目錄結(jié)構(gòu)里有一個(gè)scripts/report_generate.py看起來(lái)像是核心模塊還有 47 個(gè) TODO 待辦。分支上掛著十幾處未提交改動(dòng)看起來(lái)是上一個(gè)同事改到一半的狀態(tài)?？赐瓿裳矙z結(jié)果我對(duì)項(xiàng)目的“健康狀況”就有底了。這種一眼掃過(guò)去完全摸不著北的舊項(xiàng)目先巡檢再動(dòng)手能少走很多彎路。4.2 動(dòng)手改需求前先看代碼再重構(gòu)這次需求是“報(bào)表導(dǎo)出增加 CSV 格式”。我先用/代碼審閱 scripts/report_generate.py過(guò)一遍核心文件。審閱結(jié)果指出兩個(gè)問(wèn)題一是數(shù)據(jù)量大的時(shí)候內(nèi)存占用會(huì)翻倍因?yàn)闆](méi)有用生成器逐個(gè)寫(xiě)入二是異常處理覆蓋不足數(shù)據(jù)庫(kù)查詢(xún)出錯(cuò)時(shí)會(huì)直接拋給前端。對(duì)于我這種剛接觸這個(gè)項(xiàng)目的人來(lái)說(shuō)這種及時(shí)的提醒非常關(guān)鍵不用等代碼跑到線上出問(wèn)題才后悔?？赐陮忛喗Y(jié)果我繼續(xù)用/重構(gòu)建議設(shè)計(jì)“如何接入 CSV 導(dǎo)出且不影響現(xiàn)有 Excel 導(dǎo)出邏輯”。重構(gòu)建議給出的方案是抽象一個(gè)ReportExporter基類(lèi)分別實(shí)現(xiàn) Excel 和 CSV 兩個(gè)子類(lèi)調(diào)用處按格式參數(shù)切換。按這個(gè)結(jié)構(gòu)改完后改動(dòng)面最小風(fēng)險(xiǎn)也可控。4.3 寫(xiě)完代碼后單測(cè)補(bǔ)全、接口調(diào)試、文檔生成功能寫(xiě)完跑一遍/單測(cè)補(bǔ)全。它讀了report_generate.py的現(xiàn)有測(cè)試文件識(shí)別到測(cè)試覆蓋了 Excel 導(dǎo)出路徑但 CSV 導(dǎo)出路徑完全沒(méi)測(cè)。于是生成了 CSV 導(dǎo)出的測(cè)試用例包含正常數(shù)據(jù)導(dǎo)出、空數(shù)據(jù)導(dǎo)出、字段映射缺失三種場(chǎng)景。我補(bǔ)充提交后覆蓋率從 61% 提升到 78%。這個(gè)項(xiàng)目前端調(diào)接口的方式我不熟。直接用/接口調(diào)試 接口路徑: /api/report/export 場(chǎng)景: 導(dǎo)出CSV它會(huì)自動(dòng)讀取路由定義把請(qǐng)求方法、參數(shù)、返回結(jié)構(gòu)列出來(lái)。前后端聯(lián)調(diào)時(shí)省去了抱著接口文檔反復(fù)翻找的流程。文檔目前基本空白。跑完/文檔生成它按照代碼里的注釋生成了report_generate.py的模塊文檔包括導(dǎo)出流程、參數(shù)說(shuō)明、異常類(lèi)型匯總。一并提交到倉(cāng)庫(kù)里后面的同事接手就輕松多了。4.4 提交與排障提交信息、日志分析、問(wèn)題修復(fù)功能聯(lián)調(diào)完畢執(zhí)行g(shù)it add后調(diào)用/提交信息生成的候選信息feat(report): 增加 CSV 導(dǎo)出支持 - 抽象 ReportExporter 基類(lèi)新增 CsvExporter 實(shí)現(xiàn) - 調(diào)整導(dǎo)出接口以支持 format 參數(shù) - 補(bǔ)充 CSV 導(dǎo)出路徑的單元測(cè)試我選了這版理由很充分它概括了重構(gòu)背景也說(shuō)明了技術(shù)方案后續(xù)回溯 git history 時(shí)能知道這次改動(dòng)背后的意圖。上線后監(jiān)控發(fā)現(xiàn)一個(gè)報(bào)錯(cuò)。我導(dǎo)出日志跑/日志分析它識(shí)別到 CSV 導(dǎo)出接口在空數(shù)據(jù)時(shí)拋出的類(lèi)型錯(cuò)誤定位到是因?yàn)閒ields為空時(shí) CSV 表頭構(gòu)造邏輯走了錯(cuò)誤分支。拿到這個(gè)定位結(jié)果直接用/問(wèn)題修復(fù)提供修復(fù)方案將表頭構(gòu)造邏輯提前判空空數(shù)據(jù)時(shí)直接返回空文件。修復(fù)后重新跑單測(cè)全部通過(guò)。4.5 工作流串聯(lián)的總結(jié)感言這一整條鏈路從接手項(xiàng)目到交付功能以前我至少要折騰一整天這套命令包穩(wěn)定情況下一個(gè)上午就能完成。不是每次命令輸出都完美但可以快速確定“哪一步有問(wèn)題”而不是反復(fù)手工操作去猜。版本規(guī)劃上也更清晰。用完了測(cè)試、審閱、生成文檔、生成提交信息再回看git log這條線比以往規(guī)整太多。5. 常見(jiàn)問(wèn)題與排查技巧命令包用著用著出問(wèn)題怎么辦任何工具用久了都會(huì)遇到問(wèn)題。命令包也一樣。我把自己用這 10 個(gè)命令過(guò)程中遇到的典型問(wèn)題和排查思路整理成速查表。5.1 命令沒(méi)有按預(yù)期執(zhí)行如果某個(gè)命令完全不觸發(fā)或觸發(fā)了但行為不對(duì)首先檢查命令配置文件名與name字段是否一致。命令名里不要有空格可以用中文但不要用“代碼 審閱”這種帶空格的寫(xiě)法也不要包含會(huì)被解析出歧義的符號(hào)。然后檢查工作目錄是否正確。很多命令內(nèi)部會(huì)調(diào)動(dòng)git、讀取文件如果當(dāng)前目錄不是項(xiàng)目根目錄而是子目錄相對(duì)路徑就可能會(huì)出問(wèn)題。一個(gè)快速驗(yàn)證方法是在項(xiàng)目根目錄下重新執(zhí)行。5.2 上下文太長(zhǎng)響應(yīng)變慢且效果下降命令本身加上項(xiàng)目文件內(nèi)容疊加起來(lái)容易超過(guò)模型上下文窗口或可用冗余。我遇到最多的是/日志分析和/代碼審閱。解決思路是“先縮小再分析”。在命令配置里強(qiáng)制增加一步“先讀取文件大小如果超過(guò)閾值優(yōu)先提取代碼中的關(guān)鍵函數(shù)/關(guān)鍵目錄作為分析對(duì)象避免一次性讀入整個(gè)大文件?！被蛘咴谌罩痉治鰣?chǎng)景先按時(shí)間過(guò)濾、按日志級(jí)別過(guò)濾再判斷是否讀入。5.3 中文輸出格式混亂命令要求輸出成表格但 AI 偶爾會(huì)輸出成一大段文字。這種情況基本是因?yàn)橛脩?hù)在原場(chǎng)景中追加的其他指令干擾了命令的說(shuō)明。有一個(gè)相對(duì)穩(wěn)定的小技巧在命令提示詞里把“必須輸出表格”這樣的要求重復(fù)兩遍并明確“不要在其他解釋性文字中夾雜表格數(shù)據(jù)”。在關(guān)鍵位置強(qiáng)調(diào)一遍輸出穩(wěn)定性會(huì)明顯變好。5.4 命令被“串場(chǎng)”污染這是比較隱蔽的問(wèn)題。一個(gè)命令執(zhí)行完之后后續(xù)繼續(xù)對(duì)話新命令會(huì)“沿用”前面的語(yǔ)義。比如先跑了/提交信息再跑/日志分析AI 可能誤將日志內(nèi)容視為“最近的代碼提交內(nèi)容”。解決方法是命令文件里開(kāi)頭加一句“忽略與本次命令無(wú)關(guān)的對(duì)話上下文”。這樣能有效阻斷串場(chǎng)。另外建議在執(zhí)行下一個(gè)命令前按 Esc 或清理一下會(huì)話上下文。5.5 生成的代碼不可靠甚至直接編譯失敗AI 生成的代碼偶爾引用不存在的 API 或?qū)戝e(cuò)變量名這無(wú)法完全避免。我的處理經(jīng)驗(yàn)是要求命令輸出后自動(dòng)執(zhí)行“自檢”。所謂自檢就是讓 Claude 檢查自己生成的代碼先看引用的函數(shù)和變量是否在上下文中定義再看語(yǔ)法是否完整最后對(duì)照導(dǎo)入表的模塊名。這一步放在輸出的最后能在很大程度上減少低級(jí)錯(cuò)誤。測(cè)試類(lèi)和接口調(diào)試這類(lèi)命令的效果會(huì)穩(wěn)很多。5.6 不同項(xiàng)目之間命令行為不一致如果同一命令在不同項(xiàng)目里效果差異巨大十有八九是規(guī)則文件差異導(dǎo)致的。項(xiàng)目 A 的CLAUDE.md里寫(xiě)了“工程文件在 src 目錄下自動(dòng)生成的代碼不要?jiǎng)印表?xiàng)目 B 沒(méi)有這些規(guī)則AI 自然只能根據(jù)默認(rèn)經(jīng)驗(yàn)來(lái)響應(yīng)。建議每個(gè)項(xiàng)目都在根目錄放一個(gè)CLAUDE.md把項(xiàng)目獨(dú)有的上下文寫(xiě)清楚。哪怕只寫(xiě)三行也比沒(méi)有強(qiáng)。6. 一些踩坑后的心得怎么把命令包做得更好用6.1 命令要“小步快跑”不要追求一步到位一開(kāi)始我設(shè)計(jì)命令時(shí)總想把所有規(guī)則一次性塞進(jìn)一句話里。結(jié)果效果反而不好。比如/代碼審閱最初要求“同時(shí)檢查代碼質(zhì)量、性能、安全、可維護(hù)性、設(shè)計(jì)模式并生成重構(gòu)建議”。輸出內(nèi)容太多反而沒(méi)有重點(diǎn)幾乎不能用。后來(lái)我把所有命令的輸出都強(qiáng)制收斂成“最多三個(gè)重點(diǎn)”最嚴(yán)重的問(wèn)題必須先列出來(lái)其余問(wèn)題用一句話匯總。這樣做之后輸出質(zhì)量明顯提升人也更容易消化結(jié)果。6.2 把“不要做什么”寫(xiě)進(jìn)命令里提示詞里如果少于 10% 是“不要做什么”命令大概率會(huì)在某些邊界上跑偏。給幾個(gè)實(shí)際例子“不要在回答中修改用戶(hù)的代碼如果修改則給出完整 diff?！薄安灰獙⒆詣?dòng)生成的文件列為問(wèn)題除非是改造方案?！薄安灰僭O(shè)測(cè)試環(huán)境已經(jīng)配置了數(shù)據(jù)庫(kù)連接需要在建議中給出 mock 方案?！薄安灰褂贸鲰?xiàng)目 dependencies 的庫(kù)除非給出理由且用戶(hù)確認(rèn)過(guò)?！痹黾恿艘粚印胺穸s束”讓命令的安全邊界變得清晰。AI 不容易“自由發(fā)揮”。6.3 測(cè)試命令本身迭代命令包也需要回歸每次修改命令的提示詞最好都用同一份樣例數(shù)據(jù)回歸一遍。我給 10 個(gè)命令各準(zhǔn)備了一個(gè)測(cè)試樣例文件放在配置倉(cāng)庫(kù)里。修改某個(gè)命令后對(duì)照樣例重新跑一次看輸出格式是否規(guī)范、關(guān)鍵要求是否被遵守。這樣做能有效防止改壞原有功能。6.4 不要過(guò)度自動(dòng)化這一點(diǎn)可能有些反直覺(jué)但我真心提醒不是所有事情都適合交給 AI 自動(dòng)執(zhí)行。比如自動(dòng)重構(gòu)代碼、自動(dòng)批量調(diào)整文件只要命令一開(kāi)改動(dòng)范圍很難預(yù)期風(fēng)險(xiǎn)極大。我的所有命令默認(rèn)都是“生成建議供用戶(hù)確認(rèn)”只有用戶(hù)明確說(shuō)“執(zhí)行”之后AI 才會(huì)動(dòng)手修改文件。我寧可人肉確認(rèn)一遍也不半夜被線上事故吵醒。7. 后續(xù)可以怎么擴(kuò)展這套工作流包這套命令包目前運(yùn)行得比較順手我還在持續(xù)擴(kuò)展。目前已經(jīng)在嘗試的方向有兩個(gè)。一個(gè)是結(jié)合 CI 流程。計(jì)劃把/代碼審閱和/單測(cè)補(bǔ)全的執(zhí)行結(jié)果以評(píng)論形式回寫(xiě)到 Pull Request 上。這樣不只本地開(kāi)發(fā)時(shí)用命令團(tuán)隊(duì)在 code review 環(huán)節(jié)也能借助 AI 覆蓋常見(jiàn)問(wèn)題。另一個(gè)是給不同技術(shù)棧定制預(yù)置命令?，F(xiàn)在命令包是通用版在不同框架下細(xì)節(jié)有差異?？紤]按“前端 Vue 項(xiàng)目命令包”“Python 服務(wù)命令包”“Java 后端命令包”拆分不同版本配合對(duì)應(yīng)的規(guī)則文件開(kāi)箱即用性會(huì)更好。如果這篇文章看下來(lái)的讀者也想自己搭一套我的建議是不要照搬我的 10 個(gè)命令先拿一周時(shí)間記錄自己日常操作哪些動(dòng)作重復(fù)度最高挑出 3 個(gè)做成命令用熟了再逐步擴(kuò)充。命令包的價(jià)值不在于數(shù)量而在于每個(gè)命令都能真正幫你省下時(shí)間。我自己試錯(cuò)了兩三輪才找到合適的結(jié)構(gòu)你如果在折騰過(guò)程中碰到奇怪問(wèn)題大概率是規(guī)則文件和參數(shù)設(shè)計(jì)的問(wèn)題對(duì)照前面第 5 節(jié)逐條排查一下基本都能解決。我個(gè)人用下來(lái)的最大感受就是“中文命令”這一層設(shè)計(jì)讓這套東西在團(tuán)隊(duì)里的接受度變得異常高。如果你也想快速驗(yàn)證自己的 AI 編程工作流不妨從第一個(gè)命令開(kāi)始挑一個(gè)你每天都要重復(fù)做的動(dòng)作花十分鐘做成命令很快就能?chē)L到甜頭。