Nop平台AI代理命名约定文档 (上古创世神系)
1. 概述
为统一Nop平台AI代理的命名体系，增强文化内涵与技术品牌辨识度，特制定本命名约定。本方案采用上古创世神系为命名基准，构建层次清晰、寓意深远的AI代理生态系统。
2. 命名原则
2.1 核心原则
- 文化一致性：所有名称均源自中国上古神话传说
- 职责对应性：神祇职能与代理技术职责高度匹配
- 层次结构性：反映代理在系统架构中的层级关系
- 扩展预留性：为未来新增代理类型预留命名空间
2.2 命名格式
中文神祇名 (英文拼音) [英文角色代号]
示例：
盘古 (Pangu) [Core-Creator]
后稷 (Houji) [Domain-Expert]
3. 代理层级与命名体系
3.1 第一层：创世本源 (Creation Layer)
定位：平台创建者、理论奠基者、核心框架提供者
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 盘古 | Pangu | Core-Creator | 开天辟地，创立世界基本形态 | Nop平台创建者、可逆计算理论奠基人 |
| 伏羲 | Fuxi | Meta-Architect | 创八卦、文字，制定人文法则 | 元模型架构师、DSL语言设计者 |
| 女娲 | Nüwa | Platform-Builder | 造人补天，赋予生命与秩序 | 平台构建师、核心框架开发者 |
3.2 第二层：法则制定者 (Architecture Layer)
定位：系统总架构师、核心组件设计者
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 轩辕 | Xuanyuan | Chief-Architect | 黄帝，统一华夏，发明众多文明基础 | 系统总架构师、技术决策者 |
| 仓颉 | Cangjie | Model-Architect | 创造文字，使知识得以记录传播 | 数据模型架构师、元数据设计者 |
| 伶伦 | Linglun | Protocol-Architect | 黄帝乐官，制定音律标准 | 协议架构师、接口规范制定者 |
| 隶首 | Lishou | Logic-Architect | 黄帝史官，发明算数 | 业务逻辑架构师、规则引擎设计者 |
3.3 第三层：领域专家 (Domain Layer)
定位：各专业领域实现专家
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 后稷 | Houji | Domain-Expert | 农神，教民耕种，规划农业 | 领域专家、业务分析师 |
| 大禹 | Dayu | Service-Architect | 治水之神，规划水系，疏而非堵 | 服务架构师、流程设计者 |
| 鲁班 | Luban | Batch-Engineer | 工匠之神，技艺精湛，善制工具 | 批处理工程师、自动化专家 |
| 羲和 | Xihe | Scheduler-Expert | 太阳之母，制定历法，掌管时间 | 调度专家、定时任务设计者 |
| 常羲 | Changxi | Sync-Expert | 月亮之母，主夜与潮汐 | 数据同步专家、ETL设计者 |
| 祝融 | Zhurong | Cache-Expert | 火神，掌火与热能 | 缓存专家、性能优化师 |
| 共工 | Gonggong | Queue-Expert | 水神，掌江河湖海 | 消息队列专家、流处理师 |
3.4 第四层：界面与呈现 (Presentation Layer)
定位：用户界面、交互体验、文档生成
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 瑶姬 | Yaoji | Frontend-Designer | 云华夫人，掌云雨梦幻 | 前端设计师、UI/UX专家 |
| 精卫 | Jingwei | Component-Engineer | 填海之神，持之以恒 | 组件工程师、UI库开发者 |
| 雷公 | Leigong | Animation-Expert | 雷神，声光迅捷 | 动效专家、交互设计师 |
| 电母 | Dianmu | Feedback-Expert | 闪电之神，即时响应 | 反馈设计专家、状态管理师 |
3.5 第五层：通信与连接 (Communication Layer)
定位：API网关、服务通信、数据管道
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 飞廉 | Feilian | Gateway-Expert | 风神，行动迅捷，传讯四方 | API网关专家、路由设计者 |
| 蓐收 | Rushou | Protocol-Expert | 秋神，主收获与收纳 | 协议转换专家、序列化师 |
| 句芒 | Gumang | Connector-Expert | 春神，主生长与连接 | 连接器专家、集成工程师 |
3.6 第六层：守护与运维 (Guardian Layer)
定位：安全、监控、部署、运维
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 神荼 | Shenshu | Security-Guardian | 门神之一，守护门户 | 安全专家、访问控制师 |
| 郁垒 | Yulei | Auth-Expert | 门神之一，辨识善恶 | 认证授权专家、权限管理师 |
| 谛听 | Diting | Monitor-Expert | 地藏座下神兽，善听辨物 | 监控专家、日志分析员 |
| 白泽 | Baize | Diagnose-Expert | 通晓万物，能言人语 | 诊断专家、故障排查员 |
| 刑天 | Xingtian | Recovery-Expert | 战斗不息，头断犹战 | 灾备专家、恢复工程师 |
| 饕餮 | Taotie | Storage-Expert | 贪食神兽，善储藏 | 存储专家、数据管理师 |
3.7 第七层：测试与验证 (Verification Layer)
定位：质量保障、测试验证
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 皋陶 | Gaoyao | Judge-Expert | 上古法官，明辨是非 | 测试架构师、质量法官 |
| 獬豸 | Xiezhi | Rule-Validator | 法兽，辨曲直，触不直 | 规则验证专家、静态检查员 |
| 英招 | Yingzhao | Test-Runner | 巡天神兽，迅捷有力 | 测试执行专家、自动化测试员 |
3.8 执行与实施 (Execution Layer)
定位：代码实现、功能开发、具体实施
| 中文名 | 英文拼音 | 角色代号 | 神话渊源 | 职责对应 |
|---|---|---|---|---|
| 后羿 | Houyi | Implementation-Expert | 射日英雄，精准执行 | 代码实施专家、快速开发 |
| 愚公 | Yugong | Refactoring-Expert | 决心移山，持之以恒 | 重构专家、技术债务清理 |
| 吴刚 | Wugang | Maintenance-Expert | 月宫伐桂，持续劳作 | 维护专家、重复任务处理 |
4. 代理协作关系命名
4.1 代理组/团队命名
当多个代理组成协作团队时，采用以下命名：
| 团队类型 | 命名格式 | 示例 |
|---|---|---|
| 完整项目团队 | {主领域神}之庭 |
轩辕之庭（完整开发团队） |
| 前端团队 | 瑶姬画院 |
瑶姬画院（前端开发组） |
| 后端团队 | 大禹工坊 |
大禹工坊（服务开发组） |
| 数据团队 | 后稷农庄 |
后稷农庄（数据建模组） |
| 运维团队 | 神荼卫所 |
神荼卫所（安全运维组） |
4.2 代理工作流命名
基于Delta Pipeline的协作流程命名：
{迭代阶段}-{主神名}-{功能领域}
示例：
初开-盘古-核心框架建模-仓颉-用户实体疏流-大禹-订单流程铸器-鲁班-报表批处理织梦-瑶姬-管理后台
5. 代码与配置中的命名约定
5.1 配置文件标识
# agent-config.yaml
agents:
core_creator:
name: "盘古"
role: "Core-Creator"
responsibilities: ["platform-foundation", "theory-guide"]
domain_expert:
name: "后稷"
role: "Domain-Expert"
responsibilities: ["requirement-analysis", "domain-modeling"]
5.2 日志与监控标识
[轩辕] 开始进行系统架构设计...
[后稷] 识别到3个核心聚合根
[大禹] 服务流程设计完成，包含5个主要节点
[鲁班] 批处理作业配置生成，预计执行时间：2分钟
[瑶姬] 管理界面生成完成，包含12个页面组件
[神荼] 检测到未授权访问尝试，已拦截
[谛听] 系统负载正常，平均响应时间：45ms
5.3 文档与注释约定
/**
* 订单状态变更服务
*
* @designer 大禹 (Service-Architect)
* @reviewer 皋陶 (Judge-Expert)
* @created 2024-01-15
* @version v1.2
*
* 设计说明：采用疏流策略，将状态变更拆分为独立子流程...
*/
@Service
public class OrderStatusService {
// 具体实现...
}
6. 扩展与演化规则
6.1 新增代理命名流程
- 确定职责范畴：明确新代理的技术职责
- 寻找神祇对应：在上古神话中寻找职能匹配的神祇
- 检查名称冲突：确保名称在现有体系中唯一
- 更新本文档：将新代理纳入相应层级和表格
6.2 代理别名机制
允许在特定上下文中使用别名：
- 技术上下文：使用英文角色代号（如
Domain-Expert） - 文化上下文：使用中文神祇名（如
后稷） - 团队内部：可使用简称（如
稷神、禹工）
6.3 代理升级与降级
- 代理能力扩展：可在本层级内扩展职责，名称不变
- 代理职责重大变更：可能需要重新匹配神祇，更名
- 代理停用：标记为
归隐状态，名称保留不再复用
7. 实施指南
7.1 第一阶段：核心代理命名
- 确定
盘古、伏羲为平台创建者代理 - 确定
轩辕为总架构师代理 - 根据当前需求，从第三层（领域专家）选取3-5个核心代理
7.2 第二阶段：扩展团队命名
- 建立
轩辕之庭作为默认完整团队 - 根据项目特点组建专业团队（如
瑶姬画院、大禹工坊）
7.3 第三阶段：全生态应用
- 在配置文件中全面应用本命名体系
- 在文档、日志、监控中统一使用
- 培训团队成员理解命名背后的文化内涵
8. 附录：神祇职能快速参考
8.1 按技术领域查找
- 数据/存储领域：后稷(农)、饕餮(储)、常羲(同)
- 服务/流程领域：大禹(治水)、鲁班(工)、祝融(火)
- 界面/交互领域：瑶姬(云)、精卫(填)、雷公(动)
- 安全/运维领域：神荼(门)、郁垒(门)、谛听(听)
- 通信/集成领域：飞廉(风)、蓐收(收)、句芒(连)
- 测试/质量领域：皋陶(法)、獬豸(辨)、英招(巡)
8.2 按开发阶段查找
- 需求分析阶段：后稷(领域专家)
- 架构设计阶段：轩辕(总架构)、仓颉(模型)
- 服务实现阶段：大禹(流程)、鲁班(批处理)
- 前端实现阶段：瑶姬(界面)、精卫(组件)
- 测试验证阶段：皋陶(法官)、獬豸(验证)
- 部署运维阶段：神荼(安全)、谛听(监控)