我往 rule 目录丢了 6 个规则文件,才发现一个都没生效
之前用 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,在界面里新建规则、贴入正文、保存。
这次立竿见影。再让它查网络,它开着手就先去看规则。
顺带搞清楚了几个点:
- AGENTS.md 是另一条通道(公测中):个人级放在
~/.codeartsdoer/AGENTS.md,注意是根目录,不是 rule/ 下,不需要 .mdc 和元数据 - 规则有优先级:云端企业级 > 云端团队级 > 本地项目级 > 本地个人级 > 云端个人级——同一件事写得不一样时,听最高优先级的
- 技能和规则的加载方式不一样:技能靠
UserSkillStatus.txt里一行名字=true注册;规则靠界面生成的元数据。都是「往目录里放文件」,但机制完全不同
这件事给我的教训很直接:放对了目录,不等于放对了格式。 我当时按「markdown 放进去就行」的直觉操作,六条规则白写了一个月。后来跟人聊,发现踩这个坑的不止我一个——大家都以为 rule/ 目录是自动扫描的。
现在我的规则就一条,覆盖原来六条的全部内容,而且确定是生效的。每次改完配置,我都会想办法验证它真的被加载了,而不是改完就以为改好了。
- 点赞
- 收藏
- 关注作者
评论(0)