第 7 篇:定制你的 AI 助手, 让 Agent 更懂你

⏱️ 阅读时间：约 20 分钟
🎯 本节你将学会：理解 AI 的"人设"是怎么设定的、写一份角色设定文件、创建不同用途的 AI 角色

为什么需要给 Agent 定义角色？

你买了一把多功能瑞士军刀，但真正让你成为大厨的，不是刀，而是厨师。

同样的模型、同样的算力，为什么有的 AI 回答像专家，有的像路人？区别就在于角色定义。

没有角色定义的 AI：

你问代码问题，它给你写一段能跑但没人看得懂的"天书"
你让它写文案，它给你来一段"在当今这个快速发展的时代……"
你让它总结笔记，它把原文照搬一遍

有了角色定义的 AI：

编程助手给你的代码有注释、有类型、有测试
写作助手给你的文案有标题、有排版、有 emoji
学习助手给你的总结有提纲、有类比、有练习题

角色定义 = 你给 AI 的一份"岗位说明书"。写得好，AI 就干得好。

想快速找个角色？

Github 开源项目有 266 个角色 agency-agents-zh

仓库地址：https://github.com/jnMetaCode/agency-agents-zh

网盘备用：https://pan.baidu.com/s/1hk3q-hie5dkHAigpVVB5OA?pwd=jwwu

什么是系统提示词（System Prompt）？

类比"给员工的岗位说明书"

你雇了三个员工：

写作助手：负责写文案、润色文章
编程助手：负责写代码、查 bug
学习助手：负责总结笔记、出题测试

你会给每个员工一份"岗位说明书"。里面写清楚：你是谁、会什么不会什么、怎么说话、遇到任务怎么做。

系统提示词就是 AI 的岗位说明书。你写得好，AI 就干得好。

一个好的角色设定文件长什么样？

模板拆解

一个完整的角色设定包含 4 个部分：

# 角色定义你是谁？你的身份是什么？# 能力范围你会什么？不会什么？# 行为规范你怎么说话？什么风格？遵循什么原则？# 工作流程遇到任务你该怎么做？步骤是什么？

实操：创建三个不同角色的 AI

角色一：写作助手

适用场景：写小红书文案、公众号文章、邮件、报告

# 角色定义你是一个专业的内容创作助手，擅长写小红书文案、公众号文章、营销文案。# 能力范围✅ 你会：- 写各种风格的文案（活泼、专业、幽默……）- 优化已有文案，让它更吸引人- 根据目标受众调整语气和用词- 提供标题建议和封面文案❌ 你不会：- 写代码- 做数学题- 提供医疗/法律等专业建议# 行为规范- 用中文回答，除非用户要求用其他语言- 语气亲切自然，像朋友聊天一样- 多用短句，少用长句- 适当使用 emoji（但不超过每段 2 个）- 不说"作为 AI"、"我无法"之类的话# 工作流程1. 先理解用户的需求和目标受众2. 如果信息不够，主动询问（最多问 3 个问题）3. 给出 2-3 个不同风格的版本供选择4. 根据用户反馈修改，直到满意

角色二：编程助手

适用场景：写代码、查 bug、解释代码、代码审查

# 角色定义你是一个资深编程助手，擅长 Python、JavaScript、HTML/CSS 等主流语言。# 能力范围✅ 你会：- 写代码（从简单脚本到复杂应用）- 解释代码在做什么- 查找和修复 bug- 优化代码性能和可读性- 写测试用例❌ 你不会：- 帮你部署服务器（但可以指导你）- 提供商业建议- 做设计工作# 行为规范- 用中文回答，代码注释可以用英文- 代码要带注释，解释关键步骤- 先给完整代码，再解释原理- 如果不确定，诚实说"我不确定"- 不说教，不啰嗦# 工作流程1. 理解需求，确认技术栈2. 给出解决方案（先思路，后代码）3. 提供可运行的完整代码4. 解释关键部分5. 如果有多种方案，说明各自的优缺点

角色三：学习助手

适用场景：总结笔记、生成复习提纲、出题测试、解答疑问

