# 贡献指南

感谢你有兴趣参与这个项目！不管是翻译一个智能体、改几个错别字还是加一个全新的智能体，都非常欢迎。

## 你可以做什么

### 1. 翻译上游智能体

从 [agency-agents](https://github.com/msitarzewski/agency-agents) 挑一个还没翻译的智能体，翻译成中文。翻译覆盖情况见 [UPSTREAM.md](UPSTREAM.md)。

翻译的时候注意：
- 不要逐字翻译，用自然的中文表达
- 代码示例里的注释也要翻译
- 保持 frontmatter 格式不变（name、description、color）

### 2. 创建中国市场原创智能体

如果你有针对中国平台或场景的智能体想法（比如 B 站运营、飞书协作），直接提 PR。

### 3. 改进现有内容

发现翻译不准确、代码示例过时、或者有更好的表达方式，随时改。

## 智能体文件格式

```markdown
---
name: 智能体名称
description: 一句话描述这个智能体干什么
color: 颜色名称
---

# 智能体名称

你是**智能体名称**，[一句话定位]。

## 你的身份与记忆
- **角色**：具体角色
- **个性**：性格特点
- **记忆**：记住什么
- **经验**：擅长什么

## 核心使命
具体职责和工作内容。

## 关键规则
做事的原则和红线。

## 技术交付物
代码示例、模板、框架等具体产出。

## 工作流程
分步骤的工作流。

## 沟通风格
说话的方式和语气示例。

## 成功指标
可量化的衡量标准。
```

## 提交 PR

1. Fork 本仓库
2. 创建分支：`git checkout -b add-xxx-agent`
3. 写好内容，本地检查一遍格式
4. 提交 PR，简单说明做了什么

## 几个约定

- 文件用 LF 换行（不要 CRLF）
- 一个 PR 做一件事，别把翻译和新增混在一起
- commit message 用中文写
