给 Claude Code 配一套 .NET + Angular 项目规则：模板加插件把关键约束变成钩子

作者在 .NET + Angular 项目里反复重写同一套 Claude Code 配置，于是把它做成公开模板 claude-config：按文件类型自动加载的规则模块，加一个 kit 插件把最关键的几条变成强制钩子。文章给出了模块划分、五条核心规则、插件拦截清单和安装命令，读完可以直接照搬。

规则按模块拆分，按需加载

• 规则放在 .claude/rules/ 目录，Claude Code 会自动加载，所以是复制进每个项目，而不是全局安装。
• core.md、git.md、security.md 始终加载，分别覆盖技术栈与测试、分支与提交发布、认证与密钥与输入校验（含 OWASP Top 10 2025、ASVS 5.0）。
• frontend.md 只在 *.ts、*.html、*.css、*.scss 上加载，管 Angular；backend.md、backend-architecture.md、backend-app.md 在 C# 和项目文件上加载，管 .NET；docker.md 管 Dockerfile 和 Compose。
• 可选模块（邮件、基础设施、功能工作流）放在 .claude/rules-optional/，按项目开启。规则用意大利语写，代码、标识符和 commit message 保持英文。

真正起作用的是这五条

• 一次只问一个问题，并等回答。
• 默认只做本地提交；push、PR、tag、release 都需要显式批准，批准结果按项目记在 CLAUDE.md 里。
• 任何实质性工作先写计划文件，再逐步执行；每一步要等 build 和测试通过才打勾。
• 对迭代快的库，去查当前安装版本的文档，不要凭记忆写。
• 宣布完成之前先 build 和 test，报错原样上报。

kit 插件：把建议变成钩子

• 写下来的规则只是建议，插件把最重要的几条做成 hook 强制执行。
• 每个 prompt 提醒一次只问一个问题，并检查 AskUserQuestion 调用里只允许一个问题。
• shell 命令守卫永久拦截 git init、force push、删除远程分支、git reset --hard、git clean -f、--no-verify 和强制递归删除；push、打 tag、gh pr create/merge、gh release 在项目批准前保持拦截；git status、git log、gh pr view 这类只读命令放行。
• 还有针对密钥和 Claude 所写文件里不安全模式的守卫、Docker 与依赖与前端代码的质量检查、会话开始时提供计划和需重读规则的钩子，以及会话中检测规则变更和模板漂移的 watcher。
• 插件在 2026 年 11 月从 kit-config 改名为 kit，命令因此挂在 /kit: 前缀下。当前版本 1.8.0，只在发版时变版本号。

安装与在项目里落地

• 每台机器装一次：先 claude plugin marketplace add AngeloDotNet/claude-config，再 claude plugin install kit@claude-config。
• 装过旧 kit-config 的，装好 kit 后卸掉 kit-config 并重启 Claude Code，因为钩子只在会话启动时加载。
• 新项目：复制规则和 CLAUDE.md 模板，填好项目字段，再让 Claude 开始。
• 已有项目没规则：用 Git only 模式，只保留 core 和 git 两个模块。已有项目有规则：更新到最新模板版本。
• 架构、ORM、数据库、多租户、ASVS 等级这些项目特定选择，会先问再一次性记进 CLAUDE.md，不做假设。copia-regole.bat 负责复制规则和根文件，也能更新已有规则。

已知未验证项

• 模板里有些细节还没验证，比如 PostgreSQL 行级安全的语法、.NET 10 上 ASP.NET Core Identity 的 passkey 支持。
• 哪些没验证写在模板 changelog 的说明里，用之前先对照自己所用版本文档核对。