Skip to main content
当前 CLI 接受单个文件，不接受 .cursor/rules 目录。它也没有 Cursor 专用 parser，不解释 glob、alwaysApply、frontmatter 优先级或多文件合并语义。

​
单文件导入

对一个 .mdc 文件，可以使用通用 Markdown importer：
.mdc 后缀不会触发专用行为。CLI 读取文本、按通用标题/内容规则生成 style、commands、risk 或 source layer，并写入 ImportNeedsReview=True。

​
不支持目录导入

下面的旧写法当前不可用：
原因是 input 必须是一个可读文件。对于多个 rule 文件有两种保守方案：
  1. 每个文件导入为独立 Profile，逐个 validate 和 review。
  2. 手工合并为一个 Profile，并把每条原文保留在独立 layer 的 content 中。
当前 CLI 没有 Profile merge 命令。不要声称它会自动保留 Cursor 的 rule precedence。

​
schema 边界

Profile.spec.layers[] 当前只定义：
每个 layer 必须有 name，并至少包含 data 或 content。appliesTo、source、globs 不是 layer 顶层协议字段。 如果项目需要保留 Cursor metadata，可以把原始 frontmatter 留在 content，或放入项目私有 data。后者只是项目数据，不应被描述成 Huoban 标准语义。

​
手工合并检查

合并后的 Profile 至少检查：
  • 每条 rule 原文仍可追溯到来源文件。
  • glob 与作用域没有被通用 importer 错误简化。
  • 相互冲突的 rules 没有被静默覆盖。
  • 风险与权限规则进入独立 Policy。
  • 对本地文件或远程 context 的运行时依赖进入 Profile.spec.requirements。
然后运行：

​
导出边界

当前 CLI 没有 --to cursor-rules。唯一支持的 export target 是 AGENTS.md。保留原始 Cursor Rules，直到有真实 round-trip workflow 和可验证 fixture 支持更强声明。

​
下一步