# 角色定义你是一个耐心的学习助手，擅长帮助人们理解和记忆知识。# 能力范围✅ 你会：- 总结长篇内容，提取重点- 生成复习提纲和思维导图- 出选择题、填空题、简答题- 用类比和例子解释复杂概念- 根据遗忘曲线安排复习计划❌ 你不会：- 帮你写作业（但可以指导思路）- 提供考试答案- 做设计或编程工作# 行为规范- 用中文回答，语言通俗易懂- 多用生活中的例子解释抽象概念- 鼓励用户思考，不直接给答案- 每次总结不超过 500 字（除非用户要求更长）- 适当提问，帮助用户巩固记忆# 工作流程1. 理解用户的学习目标和当前水平2. 用"费曼技巧"解释：用最简单的话说清楚3. 给出关键知识点总结4. 出 3-5 道练习题检验理解5. 根据用户回答，指出不足并补充

⚠️ 角色设定的常见误区

误区1：写太长了反而效果差

长度	效果	建议
太短（< 50 字）	AI 不知道你要什么	❌ 不够具体
适中（200-500 字）	AI 理解准确，行为稳定	✅ 推荐
太长（> 1000 字）	AI 可能忽略部分内容	❌ 重点被淹没

200-500 字是最优长度。再短 AI 抓不住重点，再长 AI 会忽略后半段.

误区2：越具体越好？不一定！

过度约束	问题
"每次回答必须 300 字"	AI 可能为了凑字数说废话
"必须用 5 个 emoji"	显得不自然
"每段必须以'首先、其次、最后'开头"	太死板，像机器人

给方向，不给死规则。比如"回答简洁明了"比"每次回答不超过 200 字"更好。

误区3：角色冲突

如果同时给 AI 多个矛盾的角色设定：

"你是幽默的" vs "你是严肃专业的"
"用口语化语言" vs "使用专业术语"

AI 会困惑，效果变差。

一个角色只做一件事。需要多个功能？创建多个角色。

🎯 如何测试你的角色设定？

测试清单

测试项	方法	通过标准
角色一致性	连续问 5 个问题	AI 始终保持人设
能力边界	问超出能力范围的问题	AI 诚实拒绝，不编造
响应速度	正常对话	30 秒内回复（取决于模型）
语言风格	观察回答语气	符合设定风格

快速测试模板

你好，我是你的 [角色名称]。请告诉我你需要什么帮助？测试问题1：[与角色相关的问题]测试问题2：[另一个相关问题]测试问题3：[超出能力范围的问题，看 AI 是否拒绝]

📦 本节成果

✅ 你理解了系统提示词的作用（AI 的"岗位说明书"）
✅ 你学会了角色设定的 4 个部分（角色定义、能力范围、行为规范、工作流程）
✅ 你创建了三个不同角色的 AI（写作助手、编程助手、学习助手）
✅ 你知道角色设定的常见误区和测试方法

🔧 真实案例：OpenClaw 与 Hermes 的角色配置文件

以上三个模板是通用的。在实际工作中，你系统里已经有几个真实在用的角色配置文件，可以直接打开看看：

工具	文件说明	路径
OpenClaw / OpenCode	全局角色设定	`~/.config/opencode/AGENTS.md`
OpenClaw / OpenCode	项目级角色设定	`项目根目录/CLAUDE.md`
Hermes Agent	核心灵魂（SOUL）	`~/.hermes/SOUL.md`
Hermes Agent	多角色扩展（支持多个 work profile）	`~/.hermes/profiles/<角色名>/SOUL.md`

💡 打开看看：OpenClaw 的 AGENTS.md 和 Hermes 的 SOUL.md 就是按照本文"角色定义→能力范围→行为规范→工作流程"四个部分写的。读完本文再去看这些文件，你会发现每一行都有对应的设计意图。

参考来源

System Prompt 最佳实践：https://www.promptingguide.ai
CLAUDE.md 规范：https://docs.anthropic.com/claude/docs/claude-code
Hermes Agent 角色设定：https://hermes-agent.nousresearch.com