Tai-ch0802 Lint 與驗證技能
必要： 每次程式碼變更後執行適當的驗證工具。在程式碼無錯誤之前不要完成任務。
各生態系程序
Node.js / TypeScript
- Lint/修復：
npm run lint或npx eslint "path" --fix - 型別：
npx tsc --noEmit - 安全：
npm audit --audit-level=high
Python
- Linter (Ruff)：
ruff check "path" --fix（快速且現代） - 安全 (Bandit)：
bandit -r "path" -ll - 型別 (MyPy)：
mypy "path"
品質迴圈
- 撰寫/編輯程式碼
- 執行稽核：
npm run lint && npx tsc --noEmit - 分析報告： 檢查「最終稽核報告」區塊。
- 修復並重複： 提交帶有「最終稽核」失敗的程式碼是不允許的。
錯誤處理
- 如果
lint失敗：立即修復樣式或語法問題。 - 如果
tsc失敗：在繼續之前修正型別不匹配。 - 如果沒有工具配置：檢查專案根目錄是否有
.eslintrc、tsconfig.json、pyproject.toml並建議建立一個。
嚴格規則： 未通過這些檢查的程式碼不應被提交或報告為「完成」。
腳本
| 腳本 | 用途 | 指令 |
|---|---|---|
scripts/lint_runner.py |
統一 lint 檢查 | python scripts/lint_runner.py <project_path> |
scripts/type_coverage.py |
型別覆蓋率分析 | python scripts/type_coverage.py <project_path> |