Claude md that follows

CloudMD 学习笔记

一、 CloudMD 文件管理原则

• 核心问题： CloudMD 文件过长 → Cloud 遵循指令的可靠性降低。
• 硬性规则处理： 绝对规则（如禁止推送到 main）不应放在 CloudMD 中，而应放在预工具使用钩子 (pre-tool use hook) 中。
• 维护原则： 将 CloudMD 视为生产代码。若无法证明某条规则的必要性，则删除它。
• 最终目标： 文件越精简 (lean)，Cloud 遵循的程度越高。

二、 CloudMD 的存储层级与作用范围

• 加载顺序： Cloud 会加载所有记忆文件，且托管策略 (Managed Policy) 始终优先。
• 存储层级 (从高到低)： 托管策略 → 用户文件 → 项目文件 → 本地 (Local)。
• 本地 (Local) 的用途： 用于项目特定的、个人层面的架构决策（例如，冲刺后的重构），不应放在共享的项目文件中。

三、 提高指令清晰度的技巧

• 文件组织： 使用文件路径语法 (path to file syntax) 来拆分和组织指令。
• 导入的局限性： 导入的文件会在启动时展开（in line），它们有助于组织，但不能减少上下文加载量。
• 规则撰写原则： 规则必须具体且可检查。避免使用模糊的措辞（如“遵循最佳实践”）。
• 具体化指令： 必须明确要求（例如：“每份文件放置一个新 API 路由和源 API 处理程序”）。
• 导出命名： 必须使用命名导出 (named exports)，而非默认导出 (default exports)，以消除潜在的歧义。
• 强调使用： 强调 (emphasis) 是有限的预算，应只用于最关键的规则。

四、 故障处理

• 错误报告： 当 Cloud 执行错误时，应将其视为针对 CloudMD 文件的 Bug 报告，并将其修正后的规则添加到 CloudMD 中。

Takeaways

• CloudMD 的核心原则是文件越精简 (lean)，Cloud 遵循指令的程度越高。
• 存储层级从高到低为：托管策略 → 用户文件 → 项目文件 → 本地，托管策略拥有最高优先级。
• 规则撰写必须具体且可检查，严禁使用模糊措辞（如“遵循最佳实践”）。
• 为消除歧义，指令应使用文件路径语法进行组织，并必须使用命名导出 (named exports)。
• 绝对硬性规则不应放在 CloudMD 中，而应通过预工具使用钩子 (pre-tool use hook) 来处理。