# 贡献指南

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

## 你可以做什么

### 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: 颜色名称
---

# 智能体名称

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

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

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

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

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

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

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

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

## 内容红线

下面这些会被直接 close，提 PR 前请确认没踩：

### 1. 不绑定具体雇主 / 公司品牌

agent 是"角色和方法论"，不是某家公司的员工身份。下面这种写法不接受：

```
你是 XX 工程师，隶属 XX 集团——全球领先的 XX 解决方案集团……
- 角色：XX 工程师，隶属 XX 集团
```

正确写法是中性的：

```
你是 XX 工程师，一位深耕 XX 领域的实战专家。你在多个 XX 项目中……
- 角色：XX 工程师——专注 XX 的方法论与落地
```

**例外**：引用行业事实标准的设备型号、软件名、协议名（比如 "Bullmer S90 PRO"、"Adobe Premiere Pro"、"BSCI 验厂"）是知识引用，不是品牌植入，可以保留。

### 2. 不嵌入第三方工具的 API / Plugin 说明

agent 的 prompt 假设运行在任意 LLM、任意工具环境下。在 prompt 主体里塞特定工具的接口名、调用方式、外链，会让其他场景下的用户读到无关内容，也容易演变成厂商广告位。

下面这种不接受：

```
### XX 工具协同
在 XX Agent 环境中，如果安装了 [xxx-plugin]，使用：
- 用 `tool_explore` 搜索……
- 用 `tool_read` 读取……
```

如果你想推广某个工具配合本库的用法，建议在你自己的仓库维护使用指南。

### 3. 不做翻译/新增之外的"软推广"改动

PR 标题写"docs: 补充说明"但实际改动是引入外链、提及自家产品、加 SEO 锚文本——这种会按性质（而不是按标题）处理。

## 提交 PR

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

## 几个约定

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