格規(guī)則：從不可變性與 Zod 校驗(yàn)到 Hook 自動(dòng)檢測(cè))
ECC 的 TypeScript/JavaScript 編碼風(fēng)格規(guī)則從不可變性與 Zod 校驗(yàn)到 Hook 自動(dòng)檢測(cè)【免費(fèi)下載鏈接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ev/ECC本篇基于 ECC 倉(cāng)庫(kù)中的 Cursor 規(guī)則文件.cursor/rules/typescript-coding-style.md展開(kāi)系統(tǒng)講解其中四條 TypeScript/JavaScript 編碼風(fēng)格約定——不可變更新、async/await 錯(cuò)誤處理、Zod 輸入校驗(yàn)與console.log禁令——的完整寫(xiě)法并結(jié)合倉(cāng)庫(kù)源碼剖析這些規(guī)則如何通過(guò) Hook 機(jī)制scripts/hooks/check-console-log.js等在 Agent 會(huì)話(huà)中自動(dòng)執(zhí)行幫助你既能在人寫(xiě)代碼時(shí)直接復(fù)用這套規(guī)范也理解其底層自動(dòng)化實(shí)現(xiàn)。規(guī)則文件的定位Cursor Rules 的通用 語(yǔ)言?xún)蓪咏Y(jié)構(gòu)ECC 倉(cāng)庫(kù)為 Cursor 提供了一組可版本化的編碼規(guī)則位于 .cursor/rules/ 目錄。該目錄下按通用common- 語(yǔ)言專(zhuān)屬兩層組織.cursor/rules/common-coding-style.mdalwaysApply: true所有語(yǔ)言共享的編碼風(fēng)格基線(xiàn)不可變性、錯(cuò)誤處理、輸入校驗(yàn)、代碼質(zhì)量清單.cursor/rules/typescript-coding-style.mdTypeScript/JavaScript 專(zhuān)屬擴(kuò)展開(kāi)頭明確寫(xiě)著 This file extends the common coding style rule with TypeScript/JavaScript specific content.。后者的 YAML front matter 定義了它的加載條件--- description: TypeScript coding style extending common rules globs: [**/*.ts, **/*.tsx, **/*.js, **/*.jsx] alwaysApply: false ---三個(gè)字段的作用字段取值含義descriptionTypeScript coding style extending common rules規(guī)則描述供規(guī)則列表檢索展示globs**/*.ts、**/*.tsx、**/*.js、**/*.jsx僅當(dāng)上下文涉及這四類(lèi)文件時(shí)觸發(fā)注入alwaysApplyfalse非全局常駐按 glob 匹配按需生效這種按文件類(lèi)型觸發(fā)的設(shè)計(jì)正是 Cursor Rules 的核心機(jī)制與alwaysApply: true的通用規(guī)則互補(bǔ)避免把 TS 專(zhuān)屬內(nèi)容塞進(jìn)每個(gè)文件的上下文中從而節(jié)省 token、減少無(wú)關(guān)干擾。核心約束一不可變更新Immutability規(guī)則文件給出的標(biāo)準(zhǔn)范式是禁止原地修改用 spread 返回新對(duì)象// WRONG: Mutation function updateUser(user, name) { user.name name // MUTATION! return user } // CORRECT: Immutability function updateUser(user, name) { return { ...user, name } }這條約束并非 TS 特有——它在 .cursor/rules/common-coding-style.md 中被標(biāo)記為CRITICAL并給出理由不可變數(shù)據(jù)能消除隱藏副作用、降低調(diào)試成本、支持安全并發(fā)。同一文件還配套了量化約束函數(shù) 50 行、文件 800 行、嵌套不超過(guò) 4 層、無(wú)硬編碼值作為標(biāo)記工作完成前的檢查清單。值得注意的是倉(cāng)庫(kù)在同一規(guī)范下存在一個(gè)擴(kuò)展版rules/typescript/coding-style.md。它在 Cursor 版的四個(gè)章節(jié)之上前置了更完整的類(lèi)型設(shè)計(jì)約定例如公共 API 顯式類(lèi)型導(dǎo)出函數(shù)必須標(biāo)注參數(shù)與返回類(lèi)型局部變量可交給推斷interface vs type可能被擴(kuò)展/實(shí)現(xiàn)的形狀用interface聯(lián)合、交叉、映射、工具類(lèi)型用type優(yōu)先字符串字面量聯(lián)合而非enum避免any外部/不可信輸入用unknown再安全收窄泛型用于類(lèi)型取決于調(diào)用方的場(chǎng)景// WRONG: any removes type safety function getErrorMessage(error: any) { return error.message } // CORRECT: unknown forces safe narrowing function getErrorMessage(error: unknown): string { if (error instanceof Error) { return error.message } return Unexpected error }React Props用命名interface定義 props、顯式標(biāo)注回調(diào)類(lèi)型、無(wú)特殊理由不用React.FC純 JS 文件在無(wú)法遷移到 TS 時(shí)用 JSDoc 表達(dá)類(lèi)型且要求 JSDoc 與運(yùn)行時(shí)行為保持一致。從源碼結(jié)構(gòu)看.cursor/rules/Cursor 側(cè)與rules/Claude/通用側(cè)兩份規(guī)則內(nèi)容高度同構(gòu)、互為鏡像ECC 通過(guò)這種雙份維護(hù)讓不同 Agent 客戶(hù)端加載各自格式的同一套規(guī)范。寫(xiě)作 TS 代碼時(shí)建議以擴(kuò)展版為完整清單先過(guò)類(lèi)型設(shè)計(jì)再過(guò)下文的四條實(shí)操約束。核心約束二async/await try-catch 錯(cuò)誤處理規(guī)則文件要求異步操作統(tǒng)一使用 async/await 配 try-catch而不是裸.then/.catchtry { const result await riskyOperation() return result } catch (error) { console.error(Operation failed:, error) throw new Error(Detailed user-friendly message) }關(guān)鍵點(diǎn)在于兩層信息分離console.error落詳細(xì)錯(cuò)誤上下文服務(wù)端/開(kāi)發(fā)側(cè)可見(jiàn)重新拋出的Error攜帶面向用戶(hù)的友好信息UI 側(cè)可見(jiàn)。這與通用規(guī)則中UI 面向代碼給友好信息、服務(wù)端記詳細(xì)上下文、絕不靜默吞錯(cuò)的要求一一對(duì)應(yīng)。擴(kuò)展版 rules/typescript/coding-style.md 把該模式升級(jí)為完整可運(yùn)行示例catch 參數(shù)標(biāo)注unknown、通過(guò)instanceof Error收窄、用可替換的生產(chǎn)級(jí) logger 接口注釋建議 pino/winston替代console.errorasync function loadUser(userId: string): PromiseUser { try { const result await riskyOperation(userId) return result } catch (error: unknown) { logger.error(Operation failed, error) throw new Error(getErrorMessage(error)) } }核心約束三Zod 模式化輸入校驗(yàn)規(guī)則文件指定 Zod 作為邊界校驗(yàn)的標(biāo)準(zhǔn)方案import { z } from zod const schema z.object({ email: z.string().email(), age: z.number().int().min(0).max(150) }) const validated schema.parse(input)配套的通用規(guī)則要求在系統(tǒng)邊界校驗(yàn)所有輸入、快速失敗、永不信任外部數(shù)據(jù)API 響應(yīng)、用戶(hù)輸入、文件內(nèi)容。擴(kuò)展版進(jìn)一步給出了類(lèi)型聯(lián)動(dòng)寫(xiě)法——用z.infer從 schema 推導(dǎo)輸入類(lèi)型使校驗(yàn)邏輯與類(lèi)型定義單一來(lái)源const userSchema z.object({ email: z.string().email(), age: z.number().int().min(0).max(150) }) type UserInput z.infertypeof userSchema const validated: UserInput userSchema.parse(input)這意味著parse成功后返回值的類(lèi)型即UserInput下游函數(shù)簽名可以直接消費(fèi)該類(lèi)型無(wú)需手寫(xiě)一遍字段聲明。核心約束四console.log 禁令與自動(dòng)檢測(cè)規(guī)則文件第四條約定生產(chǎn)代碼中不允許console.log語(yǔ)句應(yīng)使用正規(guī)的 logging 庫(kù)替代See hooks for automatic detection——即該約定不只靠人遵守而是由 Hook 機(jī)制自動(dòng)檢測(cè)。這一見(jiàn) Hook的指向在倉(cāng)庫(kù)中有完整的實(shí)現(xiàn)鏈路可以印證1. 規(guī)則側(cè)的聲明.cursor/rules/typescript-hooks.md.cursor/rules/typescript-hooks.md 與編碼風(fēng)格規(guī)則使用完全相同的globs和alwaysApply: false聲明了 TypeScript 文件相關(guān)的 HookPostToolUse配置于~/.claude/settings.jsonPrettier 編輯后自動(dòng)格式化、編輯.ts/.tsx后運(yùn)行tsc類(lèi)型檢查、對(duì)編輯文件中的console.log發(fā)出警告Stop會(huì)話(huà)響應(yīng)結(jié)束前對(duì)所有已修改文件做console.log審計(jì)。2. 實(shí)現(xiàn)側(cè)的落地check-console-log.jsStop 鉤子的實(shí)際實(shí)現(xiàn)位于 scripts/hooks/check-console-log.js。閱讀源碼可以看到幾個(gè)工程細(xì)節(jié)檢測(cè)范圍通過(guò)getGitModifiedFiles([\\.tsx?$, \\.jsx?$])只掃描本輪 git 已修改的 JS/TS 文件而非全倉(cāng)庫(kù)控制開(kāi)銷(xiāo)豁免模式EXCLUDED_PATTERNS排除了測(cè)試與腳本場(chǎng)景——.test./.spec.文件、*.config.js/ts、scripts/目錄、__tests__/、__mocks__/因?yàn)樵谶@些地方console.log往往是有意為之只警告不阻斷命中后僅log([Hook] WARNING: console.log found in ...)并提示提交前移除退出碼保持 0符合 hooks 架構(gòu)中Stop 鉤子可分析但不能阻斷的定位ECC 透?jìng)骷s定stdin 原樣回寫(xiě)到 stdoutpassThroughAndExit且設(shè)置了 1MB 的 stdin 上限——超限的截?cái)?JSON 不再回顯以免觸發(fā) harness 的 JSON 校驗(yàn)失敗源碼注釋明確指向 issue #2090。該鉤子在 hooks/hooks.json 的Stop數(shù)組中以stop:check-console-log注冊(cè)運(yùn)行于standard,strict配置檔位同一數(shù)組中還有stop:format-typecheck批量 Prettier/Biome 格式化 tsc類(lèi)型檢查注釋說(shuō)明在 Stop 時(shí)一次性運(yùn)行而非每次 Edit 后。3. 使用與開(kāi)關(guān)按 hooks/README.md 的說(shuō)明這套 Hook 不建議手工粘貼hooks.json而是通過(guò)安裝器解析安裝bash ./install.sh --target claude --modules hooks-runtime --enable-hookspwsh -File .\install.ps1 --target claude --modules hooks-runtime --enable-hooks安裝后可用環(huán)境變量控制行為而不改配置ECC_HOOKS_ENABLED總開(kāi)關(guān)、ECC_HOOK_PROFILEminimal | standard | strict默認(rèn)standard、ECC_DISABLED_HOOKS按 ID 逗號(hào)分隔禁用特定鉤子例如可禁用 console 相關(guān)檢查。4. 倉(cāng)庫(kù)自身的 lint 佐證ECC 倉(cāng)庫(kù)對(duì) JS/TS 的靜態(tài)檢查基線(xiàn)見(jiàn) eslint.config.jsecmaVersion: 2022、默認(rèn)sourceType: commonjs.mjs單獨(dú)聲明為 module啟用no-unused-vars^_前綴豁免、no-undeferror與eqeqeqwarn并 ignore 了.cursor/**、workflows/**/*.workflow.*等目錄——這也解釋了為何.cursor/rules/下的規(guī)則腳本不受本倉(cāng)庫(kù) lint 約束?？梢酝茢嘁?guī)則文檔中使用正規(guī) logging 庫(kù)而非 console.log的要求最終由 ESLintno-console類(lèi)規(guī)則可自定義 Stop 鉤子雙層兜底。規(guī)則全景四條約定的完整繼承關(guān)系約定通用基線(xiàn)common-coding-style.mdTS/JS 專(zhuān)屬typescript-coding-style.md擴(kuò)展版rules/typescript/coding-style.md不可變CRITICALcreate new, never mutatespread 更新范式增加ReadonlyT參數(shù)標(biāo)注錯(cuò)誤處理顯式處理、友好信息 詳細(xì)日志、不靜默吞錯(cuò)async/await try-catchunknown收窄 logger 接口輸入校驗(yàn)邊界校驗(yàn)、快速失敗、不信任外部數(shù)據(jù)Zod schema 示例增加z.infer類(lèi)型推導(dǎo)console.log未單列生產(chǎn)禁用、用 logging 庫(kù)、Hook 自動(dòng)檢測(cè)同左類(lèi)型設(shè)計(jì)未涉及未涉及公共 API 類(lèi)型、interface/type 取舍、禁 any、Props、JSDoc小結(jié)如何把這套規(guī)則用在自己的項(xiàng)目里直接復(fù)用規(guī)則文件.cursor/rules/下common 語(yǔ)言?xún)蓪右?guī)則是純 Markdown YAML front matter可整體拷貝到目標(biāo)倉(cāng)庫(kù)的 Cursor 規(guī)則目錄globs與alwaysApply字段的組合方式全局基線(xiàn)常駐、語(yǔ)言規(guī)則按文件類(lèi)型觸發(fā)值得照搬規(guī)范 自動(dòng)化閉環(huán)ECC 的示范價(jià)值在于每條約定都有執(zhí)行器——console.log 有scripts/hooks/check-console-log.js格式化/類(lèi)型檢查有stop:format-typecheck。落地規(guī)則時(shí)同步配置對(duì)應(yīng) lint/鉤子比純文檔約束有效得多注意適用前提Hook 部分依賴(lài) Claude Code 的 hooks 機(jī)制PreToolUse/PostToolUse/Stop事件PreToolUse 可用退出碼 2 阻斷PostToolUse/Stop 只分析不阻斷且需通過(guò)install.sh --target claude --modules hooks-runtime --enable-hooks安裝以獲得按實(shí)際 Claude 根目錄重寫(xiě)的命令minimal/standard/strict三檔 profile 決定檢查嚴(yán)格度默認(rèn)standard。綜合來(lái)看.cursor/rules/typescript-coding-style.md本身是一份高度精煉的 Agent 規(guī)則四條約定覆蓋了 TS/JS 生產(chǎn)代碼中最常見(jiàn)的四類(lèi)質(zhì)量風(fēng)險(xiǎn)而 scripts/hooks/check-console-log.js、hooks/hooks.json 與 rules/typescript/coding-style.md 則分別提供了它的自動(dòng)化執(zhí)行與類(lèi)型層擴(kuò)展三者共同構(gòu)成了 ECC 規(guī)則即代碼風(fēng)格體系在 TypeScript 場(chǎng)景下的完整落點(diǎn)?！久赓M(fèi)下載鏈接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ev/ECC創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 ECC 的 TypeScript/JavaScript 編碼風(fēng)格規(guī)則：從不可變性與 Zod 校驗(yàn)到 Hook 自動(dòng)檢測(cè)
ECC 的 TypeScript/JavaScript 編碼風(fēng)格規(guī)則從不可變性與 Zod 校驗(yàn)到 Hook 自動(dòng)檢測(cè)【免費(fèi)下載鏈接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ev/ECC本篇基于 ECC 倉(cāng)庫(kù)中的 Cursor 規(guī)則文件.cursor/rules/typescript-coding-style.md展開(kāi)系統(tǒng)講解其中四條 TypeScript/JavaScript 編碼風(fēng)格約定——不可變更新、async/await 錯(cuò)誤處理、Zod 輸入校驗(yàn)與console.log禁令——的完整寫(xiě)法并結(jié)合倉(cāng)庫(kù)源碼剖析這些規(guī)則如何通過(guò) Hook 機(jī)制scripts/hooks/check-console-log.js等在 Agent 會(huì)話(huà)中自動(dòng)執(zhí)行幫助你既能在人寫(xiě)代碼時(shí)直接復(fù)用這套規(guī)范也理解其底層自動(dòng)化實(shí)現(xiàn)。規(guī)則文件的定位Cursor Rules 的通用 語(yǔ)言?xún)蓪咏Y(jié)構(gòu)ECC 倉(cāng)庫(kù)為 Cursor 提供了一組可版本化的編碼規(guī)則位于 .cursor/rules/ 目錄。該目錄下按通用common- 語(yǔ)言專(zhuān)屬兩層組織.cursor/rules/common-coding-style.mdalwaysApply: true所有語(yǔ)言共享的編碼風(fēng)格基線(xiàn)不可變性、錯(cuò)誤處理、輸入校驗(yàn)、代碼質(zhì)量清單.cursor/rules/typescript-coding-style.mdTypeScript/JavaScript 專(zhuān)屬擴(kuò)展開(kāi)頭明確寫(xiě)著 This file extends the common coding style rule with TypeScript/JavaScript specific content.。后者的 YAML front matter 定義了它的加載條件--- description: TypeScript coding style extending common rules globs: [**/*.ts, **/*.tsx, **/*.js, **/*.jsx] alwaysApply: false ---三個(gè)字段的作用字段取值含義descriptionTypeScript coding style extending common rules規(guī)則描述供規(guī)則列表檢索展示globs**/*.ts、**/*.tsx、**/*.js、**/*.jsx僅當(dāng)上下文涉及這四類(lèi)文件時(shí)觸發(fā)注入alwaysApplyfalse非全局常駐按 glob 匹配按需生效這種按文件類(lèi)型觸發(fā)的設(shè)計(jì)正是 Cursor Rules 的核心機(jī)制與alwaysApply: true的通用規(guī)則互補(bǔ)避免把 TS 專(zhuān)屬內(nèi)容塞進(jìn)每個(gè)文件的上下文中從而節(jié)省 token、減少無(wú)關(guān)干擾。核心約束一不可變更新Immutability規(guī)則文件給出的標(biāo)準(zhǔn)范式是禁止原地修改用 spread 返回新對(duì)象// WRONG: Mutation function updateUser(user, name) { user.name name // MUTATION! return user } // CORRECT: Immutability function updateUser(user, name) { return { ...user, name } }這條約束并非 TS 特有——它在 .cursor/rules/common-coding-style.md 中被標(biāo)記為CRITICAL并給出理由不可變數(shù)據(jù)能消除隱藏副作用、降低調(diào)試成本、支持安全并發(fā)。同一文件還配套了量化約束函數(shù) 50 行、文件 800 行、嵌套不超過(guò) 4 層、無(wú)硬編碼值作為標(biāo)記工作完成前的檢查清單。值得注意的是倉(cāng)庫(kù)在同一規(guī)范下存在一個(gè)擴(kuò)展版rules/typescript/coding-style.md。它在 Cursor 版的四個(gè)章節(jié)之上前置了更完整的類(lèi)型設(shè)計(jì)約定例如公共 API 顯式類(lèi)型導(dǎo)出函數(shù)必須標(biāo)注參數(shù)與返回類(lèi)型局部變量可交給推斷interface vs type可能被擴(kuò)展/實(shí)現(xiàn)的形狀用interface聯(lián)合、交叉、映射、工具類(lèi)型用type優(yōu)先字符串字面量聯(lián)合而非enum避免any外部/不可信輸入用unknown再安全收窄泛型用于類(lèi)型取決于調(diào)用方的場(chǎng)景// WRONG: any removes type safety function getErrorMessage(error: any) { return error.message } // CORRECT: unknown forces safe narrowing function getErrorMessage(error: unknown): string { if (error instanceof Error) { return error.message } return Unexpected error }React Props用命名interface定義 props、顯式標(biāo)注回調(diào)類(lèi)型、無(wú)特殊理由不用React.FC純 JS 文件在無(wú)法遷移到 TS 時(shí)用 JSDoc 表達(dá)類(lèi)型且要求 JSDoc 與運(yùn)行時(shí)行為保持一致。從源碼結(jié)構(gòu)看.cursor/rules/Cursor 側(cè)與rules/Claude/通用側(cè)兩份規(guī)則內(nèi)容高度同構(gòu)、互為鏡像ECC 通過(guò)這種雙份維護(hù)讓不同 Agent 客戶(hù)端加載各自格式的同一套規(guī)范。寫(xiě)作 TS 代碼時(shí)建議以擴(kuò)展版為完整清單先過(guò)類(lèi)型設(shè)計(jì)再過(guò)下文的四條實(shí)操約束。核心約束二async/await try-catch 錯(cuò)誤處理規(guī)則文件要求異步操作統(tǒng)一使用 async/await 配 try-catch而不是裸.then/.catchtry { const result await riskyOperation() return result } catch (error) { console.error(Operation failed:, error) throw new Error(Detailed user-friendly message) }關(guān)鍵點(diǎn)在于兩層信息分離console.error落詳細(xì)錯(cuò)誤上下文服務(wù)端/開(kāi)發(fā)側(cè)可見(jiàn)重新拋出的Error攜帶面向用戶(hù)的友好信息UI 側(cè)可見(jiàn)。這與通用規(guī)則中UI 面向代碼給友好信息、服務(wù)端記詳細(xì)上下文、絕不靜默吞錯(cuò)的要求一一對(duì)應(yīng)。擴(kuò)展版 rules/typescript/coding-style.md 把該模式升級(jí)為完整可運(yùn)行示例catch 參數(shù)標(biāo)注unknown、通過(guò)instanceof Error收窄、用可替換的生產(chǎn)級(jí) logger 接口注釋建議 pino/winston替代console.errorasync function loadUser(userId: string): PromiseUser { try { const result await riskyOperation(userId) return result } catch (error: unknown) { logger.error(Operation failed, error) throw new Error(getErrorMessage(error)) } }核心約束三Zod 模式化輸入校驗(yàn)規(guī)則文件指定 Zod 作為邊界校驗(yàn)的標(biāo)準(zhǔn)方案import { z } from zod const schema z.object({ email: z.string().email(), age: z.number().int().min(0).max(150) }) const validated schema.parse(input)配套的通用規(guī)則要求在系統(tǒng)邊界校驗(yàn)所有輸入、快速失敗、永不信任外部數(shù)據(jù)API 響應(yīng)、用戶(hù)輸入、文件內(nèi)容。擴(kuò)展版進(jìn)一步給出了類(lèi)型聯(lián)動(dòng)寫(xiě)法——用z.infer從 schema 推導(dǎo)輸入類(lèi)型使校驗(yàn)邏輯與類(lèi)型定義單一來(lái)源const userSchema z.object({ email: z.string().email(), age: z.number().int().min(0).max(150) }) type UserInput z.infertypeof userSchema const validated: UserInput userSchema.parse(input)這意味著parse成功后返回值的類(lèi)型即UserInput下游函數(shù)簽名可以直接消費(fèi)該類(lèi)型無(wú)需手寫(xiě)一遍字段聲明。核心約束四console.log 禁令與自動(dòng)檢測(cè)規(guī)則文件第四條約定生產(chǎn)代碼中不允許console.log語(yǔ)句應(yīng)使用正規(guī)的 logging 庫(kù)替代See hooks for automatic detection——即該約定不只靠人遵守而是由 Hook 機(jī)制自動(dòng)檢測(cè)。這一見(jiàn) Hook的指向在倉(cāng)庫(kù)中有完整的實(shí)現(xiàn)鏈路可以印證1. 規(guī)則側(cè)的聲明.cursor/rules/typescript-hooks.md.cursor/rules/typescript-hooks.md 與編碼風(fēng)格規(guī)則使用完全相同的globs和alwaysApply: false聲明了 TypeScript 文件相關(guān)的 HookPostToolUse配置于~/.claude/settings.jsonPrettier 編輯后自動(dòng)格式化、編輯.ts/.tsx后運(yùn)行tsc類(lèi)型檢查、對(duì)編輯文件中的console.log發(fā)出警告Stop會(huì)話(huà)響應(yīng)結(jié)束前對(duì)所有已修改文件做console.log審計(jì)。2. 實(shí)現(xiàn)側(cè)的落地check-console-log.jsStop 鉤子的實(shí)際實(shí)現(xiàn)位于 scripts/hooks/check-console-log.js。閱讀源碼可以看到幾個(gè)工程細(xì)節(jié)檢測(cè)范圍通過(guò)getGitModifiedFiles([\\.tsx?$, \\.jsx?$])只掃描本輪 git 已修改的 JS/TS 文件而非全倉(cāng)庫(kù)控制開(kāi)銷(xiāo)豁免模式EXCLUDED_PATTERNS排除了測(cè)試與腳本場(chǎng)景——.test./.spec.文件、*.config.js/ts、scripts/目錄、__tests__/、__mocks__/因?yàn)樵谶@些地方console.log往往是有意為之只警告不阻斷命中后僅log([Hook] WARNING: console.log found in ...)并提示提交前移除退出碼保持 0符合 hooks 架構(gòu)中Stop 鉤子可分析但不能阻斷的定位ECC 透?jìng)骷s定stdin 原樣回寫(xiě)到 stdoutpassThroughAndExit且設(shè)置了 1MB 的 stdin 上限——超限的截?cái)?JSON 不再回顯以免觸發(fā) harness 的 JSON 校驗(yàn)失敗源碼注釋明確指向 issue #2090。該鉤子在 hooks/hooks.json 的Stop數(shù)組中以stop:check-console-log注冊(cè)運(yùn)行于standard,strict配置檔位同一數(shù)組中還有stop:format-typecheck批量 Prettier/Biome 格式化 tsc類(lèi)型檢查注釋說(shuō)明在 Stop 時(shí)一次性運(yùn)行而非每次 Edit 后。3. 使用與開(kāi)關(guān)按 hooks/README.md 的說(shuō)明這套 Hook 不建議手工粘貼hooks.json而是通過(guò)安裝器解析安裝bash ./install.sh --target claude --modules hooks-runtime --enable-hookspwsh -File .\install.ps1 --target claude --modules hooks-runtime --enable-hooks安裝后可用環(huán)境變量控制行為而不改配置ECC_HOOKS_ENABLED總開(kāi)關(guān)、ECC_HOOK_PROFILEminimal | standard | strict默認(rèn)standard、ECC_DISABLED_HOOKS按 ID 逗號(hào)分隔禁用特定鉤子例如可禁用 console 相關(guān)檢查。4. 倉(cāng)庫(kù)自身的 lint 佐證ECC 倉(cāng)庫(kù)對(duì) JS/TS 的靜態(tài)檢查基線(xiàn)見(jiàn) eslint.config.jsecmaVersion: 2022、默認(rèn)sourceType: commonjs.mjs單獨(dú)聲明為 module啟用no-unused-vars^_前綴豁免、no-undeferror與eqeqeqwarn并 ignore 了.cursor/**、workflows/**/*.workflow.*等目錄——這也解釋了為何.cursor/rules/下的規(guī)則腳本不受本倉(cāng)庫(kù) lint 約束?？梢酝茢嘁?guī)則文檔中使用正規(guī) logging 庫(kù)而非 console.log的要求最終由 ESLintno-console類(lèi)規(guī)則可自定義 Stop 鉤子雙層兜底。規(guī)則全景四條約定的完整繼承關(guān)系約定通用基線(xiàn)common-coding-style.mdTS/JS 專(zhuān)屬typescript-coding-style.md擴(kuò)展版rules/typescript/coding-style.md不可變CRITICALcreate new, never mutatespread 更新范式增加ReadonlyT參數(shù)標(biāo)注錯(cuò)誤處理顯式處理、友好信息 詳細(xì)日志、不靜默吞錯(cuò)async/await try-catchunknown收窄 logger 接口輸入校驗(yàn)邊界校驗(yàn)、快速失敗、不信任外部數(shù)據(jù)Zod schema 示例增加z.infer類(lèi)型推導(dǎo)console.log未單列生產(chǎn)禁用、用 logging 庫(kù)、Hook 自動(dòng)檢測(cè)同左類(lèi)型設(shè)計(jì)未涉及未涉及公共 API 類(lèi)型、interface/type 取舍、禁 any、Props、JSDoc小結(jié)如何把這套規(guī)則用在自己的項(xiàng)目里直接復(fù)用規(guī)則文件.cursor/rules/下common 語(yǔ)言?xún)蓪右?guī)則是純 Markdown YAML front matter可整體拷貝到目標(biāo)倉(cāng)庫(kù)的 Cursor 規(guī)則目錄globs與alwaysApply字段的組合方式全局基線(xiàn)常駐、語(yǔ)言規(guī)則按文件類(lèi)型觸發(fā)值得照搬規(guī)范 自動(dòng)化閉環(huán)ECC 的示范價(jià)值在于每條約定都有執(zhí)行器——console.log 有scripts/hooks/check-console-log.js格式化/類(lèi)型檢查有stop:format-typecheck。落地規(guī)則時(shí)同步配置對(duì)應(yīng) lint/鉤子比純文檔約束有效得多注意適用前提Hook 部分依賴(lài) Claude Code 的 hooks 機(jī)制PreToolUse/PostToolUse/Stop事件PreToolUse 可用退出碼 2 阻斷PostToolUse/Stop 只分析不阻斷且需通過(guò)install.sh --target claude --modules hooks-runtime --enable-hooks安裝以獲得按實(shí)際 Claude 根目錄重寫(xiě)的命令minimal/standard/strict三檔 profile 決定檢查嚴(yán)格度默認(rèn)standard。綜合來(lái)看.cursor/rules/typescript-coding-style.md本身是一份高度精煉的 Agent 規(guī)則四條約定覆蓋了 TS/JS 生產(chǎn)代碼中最常見(jiàn)的四類(lèi)質(zhì)量風(fēng)險(xiǎn)而 scripts/hooks/check-console-log.js、hooks/hooks.json 與 rules/typescript/coding-style.md 則分別提供了它的自動(dòng)化執(zhí)行與類(lèi)型層擴(kuò)展三者共同構(gòu)成了 ECC 規(guī)則即代碼風(fēng)格體系在 TypeScript 場(chǎng)景下的完整落點(diǎn)?！久赓M(fèi)下載鏈接】ECCThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/ev/ECC創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考