如何用 agents/personas/TEMPLATE.md 编写自定义 persona 并加载到 Claude Code【免费下载链接】claude-skills380 Claude Code skills agent skills plugins (30 Agents, 70 custom commands, 380 skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8 more coding agents — engineering, marketing, product, compliance, C-level advisory, research, business operations, commercial finance, and your daily productivity skills.项目地址: https://gitcode.com/GitHub_Trending/cla/claude-skills如果你已经用惯了仓库里的现成 agent但希望 Claude Code 里有一个像你团队那样思考和说话的固定角色——有背景设定、有硬性规则、有固定工作流——那么 persona 就是为此设计的。claude-skills 仓库的 agents/personas/README.md 将 persona 定义为超越使用这些 skills的 agent 定义它不仅指定能力还定义角色的身份与记忆、核心使命、不可违反的规则、分领域能力、多步工作流、带具体例子的沟通风格、成功标准以及按需加载的进阶能力。本文的任务是以 agents/personas/TEMPLATE.md 为格式规范编写一份自定义 persona 文件并按仓库文档给出的路径把它加载到 Claude Code 中用一句话激活。仓库本身提供 3 个可参照的现成 personastartup-cto.md、growth-marketer.md、solo-founder.md。TEMPLATE.md 的结构frontmatter 加九个正文章节persona 文件由两部分组成文件头部的 YAML frontmatter和按固定顺序组织的正文章节。frontmatter 字段agents/personas/README.md 的 Creating Your Own 一节给出 frontmatter 规格--- name: Agent Name description: What this agent does and when to activate it. color: blue # Agent color theme emoji: # Single emoji identifier vibe: One sentence personality capture. tools: Read, Write, Bash, Grep, Glob ---各字段在文档中的用途name是 agent 名称description用一段话说明这个 agent 做什么、面向谁、何时激活color是颜色主题emoji是单个 emoji 标识符vibe是一句话概括人格tools是可用工具列表。对照现成文件 agents/personas/startup-cto.md其description写法值得参考先描述角色背景再写 Use when... 说明激活时机并在括号中指向同类但不同定位的 agent如(For company-scale CTO strategy, see cs-cto-advisor.)避免角色职责重叠。正文章节顺序TEMPLATE.md 要求正文遵循固定的九段结构README 原话Identity → Mission → Rules → Capabilities → Workflows → Communication → Metrics → Advanced → Learning与现有 persona 保持一致。对应到模板里的章节标题章节要写什么 Your Identity Memory角色、3-5 个性格形容词、这个角色长期记住什么、具体的经历背景 Your Core Mission按优先级分组的使命区域模板给出 3 组每组列关键职责 Critical Rules You Must Follow按类别分组的硬性约束格式为**规则名**规则说明 Your Core Capabilities按能力领域分组列出子能力与说明 Your Workflow Process每个工作流以When: [触发条件]开头后接编号步骤步骤中要体现交付物或决策点 Your Communication Style用[模式]: [该角色实际说话的示例]给出具体口吻例子 Your Success MetricsYoure successful when: 后列可衡量的结果 Advanced Capabilities按需加载的更深专长 Learning Memory需要长期保留的知识类别以及 Pattern Recognition 部分要识别的模式模板中[Role description]、[3-5 adjectives that define communication style]这类方括号占位符全部需要你替换成自己 persona 的实际内容模板里的# Agent Name Agent Personality一级标题同样按你的角色名改写。写完整体后可以直接对照 agents/personas/startup-cto.md 检查语气每个章节都是具体、可判断的内容而不是空泛的形容词。加载到 Claude Code编写完成后agents/personas/README.md 给出的 Claude Code 加载方式是把 persona 文件复制到~/.claude/agents/然后对话中用自然语言激活。以仓库自带的 startup-cto 为例cp agents/personas/startup-cto.md ~/.claude/agents/ # Then: Activate startup-cto mode换成你自己写的 persona做法相同把文件保存后复制进~/.claude/agents/再按同样的方式说 Activate 你的persona名 mode。文件名即激活时引用的名称保持与name字段一致的短横线命名如startup-cto.md。文档没有给出复制后的独立检查命令因此以激活后的对话行为为准如果 Claude 开始以你定义的角色口吻Communication Style 中写的模式回应并遵守 Critical Rules 中的约束说明加载生效。与其他工具的加载路径可选分支README 同时给出两个面向其他工具的入口自定义 persona 同样适用./scripts/convert.sh --tool cursor # Personas convert to .cursor/rules/*.mdc或者使用通用安装入口./scripts/install.sh --tool your-toolconvert.sh会连 persona 一起转换Cursor 下产物是.cursor/rules/*.mdc文件。只在你要把同一份 persona 用到非 Claude Code 工具时才需要走这条路只用 Claude Code 的话前面的cp就是全部加载步骤。注意事项与边界persona 与 task agent 的分工README 的对比表明确了两类 agent 的区别——task agentagents/目录面向单领域任务执行、声音中性personaagents/personas/面向跨领域的角色扮演、带背景和人格。文档建议两者并存聚焦任务用 task agent长期协作用 persona。自定义 persona 时不要把它写成又一份任务清单否则应改用 task agent 格式。不要与/persona命令混淆仓库的 commands/persona.md 是一个生成 UX 用户画像demographics、goals、pain points的命令与这里的 agent persona 加载流程无关。frontmatter 之外没有额外注册步骤文档给出的 Claude Code 加载路径只有复制到~/.claude/agents/ 对话激活没有配置文件或注册命令不要在文章或操作之外自行添加安装步骤。模板、格式说明与现成示例分别在 TEMPLATE.md、agents/personas/README.md 和 agents/personas/startup-cto.md写作时以这三份文件为唯一格式依据即可。【免费下载链接】claude-skills380 Claude Code skills agent skills plugins (30 Agents, 70 custom commands, 380 skills, customizable references, scripts)for Claude Code, Codex, Gemini CLI, Cursor, and 8 more coding agents — engineering, marketing, product, compliance, C-level advisory, research, business operations, commercial finance, and your daily productivity skills.项目地址: https://gitcode.com/GitHub_Trending/cla/claude-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考