Update nexus wiki content
This commit is contained in:
@@ -2,43 +2,45 @@
|
||||
title: "为 The Agency 贡献代码"
|
||||
type: source
|
||||
tags: []
|
||||
date: 2026-04-24
|
||||
date: 2026-04-27
|
||||
---
|
||||
|
||||
## Source File
|
||||
- [[raw/Agent/agency-agents/CONTRIBUTING_zh-CN.md]]
|
||||
- [[Agent/agency-agents/CONTRIBUTING_zh-CN.md]]
|
||||
|
||||
## Summary(用中文描述)
|
||||
- 核心主题:**The Agency**(agency-agents)项目的贡献者指南,定义智能体(Agent)设计规范、贡献流程和社区标准
|
||||
- 问题域:AI 智能体系统的标准化设计、社区协作与质量保障
|
||||
- 方法/机制:YAML frontmatter 元数据 + 分层结构化文档模板;通过 Pull Request 流程和 PR 模板实现质量把控;通过智能体设计原则(性格塑造、交付物定义、指标量化)确保智能体质量
|
||||
- 结论/价值:提供可操作的智能体设计框架,降低社区贡献门槛,同时通过规范保证生态一致性
|
||||
- 核心主题:The Agency 智能体(Agent)项目的开源贡献指南——涵盖行为准则、贡献方式、智能体设计规范、PR 提交流程和风格指南
|
||||
- 问题域:如何为 AI 智能体集合项目贡献新的或改进的专家智能体,包括设计原则、结构模板、质量标准
|
||||
- 方法/机制:通过 YAML frontmatter 定义智能体元数据,通过分章节结构(身份/使命/规则/交付物/工作流/学习/指标)规范智能体设计,通过 PR 模板确保贡献质量
|
||||
- 结论/价值:提供了一套完整的智能体贡献生态——从创意生成到真实场景测试再到社区评审,标准化了 AI 专家智能体的创建流程
|
||||
|
||||
## Key Claims(用中文描述)
|
||||
- 优秀智能体必须具备鲜明性格,拒绝"通用型有用助手"人设
|
||||
- 智能体应提供可量化的成功指标,而非模糊描述
|
||||
- 每个智能体必须经过真实场景测试和迭代优化
|
||||
- 贡献者通过 PR 流程和社区评审确保智能体质量
|
||||
- 贡献智能体需满足:鲜明性格 + 明确交付物 + 可量化成功指标 + 分步工作流 + 真实场景测试
|
||||
- 避免通用型"有用助手"人设,智能体应专精、独特、可落地
|
||||
- PR 提交前必须在真实场景中测试,并包含 2-3 个代码/模板示例
|
||||
- 智能体需定义具体、可量化的成功指标,而非模糊描述
|
||||
|
||||
## Key Quotes
|
||||
> "赋予智能体独特语气与人设,避免'我是一个有用的助手',要具体、让人印象深刻" — 智能体性格设计原则
|
||||
> "赋予智能体独特语气与人设,避免'我是一个有用的助手',要具体、让人印象深刻" — 智能体性格塑造原则
|
||||
> "提供可落地的代码示例,包含模板与框架,展示真实输出,而非模糊描述" — 交付物标准
|
||||
> "包含具体、可量化的指标" — 成功指标要求
|
||||
> "包含具体、可量化的指标,例如'3G 网络下页面加载时间低于 3 秒'" — 成功指标定义
|
||||
> "分步流程清晰,经过真实场景验证,拒绝纯理论、纸上谈兵" — 工作流要求
|
||||
|
||||
## Key Concepts
|
||||
- [[Agent-Design-Principles]]:The Agency 智能体设计五原则(鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆)
|
||||
- [[Agent-Template]]:YAML frontmatter + 分层结构(身份/使命/规则/交付物/工作流/沟通/学习/指标)
|
||||
- [[Pull-Request-Template]]:标准化 PR 提交模板,包含智能体信息、创作动机、测试情况、检查清单
|
||||
- [[Agent-Design-Patterns]]:智能体设计应遵循的五大原则——鲜明性格、明确交付物、成功指标、经过验证的工作流、学习记忆机制
|
||||
- [[YAML-Configuration]]:每个智能体文件以 YAML frontmatter 定义 name/description/color 元数据
|
||||
- [[Pull-Request-Workflow]]:Fork → 分支 → 开发 → 测试 → PR → 社区评审 → 合并的完整贡献流程
|
||||
- [[Markdown-Documentation]]:使用 Markdown 统一格式,表情符号导航,代码块语法高亮,表格对比选项
|
||||
- [[Multi-Agent-System]]:The Agency 智能体集合涵盖 engineering/design/marketing/product 等多领域专业分工
|
||||
|
||||
## Key Entities
|
||||
- [[The-Agency]](agency-agents 项目):包含 147 个专业智能体,覆盖 12 个业务领域
|
||||
- [[Agency-Engineering-Agent]]:前端开发者智能体示例,结构规范参考
|
||||
- [[Agency-Marketing-reddit-Community-Builder]]:Reddit 社区运营者示例,性格塑造优秀参考
|
||||
- [[The-Agency]]:AI 智能体开源项目,汇集多领域专家智能体,支持 9 大分类贡献
|
||||
- [[SRE]]:Site Reliability Engineering,贡献分类之一,对应 testing/ 分类专家
|
||||
|
||||
## Connections
|
||||
- [[Multi-Agent-System-Reliability]] ← extends ← [[Agent-Design-Principles]]
|
||||
- [[OpenClaw]] ← related_to ← [[The-Agency]]
|
||||
- [[Multi-Agent-Team]] ← related_to ← [[Agent-Orchestration]]
|
||||
- [[Agentic-Identity-And-Trust]] ← extends ← [[The-Agency]](The Agency 提供智能体贡献框架,Agentic Identity & Trust 定义身份与信任机制)
|
||||
- [[Agents-Orchestrator]] ← depends_on ← [[Multi-Agent-System]](编排依赖多智能体系统的存在)
|
||||
- [[Multi-Agent-System-Reliability]] ← extends ← [[Multi-Agent-System]](可靠性研究扩展多智能体系统)
|
||||
|
||||
## Contradictions
|
||||
- 无已知冲突内容
|
||||
- 无冲突:本指南为贡献流程文档,不与其他来源产生直接矛盾
|
||||
|
||||
Reference in New Issue
Block a user