QClaw自定义Prompt指南：编写高质量代码生成指令的实用技巧

在QClaw这类工具中生成代码，最让人头疼的莫过于拿到一段看似功能正确，却充斥着格式混乱、依赖缺失或语法不规范问题的“半成品”。这背后的症结，往往不在于模型能力，而在于指令的模糊性。要让AI输出可直接运行的高质量代码，关键在于对提示词进行精准约束。下面这五个经过实践验证的方法，或许能帮你彻底解决这个问题。

一、明确任务动词与语言环境

首先得给AI划清行动边界。方法很简单：在提示词开头，使用强动词并锁定运行时上下文。这能直接激活QClaw内部的特定语法解析器，避免它进行天马行空的“自由创作”。

具体操作有三步：第一，指令开头必须使用“生成”、“编写”、“输出”、“实现”这类明确的动作词，像“帮忙”、“建议”、“参考”这类模糊词汇要坚决摒弃。第二，紧接着用括号注明具体的编程语言和版本，比如“(Python 3.11)”或“(TypeScript 5.4)”。第三，如果对执行环境有要求，一并加上，例如“(无需用户交互)”或“(兼容Linux与macOS)”。这三板斧下去，模型的输出范围就被牢牢锁定了。

二、结构化注入输入-输出契约

光有边界还不够，还得告诉AI具体要做什么。把原始需求转化为清晰、可验证的输入输出映射关系，是杜绝冗余代码和隐式逻辑的最佳方式。

你可以这样构建契约：以“输入：”开头，明确定义所有参数来源，比如“输入：一个字符串列表，元素为URL路径”。然后，以“输出：”开头，严格限定返回值的形态，例如“输出：一个字典，键为域名，值为该域名下URL数量”。如果需要多个输出项，用分号隔开即可，比如“输出：HTTP状态码；输出：响应头Content-Type；输出：响应体前100字符”。有了这份“合同”，AI生成代码时就会直奔主题。

三、嵌入负向排除指令

知道要做什么很重要，知道不能做什么同样关键。通过显式禁止一些常见的错误模式，可以大幅压缩模型的“犯错”空间。

建议在提示词的末尾，专门设置一个禁令区。格式可以统一为“禁止……；禁止……；仅……”。这里有几个高频的禁止项供你参考：禁止使用虚构的函数名或模块名；禁止引入任何外部依赖（比如出现pip install、require等指令）；以及，最关键的一条——仅输出纯代码文本，不包含任何解释性文字、Markdown标记或示例调用。这样一来，你拿到手的，就是干净、纯粹的代码块。

四、绑定最小化系统提示

有时候，代码质量不高是因为AI“太热心”了，总想给你补充解释和推理过程。要解决这个问题，需要从系统层面给它“降降温”。

进入QClaw主界面右上角的「设置」→「高级提示配置」。在这里，关闭「启用完整系统角色设定」的开关，然后在「自定义系统提示」框中粘贴这样一段话：你是一个严格遵循用户即时指令的本地AI执行体；不添加解释、不推测意图、不生成示例；仅输出必需结果。 点击「应用」并重启Agent进程，这个轻量级的系统提示就会生效，让AI变得更加“言简意赅”。

五、封装为可复用Skill模板

最后，一个好用的指令当然不能每次重写。将验证有效的提示词固化为可复用的技能模板，是提升效率的终极法宝。

操作路径很清晰：在QClaw安装目录的skills子文件夹里，新建一个文件夹（例如命名为code_gen_python）。然后，在这个文件夹内创建SKILL.md文件。文件首行写入技能名称，从第二行开始，写入完整的提示词（注意用纯文本格式）。为了更直观，你还可以插入一行分隔符【示例开始】，后面附上一个输入输出的实际例子。保存之后，在微信里发送“/use:code_gen_python”指令，就能直接调用这个技能了，真正做到一劳永逸。