先说几个核心判断

当百度Comate生成的代码总是跑偏，别急着反复改提示词。也别指望手动修修补补就能解决问题。

AI没读过你的项目规约，它默认拿通用经验来输出。真正有效的做法，是让它先看懂规矩，再干活。

让Comate主动读规约文件

操作其实不复杂，按下面几步走就行。

第一步：确认目录结构

确认项目根目录下存在 【.comate/rules/】 目录。里面至少要有 ai.mdc 和 basic/basic.mdc 这两个文件。

缺一个，Comate就会跳过规约加载，直接走它的默认逻辑——那基本等于白忙。

第二步：触发规格化开发

在IDE里右键点任意源码文件，选「Comate」→「Run with Spec Mode」。

这一步是强制让Comate进入规格化开发流程，它会自动挂载 .comate/rules/ 下所有基础层规则。说白了，就是告诉它：别自由发挥，按规矩来。

第三步：检查状态栏提示

关键点在于：看底部状态栏有没有出现「Spec Active: basic.mdc loaded」的提示。

如果没出现，说明规则根本没生效。这时候得检查 .comate/rules/basic/basic.mdc 文件的编码——是不是UTF-8？带BOM头的话，Comate解析会失败。这坑踩过的人不少。

快速验证规约是否起效

怎么知道规矩真的被读进去了？两个方法很实用。

方法一：用注释触发测试

在空函数上方写一句 // 禁止使用 exit(1)，然后按 Ctrl+Alt+C 让Comate生成实现。

如果生成的代码里仍然出现 exit(1)，那就说明 basic.mdc 里的错误处理规则要么没加载，要么声明方式有问题。这个验证方法简单直接，一测便知。

方法二：检查commit message格式

做一次代码变更，然后调出Comate的「Generate Commit Message」功能。

合格的输出应该像 feat(calculator): add pow operator 这样，有类型、有范围、有描述。

如果出来的是 update 或 fix bug 这种随意的写法，说明 code-quality.mdc 里的commit规范根本没生效。这事儿不能含糊，规范就是规范。

修复场景层遗漏步骤

有时候规约文件都配好了，Comate还是没按预期工作——问题可能出在场景层。

举个栗子，你要新增一个运算符，对应的 workflow 文件是 add-operator.mdc。如果这个文件不存在，Comate不会自动帮你补全switch分支，也不会更新测试文件，更不会生成配套的测试用例。它不会猜你要做什么，必须你明确告诉它。

解决方案分三步：

第一，定位当前任务类型

比如新增运算符，那对应的workflow就是 add-operator.mdc。如果文件不存在，就需要手动创建。

第二，创建workflow文件

在 .comate/rules/workflow/ 目录下创建 add-operator.mdc，内容要包含明确的执行清单。比如：

• ① 修改 calculator.c：在switch中添加新case，并调用对应函数
• ② 在 tools/ 目录下新增幂运算实现函数
• ③ 更新 test_calculator.c，覆盖正数、负数、零三种输入
• ④ 提交前运行 make test 并确保通过

第三，显式选择workflow

这也是很容易被忽略的一步：在执行任务前，右键 →「Comate」→「Select Workflow」→ 选择 add-operator。这一步不可跳过，【Comate 不会自动推断任务类型，必须显式指定】。

这是整个流程中最容易出bug的地方。很多人以为自己配好了就万事大吉，结果Comate根本没被激活对应的workflow。

总结

说到底，让Comate写出符合规范的代码，核心就一句话：把规矩摆在它面前，让它先读、再干。

流程虽然多几步，但一旦跑通，后续的代码质量会稳定很多。这活儿值得花时间。