https://github.com/diet103/claude-code-infrastructure-showcase
Claude Code 的 Skill 有一个很实际的问题：文件明明写好了，Claude 却不一定记得调用。
少量 Skill 还好，我们可以在提示词里点名。等项目里积累了前端规范、后端规范、测试规则、错误处理和安全检查，再靠人记住“这次应该先加载哪一份”，很快就会乱。
最近看到的 Claude Code Infrastructure Showcase，主要就是解决这个问题。它不是一个可以直接运行的应用，而是一套参考配置，里面放着作者长期使用的 Hooks、Skills、Agents 和开发文档方法。需要哪部分，就复制到自己的项目里再改。
写这篇文章时，这个仓库在 GitHub 已有约 9800 个 Star。README 介绍称，这套东西来自一个使用了半年的 TypeScript 微服务项目，涉及 6 个微服务、5 万多行 TypeScript，以及 React 前端。至少从目录和配置来看，它确实不是几份临时拼起来的 Prompt。
Skill 为什么写了却不触发
Skill 本质上是一份给 AI 看的工作说明。它可以告诉 Claude，写接口时采用什么分层，改 React 组件时遵守哪些约定，碰到数据库操作时先检查什么。
问题在于，Claude Code 不会因为项目里存在这份文件，就保证每次都主动读取。Skill 越多，这种“有规则但没加载”的情况越常见。
这个仓库的做法，是在 Skill 前面加一层触发系统。
每次用户提交提示词时，UserPromptSubmit Hook 会读取 skill-rules.json，根据关键词、意图正则、当前文件路径和代码内容，判断哪些 Skill 与任务有关。如果某项规则只是建议，就提醒 Claude 使用；如果被设成必须执行的 guardrail，Claude 在加载对应 Skill 之前尝试修改文件，PreToolUse Hook 会先拦一次。
这样一来，规则不再只靠 Claude“自觉”。提示词负责判断需求，文件路径负责补充现场信息，Hook 则把加载 Skill 变成工作流的一部分。
默认不需要再接一个大模型
这套触发机制默认使用关键词和正则匹配，可以离线运行，也不需要 API Key。比如提示词里出现 controller、Prisma、API endpoint，或者正在编辑后端目录里的 TypeScript 文件，就可以提示加载后端开发规范。
如果规则越来越多，单靠关键词不够用，也可以开启 AI 分类模式。项目支持 Gemini、OpenAI、Anthropic 和 Ollama；其中 fallback 模式会优先进行语义判断，调用失败时再退回正则，不至于因为网络或 API Key 出问题把整个提示流程卡住。
我觉得默认用正则是比较稳妥的。自动触发系统如果过于“聪明”，很容易每个任务都弹出一长串 Skill，最后又变成新的干扰。仓库也提供 strict、balanced 和 aggressive 三档，用来控制建议的积极程度。
大 Skill 不再一股脑塞进上下文
仓库里的另一个思路，是把 Skill 写成主文件加资源文件。
主 SKILL.md 尽量控制在 500 行以内，只放入口、规则和导航。路由、数据库、测试、错误处理等细节拆到 resources/ 目录，需要时再读取。README 把它叫做“渐进披露”。
这比把几千行规范全部塞进一个 Skill 更适合真实项目。Claude 先知道总体做法，碰到具体问题再读对应章节，可以少占上下文，也方便单独维护某一块规则。
不过“500 行”更像写作原则，不是仓库里每个文件都严格达标。README 也承认，少数深度文档目前超过了这个长度。
复杂任务交给专门 Agent
除了 4 个示例 Skill，仓库还提供了 8 个专门 Agent，包括架构审查、重构规划、前端错误修复、文档生成和 TypeScript 错误处理。
Skill 和 Agent 的分工很清楚。Skill 是 Claude 当前工作时随手查阅的规范，Agent 则适合有明确终点的独立任务，例如“审查所有 Controller 的架构一致性”或者“先给这次重构做一份完整计划”。
这些 Agent 大多是独立的 Markdown 文件，可以按需复制。不过有些文件可能带有示例路径，放进自己的项目之前仍要检查。
上下文被重置，也知道上次做到哪里
长任务还有一个常见麻烦：Claude Code 的上下文一旦压缩或重置，前面讨论过的决定、进度和待办很容易丢。
这个仓库没有试图靠更长的上下文硬扛，而是把项目状态写进磁盘上的三份文档：
plan.md：总体方案和实施阶段；context.md：关键决定、相关文件和当前进度；tasks.md：可勾选的任务清单与验收条件。
新会话先读这三份文件，就能恢复大部分工作现场。仓库还配了 /dev-docs 和 /dev-docs-update 命令。更进一步的会话索引与向量检索属于可选功能，需要另外配置，不能简单理解为复制文件后所有上下文都会自动永久保存。
可以一键安装，但不适合闭眼复制
项目提供了安装向导：
git clone https://github.com/diet103/claude-code-infrastructure-showcase.git
cd claude-code-infrastructure-showcase
npx tsx setup.ts ~/my-project向导会复制 .claude/ 目录、识别技术栈、安装 Hook 依赖，并在结束前运行 8 项检查。作者估计，基础集成大约需要 15 到 30 分钟。
但这个时间更适合“先跑起来”，不代表所有配置都能原样用于自己的项目。仓库里的前端规范针对 React、MUI v7 和 TanStack，后端示例偏 Node.js、Express、Prisma 和 Sentry。几个 Stop Hook 还假设项目采用特定的 TypeScript 多服务目录，不修改就可能误判，甚至影响 Claude 正常结束任务。
Windows 用户也需要注意，Hook 使用 Bash，README 要求在 WSL2 下运行，普通的 cmd 或 PowerShell 不能直接套用。
比较保险的方式，是先给自己的项目提交一次 Git 基线，再运行向导或逐项复制，随后检查 git diff。现有的 settings.json 和 skill-rules.json 应该合并，不要直接覆盖。涉及 npm install 和自动执行 Hook 的代码，也值得先看一遍再启用。
真正值得抄的是结构
这套参考库最有价值的地方，不是里面那几份 React 或 Express 规范。技术栈不同，具体示例很快就不适用了。
更值得拿走的是它的结构：用 skill-rules.json 管触发条件，用 Hooks 做提醒和约束，把大 Skill 拆成可按需读取的资源，再用落盘的开发文档保存长任务状态。
这些做法并不会让 Claude Code 突然变聪明，但能减少几种很烦人的失误：规则写了却没读、上下文重置后重新摸索、复杂任务全挤在一个会话里，以及项目规范只能靠人反复提醒。
仓库采用 MIT 许可证。最近的版本还加入了 Codex 的 Skills 镜像和 Hook 适配，不过部分能力仍有差异。无论用 Claude Code 还是 Codex，都不建议把整套目录不加判断地搬走。先抄自动触发和开发文档这两个骨架，再慢慢换成自己的规范，可能更实用。
