我往 rule 目录丢了 6 个规则文件,才发现一个都没生效

举报
yd_250058965 发表于 2026/11/01 22:06:45 2026/11/01
【摘要】 之前用 CodeArts 干活,踩过的坑不少:GitHub 下载慢、沙箱里网络被拦、检索工具用错、GitCode 路径踩雷。每次踩完,我就把解决方法写成一个 markdown 文件放进 ~/.codeartsdoer/rule/ 目录,想着下次 agent 读到规则就不会再犯。陆陆续续攒了六条:GitHub 下载走镜像前缀、Python 和 npm 的包源换国内镜像、沙箱里哪些域名直连连不通...

之前用 CodeArts 干活,踩过的坑不少:GitHub 下载慢、沙箱里网络被拦、检索工具用错、GitCode 路径踩雷。每次踩完,我就把解决方法写成一个 markdown 文件放进 ~/.codeartsdoer/rule/ 目录,想着下次 agent 读到规则就不会再犯。

陆陆续续攒了六条:GitHub 下载走镜像前缀、Python 和 npm 的包源换国内镜像、沙箱里哪些域名直连连不通、查网络优先用 Tavily、GitCode 镜像路径不能想当然、DevKit 写操作必须走审批流。

每条规则一个 markdown 文件,文件名起得挺规范。放进目录,我就默认它生效了。

直到有一阵子发现不对劲。明明写了「查网络信息优先用 Tavily」,agent 还是随手 curl 网页;写了「沙箱直连 GitCode 会被拦」,它还是会先去连一次再失败。当时以为是模型没遵守,压根没往「文件有没有被加载」上想。

后来翻官方文档才看到关键一句:~/.codeartsdoer/rule/ 下的裸 .md 文件不会被加载。

CodeArts 认规则的方式跟我想的不一样——要在界面里创建(设置 → 技能与规则 → 个人级 → 新建规则),创建后会生成两个文件:<规则名>.mdc 和 metadata.properties。前者装规则正文,后者是一段 JSON,记录规则的名称、描述、内容和启用状态。没有这份元数据,目录里的 .md 就是普通文本,没人读。

于是我把六条规则整理成一条「个人开发环境与工具链约定」:合并了网络加速、包源、沙箱限制、检索优先级、GitCode 边界、DevKit 操作六块内容,删掉原来的六个 .md,在界面里新建规则、贴入正文、保存。

这次立竿见影。再让它查网络,它开着手就先去看规则。

顺带搞清楚了几个点:

  1. AGENTS.md 是另一条通道(公测中):个人级放在 ~/.codeartsdoer/AGENTS.md,注意是根目录,不是 rule/ 下,不需要 .mdc 和元数据
  2. 规则有优先级:云端企业级 > 云端团队级 > 本地项目级 > 本地个人级 > 云端个人级——同一件事写得不一样时,听最高优先级的
  3. 技能和规则的加载方式不一样:技能靠 UserSkillStatus.txt 里一行 名字=true 注册;规则靠界面生成的元数据。都是「往目录里放文件」,但机制完全不同

这件事给我的教训很直接:放对了目录,不等于放对了格式。 我当时按「markdown 放进去就行」的直觉操作,六条规则白写了一个月。后来跟人聊,发现踩这个坑的不止我一个——大家都以为 rule/ 目录是自动扫描的。

现在我的规则就一条,覆盖原来六条的全部内容,而且确定是生效的。每次改完配置,我都会想办法验证它真的被加载了,而不是改完就以为改好了。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。