SuperAPI AI 工具集

claude-md-writer

智能体与模型

查看项目

更新于 10-15 19:56

技能介绍

用途:帮助创建、审阅和改进 CLAUDE.md 系列文件(全局、项目级、本地),使其真正被 Claude Code 遵循。核心理念是“每行都要有价值”,因为 CLAUDE.md 每轮对话都会加载并消耗上下文 token。

主要能力:

  1. 说明 CC 加载 CLAUDE.md 的顺序与优先级:托管策略 → 用户全局(~/.claude/CLAUDE.md + ~/.claude/rules/)→ 项目逐级向上查找(./CLAUDE.md、./.claude/CLAUDE.md、./.claude/rules/)→ 本地(./CLAUDE.local.md)→ 通过 CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD 追加的目录;子目录内的 CLAUDE.md 在触及该目录文件时懒加载。CLAUDE.md 会在 /compact 后从磁盘重新读取并重新注入,纯对话中的指令则会丢失。支持 @path/to/file 导入,最多 5 跳,相对路径以导入文件为基准。
  2. 给出体积目标:全局与项目 CLAUDE.md 建议不超过 120 行(项目约 2500 token),CLAUDE.local.md 不超过 50 行,MEMORY.md 不超过 200 行或 25KB,硬上限为 40K 字符(超出 CC 会警告)。文件越短遵循度越好,超过 200 行后指令遵循度明显下降。
  3. 分节模板与正反例:全局文件按身份、技术栈、工作流、技能、MCP、LSP、规则组织;项目文件按标题、命令、架构、关键文件、代码风格、测试、陷阱、技能与扩展组织;并提供命令表、注释目录树、可验证的代码风格、非显而易见的陷阱等写法示例。
  4. 去重边界:项目文件不得重复全局内容(工作流、身份、技术栈、编码规则);通用项目约定放 CLAUDE.md,文件路径专属约定放 .claude/rules/。
  5. 强调手段与质量评分:可少量使用 IMPORTANT、YOU MUST 等强调词;按命令与工作流、架构清晰度、非显而易见模式、简洁度、时效性、可操作性各 15–20 分进行评分,并列出红旗项(会失败的命令、引用已删文件、过时技术版本、通用建议、未完成的 TODO、跨文件重复信息)。

使用方式与限制:本资料为技能说明,未给出具体安装命令或调用示例,相关命令暂未提供。使用时需结合实际项目发现内容填写,不写可从代码推断或经 Glob/LS 即可发现的信息,不写安装步骤(应放 README),避免跨文件规则冲突,因为冲突时 Claude 的选择是任意的。