docs(CONTRIBUTING): 新增内容红线章节

明确三类会被直接 close 的 PR:绑定具体雇主/公司品牌、在 prompt 主体
嵌入第三方工具的 API/Plugin 说明、以翻译或新增为名的软推广改动。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
AI不止语
2026-06-19 00:49:47 +08:00
parent ef446efedd
commit 6a05b7c11d
+41
View File
@@ -59,6 +59,47 @@ 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 本仓库