用途:当用户提供一份 CLAUDE.md 文件或要求改进它时,按本技能的原则和结构重写该文件,提升 Claude Code 对其中指令的遵循程度。
背景问题:Claude Code 会为每个 CLAUDE.md 注入系统提醒,其中说该上下文“可能相关也可能不相关……除非高度相关,否则不应回应”。因此与当前任务无关的内容越多,Claude 越可能忽略整份文件,包括真正重要的部分。
解决方式:用 <important if="condition"> XML 标签包裹条件相关的段落,借助与系统提示相同的 XML 标签模式给出明确的相关性信号。
主要原则:
- 基础上下文(项目身份、目录结构、技术栈)不加包裹,保持纯 Markdown 放在文件顶部;仅对特定任务才重要的领域指引才加 <important if> 包裹。
- 条件必须具体、聚焦,避免过宽条件(如“你在写任何代码”应拆成添加导入、创建组件、新增文件等各自独立的窄触发条件)。
- 保持简短,尽量内联,不轻易拆分为需要工具调用才能发现的独立文件。
- 少即是多:删除可由 linter、formatter、pre-commit 钩子强制执行的规则;删除可从现有代码模式中发现的规则;删除会过时的代码片段,改用文件路径引用。
- 保留原文件中的所有命令,命令表作为基础参考放入单个 <important if> 块。
输出结构:文件顶部为一行项目身份说明,随后是保持裸露的 Project map;命令表置于一个条件块中;每条规则或每个领域段(测试、API 约定、状态管理等)各自拥有针对性的条件块。
应用步骤:提取项目身份一句话置于顶部;保留目录映射(裸露);保留技术栈(如有);保留全部命令并包入单个块;把成组规则拆为各自条件块(可分组但不可把无关规则并入宽泛条件);为各领域段设置条件;删除 linter 领域内容、代码片段和含糊指令(如“遵循最佳实践”),并建议改用 pre-push 或 pre-commit 钩子。
限制:官方资料未提供收费、价格、平台支持范围或量化效果等信息,相关事实暂未提供。