命名规范审查 通用提示词模板:任何对话助手都能直接用
如果你在代码仓库与终端里反复做命名规范审查,可以考虑把经验沉淀为一个 Skill:写清触发条件、步骤、输出格式和边界,让智能体代劳重复部分,人只负责把关。
不是每个人都有能装技能的智能体平台。下面这份提示词可以直接粘贴到任何对话助手中使用,效果接近技能版本,只是需要每次手动粘贴。
可复制的提示词
# 角色
你是一名熟悉命名规范审查的助手,服务对象是开发者。
# 任务
按团队命名约定检查变量、函数、文件命名并给出改名建议。
# 输入
我会提供:代码 diff 或目录。如果缺少关键信息,请先列出问题,不要自行编造。
# 步骤
1. 读取命名约定
2. 扫描新增符号
3. 对照约定判断
4. 输出建议并标注影响面
# 输出
命名问题列表与建议名称。使用清晰的小标题,最后单独列出“需人工确认”的内容。
# 约束
- 改动前确认有测试与版本控制,一次只改一类问题。
- 信息不足时先提问,不要自行编造数据或事实。
# 材料
(在这里粘贴你的内容)
用法
- 复制整段提示词,把材料粘贴到最后
- 第一次使用时附一份你认可的范例,告诉助手“参考这个格式”
- 对输出不满意时,指出具体哪一步有问题,而不是笼统地说“再改改”
- 把调好的提示词保存在笔记里,下次直接用
和技能版的区别
提示词版本每次都要手动粘贴,长对话中后半段可能逐渐偏离要求;技能版由平台自动加载,适合高频使用。如果你每周都要用好几次,建议升级为技能,参考快速上手。
小技巧
- 把“输出”部分改成表格表头,能显著提高格式稳定性
- 材料很长时先让助手复述理解,再开始处理
- 风险较低,但输出仍需快速过目再使用
交付物结构示例
建议把命名问题列表与建议名称固定成下面的结构(示意),方便复核与归档:
## 结论
一句话说明最重要的发现或结果
## 主要内容
- 读取命名约定:……
- 扫描新增符号:……
- 对照约定判断:……
- 输出建议并标注影响面:……
## 依据
- 引用输入中的具体位置或数据
## 需人工确认
- ……(没有则写“无”)
结构固定之后,复核的人只要先看“结论”和“需人工确认”两部分,就能快速判断结果能否使用。
平台选择建议
同一个「命名规范审查」技能可以落在不同平台上,选择时主要看你在哪里工作、要不要执行代码、要不要接外部系统:
- MCP 服务:MCP(模型上下文协议)是一个开放协议。详见MCP 服务 版
- n8n AI Agent:n8n 是可自托管的工作流自动化工具。详见n8n AI Agent 版
- Cursor Rules:Cursor 用项目规则(Project Rules)给智能体注入长期指令。详见Cursor Rules 版
这个技能纯指令型,不需要额外脚本或外部连接,复制到大多数平台都能用,可据此排除不支持相应能力的平台。
延伸阅读
说明:文中的配置、代码与目录结构均为示意,用于说明思路;各平台的入口、字段名与能力会更新,落地前请以对应官方文档为准。示例中的数据与场景为虚构,不代表真实案例。