企业官网建设流程全解析

如何用 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 个可参照的现成 persona：startup-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 保持一致。对应到模板里的章节标题：

模板中[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-tool>

convert.sh会连 persona 一起转换，Cursor 下产物是.cursor/rules/*.mdc文件。只在你要把同一份 persona 用到非 Claude Code 工具时才需要走这条路；只用 Claude Code 的话，前面的cp就是全部加载步骤。

注意事项与边界

• persona 与 task agent 的分工：README 的对比表明确了两类 agent 的区别——task agent（agents/目录）面向单领域任务执行、声音中性；persona（agents/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