质量与评审
refactoring-guard
更新于 2026-09-28
Refactoring 工程规则
Refactoring rules: characterisation tests before structural change
- 技术栈
- Refactoring
- 主题
- 工程基线
- 条目
- 9 条
- 版本
- v0.2.0
✓ 应当这么做
- ✓ Enable strict mode everywhere and treat TypeScript strict flags as non-negotiable in new files
- ✓ Handle every promise: await it, return it, or attach a .catch with a real recovery path
- ✓ Model uncertain data as `unknown` and narrow it with type guards before use
✕ 常见反模式
- ✕ Floating promises (async calls fired without await or catch)
- ✕ `any` casts used to silence a type error instead of fixing the shape
- ✕ Mutating function arguments or module-level objects from shared scope
◎ 交付前验证
- ◎ Typecheck (`tsc --noEmit` or equivalent) passes with zero errors
- ◎ Lint passes and no rule was disabled inline
- ◎ Node/browser runtime compatibility checked against the project engines field
同分类条目
11 篇质量与评审
Static Analysis 工程规则
Static analysis rules: treat warnings as errors for new code and justify exceptions
质量与评审
Code Review 工程规则
Review rules: risk-first reading, bounded diffs and reproducible verification
质量与评审
Legacy Modernisation 工程规则
Legacy rules: strangler-fig slices with a measurable seam
质量与评审
Error Budget 工程规则
Reliability rules: error budgets gate feature work, not opinions