From 7343f607b6fe8efbfa14d445f77e1f3cbc133d3b Mon Sep 17 00:00:00 2001 From: Dawn <3434359910@qq.com> Date: Fri, 6 Mar 2026 18:08:26 +0800 Subject: [PATCH] =?UTF-8?q?Update=20and=20rename=20=E5=9C=A8=E4=BD=A0?= =?UTF-8?q?=E7=9A=84=E4=BB=93=E5=BA=93=E9=87=8C=EF=BC=8C=E6=96=B0=E5=BB=BA?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E6=96=87=E4=BB=B6=E5=8F=AB=20CONTRIBUTING=5F?= =?UTF-8?q?zh-CN.md=20to=20CONTRIBUTING=5Fzh-CN.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Translated the contribution guide to help the Chinese community. --- CONTRIBUTING_zh-CN.md | 154 ++++++++++++++++++ ...„ä»“åº“é‡Œï¼Œæ–°å»ºä¸€ä¸ªæ–‡ä»¶å« CONTRIBUTING_zh-CN.md | 1 - 2 files changed, 154 insertions(+), 1 deletion(-) create mode 100644 CONTRIBUTING_zh-CN.md delete mode 100644 åœ¨ä½ çš„ä»“åº“é‡Œï¼Œæ–°å»ºä¸€ä¸ªæ–‡ä»¶å« CONTRIBUTING_zh-CN.md diff --git a/CONTRIBUTING_zh-CN.md b/CONTRIBUTING_zh-CN.md new file mode 100644 index 0000000..7cd5008 --- /dev/null +++ b/CONTRIBUTING_zh-CN.md @@ -0,0 +1,154 @@ + +# 贡献指å—:为 The Agency åšå‡ºè´¡çŒ® + +首先,感谢你考虑为 The Agency åšå‡ºè´¡çŒ®ï¼æ­£æ˜¯å› ä¸ºæœ‰åƒä½ è¿™æ ·çš„人,æ‰è®©è¿™å¥— AI 智能体(Agents)集å˜å¾—更好。 + +📋 **目录** + +* [行为准则](https://www.google.com/search?q=%23%E8%A1%8C%E4%B8%BA%E5%87%86%E5%88%99) +* [我能如何贡献?](https://www.google.com/search?q=%23%E6%88%91%E8%83%BD%E5%A6%82%E4%BD%95%E8%B4%A1%E7%8C%AE) +* [智能体设计规范](https://www.google.com/search?q=%23%E6%99%BA%E8%83%BD%E4%BD%93%E8%AE%BE%E8%AE%A1%E8%A7%84%E8%8C%83) +* [Pull Request (PR) æµç¨‹](https://www.google.com/search?q=%23pull-request-%E6%B5%81%E7%A8%8B) +* [风格指å—](https://www.google.com/search?q=%23%E9%A3%8E%E6%A0%BC%E6%8C%87%E5%8D%97) +* [社区](https://www.google.com/search?q=%23%E7%A4%BE%E5%8C%BA) + +--- + +## 📜 行为准则 + +æœ¬é¡¹ç›®åŠæ‰€æœ‰å‚与者å‡å—我们的行为准则约æŸã€‚å‚与时,请éµå®ˆä»¥ä¸‹å‡†åˆ™ï¼š + +* **ä¿æŒå°Šé‡**ï¼šå°Šé‡æ¯ä¸€ä¸ªäººã€‚鼓励å¥åº·çš„辩论,但ç»ä¸å®¹å¿äººèº«æ”»å‡»ã€‚ +* **包容性**:欢迎并支æŒå„ç§èƒŒæ™¯å’Œèº«ä»½çš„人。 +* **å作精神**:我们共åŒåˆ›é€ çš„东西比独自创造的更好。 +* **ä¿æŒä¸“业**:让讨论èšç„¦äºŽæå‡æ™ºèƒ½ä½“和社区。 + +--- + +## 🎯 我能如何贡献? + +### 1. 创建新智能体 (Create a New Agent) + +有特定领域智能体的创æ„å—ï¼Ÿå¤ªæ£’äº†ï¼æ·»åŠ æ–¹æ³•å¦‚ä¸‹ï¼š + +1. **Fork 本仓库**。 +2. **选择åˆé€‚的类别**(或æè®®æ–°ç±»åˆ«ï¼‰ï¼š +* `engineering/` - 软件开å‘专家 +* `design/` - UI/UI åŠåˆ›æ„专家 +* `marketing/` - 增长与è¥é”€ä¸“å®¶ +* `product/` - 产å“管ç†ä¸“å®¶ +* `project-management/` - 项目管ç†ä¸Žå调专家 +* `testing/` - QA 与测试专家 +* `support/` - è¿è¥ä¸Žæ”¯æŒä¸“å®¶ +* `spatial-computing/` - AR/VR/XR 专家 +* `specialized/` - 无法归类到其他地方的独特专家 + + +3. **按照下方模æ¿**创建你的智能体文件。 +4. **在真实场景中测试**你的智能体。 +5. **æäº¤ Pull Request (PR)**。 + +### 2. 改进现有智能体 + +* 添加真实世界的示例和用例。 +* 使用现代模å¼ä¼˜åŒ–代ç ç¤ºä¾‹ã€‚ +* æ ¹æ®æ–°çš„æœ€ä½³å®žè·µæ›´æ–°å·¥ä½œæµã€‚ +* 添加æˆåŠŸæŒ‡æ ‡ï¼ˆSuccess Metrics)和基准。 +* ä¿®å¤é”™åˆ«å­—ã€æå‡æ¸…晰度ã€å®Œå–„文档。 + +### 3. 分享æˆåŠŸæ•…äº‹ + +在 GitHub Discussions 中å‘布心得,或在 README 中添加案例研究。 + +### 4. 报告问题 (Issue) + +å‘现问题了å—?请告诉我们:æä¾›æ¸…æ™°çš„å¤çŽ°æ­¥éª¤ï¼Œå¹¶é™„å¸¦ä½ çš„ä½¿ç”¨èƒŒæ™¯ã€‚ + +--- + +## 🎨 智能体设计规范 + +æ¯ä¸ªæ™ºèƒ½ä½“文件都应éµå¾ªä»¥ä¸‹ç»“构: + +```markdown +--- +name: 智能体åç§° +description: 一å¥è¯æè¿°è¯¥æ™ºèƒ½ä½“的专长和é‡ç‚¹ +color: 颜色å称或 "#å六进制代ç " +--- + +# 智能体åç§° + +## 🧠 身份与记忆 +- **角色 (Role)**: 清晰的角色æè¿°ã€‚ +- **性格 (Personality)**: 性格特å¾ä¸Žæ²Ÿé€šé£Žæ ¼ã€‚ +- **记忆 (Memory)**: 智能体需è¦è®°ä½å’Œå­¦ä¹ çš„内容。 +- **ç»éªŒ (Experience)**: 领域专业知识与视角。 + +## 🎯 核心使命 +- 具有明确产出物的核心èŒè´£ 1ã€2ã€3。 +- **é»˜è®¤è¦æ±‚**: 始终开å¯çš„æœ€ä½³å®žè·µã€‚ + +## 🚨 å¿…é¡»éµå®ˆçš„硬性规则 +定义智能体方法的领域特定规则和约æŸã€‚ + +## 📋 技术产出物 (Technical Deliverables) +智能体产出的具体示例:代ç ç¤ºä¾‹ã€æ¨¡æ¿ã€æ¡†æž¶ã€æ–‡æ¡£ã€‚ + +## 🔄 å·¥ä½œæµæµç¨‹ (Workflow Process) +1. 第一阶段:探索与研究 +2. 第二阶段:规划与策略 +3. 第三阶段:执行与实现 +4. 第四阶段:å¤ç›˜ä¸Žä¼˜åŒ– + +## 💭 沟通风格 +语气ã€å¸¸ç”¨çŸ­è¯­æ¨¡å¼ç­‰ã€‚ + +## 🎯 æˆåŠŸæŒ‡æ ‡ (Success Metrics) +* é‡åŒ–指标(带数字) +* 定性指标 +* 性能基准 + +``` + +--- + +## 🔄 Pull Request (PR) æµç¨‹ + +### æäº¤å‰ + +* **测试你的智能体**:在真实场景中使用,并根æ®å馈进行迭代。 +* **éµå¾ªæ¨¡æ¿**ï¼šä¸ŽçŽ°æœ‰æ™ºèƒ½ä½“çš„ç»“æž„ä¿æŒä¸€è‡´ã€‚ +* **添加示例**:包å«è‡³å°‘ 2-3 个代ç /模æ¿ç¤ºä¾‹ã€‚ +* **校对**ï¼šæ£€æŸ¥é”™åˆ«å­—ã€æ ¼å¼é—®é¢˜å’Œæ¸…晰度。 + +### æäº¤ PR 步骤 + +1. **Fork** 仓库。 +2. **创建分支**:`git checkout -b add-agent-name`。 +3. **æäº¤æ›´æ”¹**:`git commit -m "Add [Agent Name] specialist"`。 +4. **推é€**:`git push origin add-agent-name`。 +5. **å¼€å¯ PR**:标题清晰(如 "Add [Name] - [Category]"),并æè¿°å…¶ç”¨é€”和测试情况。 + +--- + +## ðŸ“ é£Žæ ¼æŒ‡å— + +* **具体化**:写“å‡å°‘ 60% 加载时间â€ï¼Œè€Œä¸æ˜¯â€œåŠ å¿«é€Ÿåº¦â€ã€‚ +* **务实**:包å«çœŸå®žå¯ç”¨çš„代ç ï¼Œè€Œä¸æ˜¯ä¼ªä»£ç ã€‚ +* **æ ¼å¼åŒ–**:始终使用 Markdown;章节标题加入 Emoji 方便扫æï¼›ä»£ç ç¤ºä¾‹ä½¿ç”¨ä»£ç å—。 + +--- + +## 🌟 è£èª‰æ¦œ + +åšå‡ºé‡å¤§è´¡çŒ®çš„å‚与者将: + +* 列入 README 的致谢åå•。 +* 在å‘布说明(Release Notes)中被é‡ç‚¹ä»‹ç»ã€‚ +* 有机会在“本周智能体â€ä¸­å±•示。 + +--- + +🎉 **谢谢你ï¼** +无论你是添加新智能体ã€ä¿®å¤ Bug 还是分享故事,你都在让 The Agency å˜å¾—æ›´å¥½ã€‚è°¢è°¢ï¼ diff --git a/åœ¨ä½ çš„ä»“åº“é‡Œï¼Œæ–°å»ºä¸€ä¸ªæ–‡ä»¶å« CONTRIBUTING_zh-CN.md b/åœ¨ä½ çš„ä»“åº“é‡Œï¼Œæ–°å»ºä¸€ä¸ªæ–‡ä»¶å« CONTRIBUTING_zh-CN.md deleted file mode 100644 index 8b13789..0000000 --- a/åœ¨ä½ çš„ä»“åº“é‡Œï¼Œæ–°å»ºä¸€ä¸ªæ–‡ä»¶å« CONTRIBUTING_zh-CN.md +++ /dev/null @@ -1 +0,0 @@ -