第三章：杂项技能完全指南

杂项技能完全指南

杂项技能是一些聚焦的小工具：给 git 加护栏、迁移测试断言、搭建练习骨架、配置提交前检查。它们不属主线，但能显著提升仓库与内容工作流的安全与质量。

本章技能一览

下列 4 个杂项技能偏工具向，常作为仓库安全层或内容工作流的一部分。

git-guardrails-claude-code：git 危险操作护栏

git-guardrails-claude-code 给 Claude Code 装上钩子，在执行 push、reset --hard、clean、branch -D 等危险 git 命令前先拦下来。适合想防止代理误执行破坏性 git 操作的团队。

migrate-to-shoehorn：迁移 as 断言

migrate-to-shoehorn 把测试里的 as 类型断言迁移到 @total-typescript/shoehorn，让部分测试数据更安全、类型更准。适合想摆脱 as 投机取巧的 TypeScript 项目。

scaffold-exercises：搭建练习目录

scaffold-exercises 一键生成练习目录结构：含小节、题目、解答与讲解，且能通过 lint。适合做课程、教程或培训材料的人快速起骨架。

setup-pre-commit：提交前钩子

setup-pre-commit 在当前仓库配置 Husky 的 pre-commit 钩子，串起 lint-staged（Prettier）、类型检查与测试，让每次提交前都自动格式化、查类型、跑测试。

返回总览：总览与方法论