用途:为超出单一 CLAUDE.md 承载能力的项目提供模块化指令管理方案,解决指令文件膨胀、查找困难和多团队规则冲突问题。
主要能力:
- 拆分时机判断:仅在文件超过约 300 行、多团队需要不同指令、或查找规则耗时过长时拆分,默认保持单文件。
- 根文件作为索引:拆分后根 CLAUDE.md 只保留通用规则与指向详细文件的引用,形同目录。
- 自动发现:Claude Code 会自动读取 .claude/ 目录下的文件,可据此放置指令文件。
- 四种拆分模式:按关注点(架构、编码标准、测试、API、数据访问、部署)、按模块(每个模块一个 CLAUDE.md)、按团队(.claude/teams/ 下)、按条件加载(“Load When Working On...”映射任务域到文件)。
- 优先级:根 CLAUDE.md > .claude/instructions/*.md > 模块级 CLAUDE.md > 团队级文件;同一主题只能有一个归属文件。
必要用法要点:
- 拆分只能沿单一维度进行:按关注点、按模块或按团队,不可混用。
- 根文件需列出所有指令文件及其范围,否则 Claude 可能不知道它们存在。
- 冲突处理:根文件与模块冲突时根文件优先;根未涉及则模块规则在其范围内生效;两个模块文件互相矛盾只在各自模块内适用。
适用场景:.NET/C# 等大型解决方案、模块化单体、多团队协作、规则难以定位的项目。
限制:未提供官方发布渠道、收费或价格信息,暂未提供。资料未说明除 Claude Code 之外的其他平台支持情况,暂未提供。反模式包括过早拆分、跨文件指令冲突、无索引拆分和混合拆分维度。