在 Cursor 中使用你的 AgentSoul 文件

要在 Cursor 里使用 AgentSoul 灵魂，把四个文件加进项目，再通过项目根目录的 AGENTS.md 把它们接上——Cursor 会把这个文件当作智能体指令来读。想要更多控制，可以新建一条始终生效的项目规则，写入灵魂的精华。无论哪种方式，Cursor 的智能体在每次请求前都会知道它是谁、你是谁、你喜欢怎么工作。

开始之前

先在干将 iPhone App 里用闪电熔铸或高导熔铸一个灵魂，或在网页 agentsoul.market 上完成。在结果页点“获取四个文件”，再点“发送到电脑”，隔空投送到 Mac、存储到“文件”，或用邮件发给自己。最终，运行 Cursor 的那台电脑上应当有 soul.md、identity.md、user.md、agents.md 四个文件。

方式一：项目根目录的 AGENTS.md

1. 在仓库里建一个存放灵魂的文件夹，把四个文件复制进去。
2. 在项目根目录新建 AGENTS.md，或打开已有的那个。
3. 加一节“智能体人格”，用几行话概括 soul.md 的核心：性情、最看重的几项价值、会在什么事上提出异议。
4. 从 user.md 里摘两三行，说明你喜欢的回答方式，比如先给结论再讲推理。
5. 粘贴 agents.md 中的步骤和升级规则，删掉与写代码无关的部分。
6. 注明完整文件所在的文件夹路径，需要细节时你或智能体都能打开查看。

AGENTS.md 有个实际的好处：它是多款编码智能体都会寻找的通用约定，同一个文件就能把你的灵魂带到不同工具里。AgentSoul 生成的文件名是小写的 agents.md，而根目录的惯例是大写，所以请新建 AGENTS.md，不要指望原文件名被识别。

方式二：项目规则

Cursor 的项目规则存放在项目内部，可以设为始终生效、相关时自动生效，或只在你提到时生效。在 Cursor 设置里新建一条项目规则，取名如“agent soul”，设为始终生效，粘贴 soul.md 和 user.md 的精简人格。agents.md 的流程可以单独做成第二条规则，只在你需要时调用——这样人格处处都在，而逐步执行的剧本只用于较大的任务。

保持精简

始终生效的指令会随每一次请求发送。完整的 AgentSoul 文件也是写给人看的，包含不少智能体不必每次都读的解释。效果最好的是一个紧凑版本：一段性格描述、五条左右排好序的价值、你希望被怎样称呼与对话、什么时候该停下来问你。完整文件留在仓库里，作为随时回看的参考。

与团队共享灵魂

AGENTS.md 和项目规则都存放在仓库里，所以每个打开项目的人都会得到同一个智能体。团队想要一个风格一致的代码审查者或结对伙伴时，这很有用；但这也意味着一个人的偏好会变成所有人的默认设置，所以要想清楚哪些部分适合共享。soul.md、identity.md、agents.md 描述的是智能体本身，适合共享；user.md 描述的是某个具体的人，放在你自己的用户级设置里，或不放进共享仓库，让每位队友补充自己的版本。

测试效果

• 开一个新对话，请智能体描述它的工作风格。它应该听起来像你的灵魂，而不是一个泛泛的助手。
• 让它做一次有风险的重构，看它是否按灵魂里写的护栏提出顾虑。
• 如果某个特质碍事——太谨慎、话太多——就改掉那一行。文件归你所有。

你的结果是 AI 生成的假设，不是诊断。把它当作一份做工扎实的智能体初稿，再在写代码的过程中慢慢打磨。