Claude Code 配置指南

解决的问题

团队引入 Claude Code 后，AI 很容易“自由发挥”：审查深度不一致、提交前少跑检查、敏感信息可能被带出仓库。规范若只写在 Wiki 或口口相传，AI 不会自动遵守。

技能如何工作

它把工程规范拆成四类可执行约束：

• 命令：把高频操作固化为 /review、/test 这类 slash command。
• 钩子：在写文件或提交前自动跑 lint、密钥扫描，提前拦截问题。
• 子代理：定义安全审查员、测试员等角色，让分工和上下文更清楚。
• 项目规则：用规则文件约定风格、禁止项和默认行为。

落地顺序是先做“最高频的 3 条命令 + 1 条提交前钩子”，跑顺后再扩展。团队规范写入项目规则文件，新人克隆即可获得同一套约束。

适用边界与注意点

钩子必须轻、快、少误报；否则团队会禁用，安全网反而失效。规则不要写得太细太死，否则 AI 会束手束脚。它适合已有 lint、测试、密钥扫描等基础流程的团队，不能替代 CI、权限管理和审计。