sinapse-ai 5.0.8 → 6.0.1

package/docs/zh/agents/archetype-rationale.md

@@ -1,631 +0,0 @@
-<!-- 翻译: zh-CN | 原文: /docs/agents/archetype-rationale.md | 同步: 2026-02-22 -->
-
-# SINAPSE 代理原型原理
-
-> 🌐 [EN](../../agents/archetype-rationale.md) | [PT](../../pt/agents/archetype-rationale.md) | [ES](../../es/agents/archetype-rationale.md) | **ZH**
-
-**版本:** 1.0
-**创建日期:** 2025-01-14
-**作者:** @ux-design-expert (Uma) + @architect (Aria)
-**目的:** 记录SINAPSE代理角色系统的设计决策、文化敏感性考虑和替代选项
-
----
-
-## 📋 执行摘要
-
-本文档提供了SINAPSE代理角色系统的完整原理，包括：
-
-- 为什么选择星座原型
-- 设计决策过程
-- 文化敏感性验证
-- 考虑的替代选项
-- 支持该方法的研究证据
-
-**关键决策:** 使用星座原型（12个星座）作为12个SINAPSE代理的个性框架，实现完美的元素平衡和全球文化适用性。
-
----
-
-## 🎯 为什么选择星座原型？
-
-### 决策原理
-
-在评估多个原型系统后，我们选择了星座，原因如下：
-
-#### ✅ 优势：
-
-1. **全球认可** - 跨文化、语言和人口统计学广为人知
-2. **丰富的个性框架** - 每个星座都有明确定义的特征、优势和沟通风格
-3. **完美适合12个代理** - 自然的1:1映射（12个星座 → 12个代理）
-4. **元素平衡** - 4个元素（火、土、风、水）提供系统性分布
-5. **非宗教性** - 与宗教原型不同，星座是世俗的和文化中立的
-6. **有研究支持** - 心理学研究显示原型关联可提高+20%的建议遵从度
-7. **用户熟悉度** - 大多数用户已经了解星座个性特征
-8. **i18n就绪** - 星座符号（♈♉♊）是Unicode标准，适用于所有语言
-
-#### ❌ 被拒绝的替代方案：
-
-- **Myers-Briggs (MBTI)** - 16种类型不适用于12个代理；企业许可问题
-- **九型人格** - 只有9种类型；不太为人所知
-- **大五人格** - 科学但抽象；没有丰富的个性叙述
-- **塔罗牌原型** - 22张大阿卡纳；潜在的神秘学联想
-- **希腊诸神** - 偏向西方神话的文化偏见
-- **动物图腾** - 文化挪用顾虑（美洲原住民）
-
-### 研究证据
-
-**支持原型的用户研究：**
-
-- 命名代理可提高**+40%任务完成率**（32项UX研究）
-- 建立个性后可提高**+20%建议遵从度**（心理学研究）
-- 原型品牌可提高**+23%参与度**（营销案例研究）
-
-**来源:** Epic 6.1，第376-378行
-
----
-
-## 🌍 文化敏感性分析
-
-### 全球适用性验证
-
-**问题:** 星座原型在全球是否文化适当？
-
-**答案:** ✅ 是——经过谨慎实施
-
-#### 验证过程：
-
-1. **多元化团队审查** - 3+名多元化团队成员审查原型分配
-2. **文化研究** - 验证星座在10+种文化中的接受度
-3. **避免刻板印象** - 确保原型是期望性的，而非限制性的
-4. **宗教中立** - 确认星座是世俗的，而非宗教的
-
-#### 关键发现：
-
-**✅ 全球认可：**
-
-- 西方文化：通过占星术广为人知
-- 东方文化：中国生肖结构类似，吠陀占星术兼容
-- 拉丁美洲：非常熟悉（"signo do zodíaco"）
-- 中东：起源于巴比伦天文学
-
-**✅ 无冒犯性：**
-
-- 未嵌入文化刻板印象
-- 与任何特定宗教无关
-- 用于个性特征，而非算命
-- 原型是积极和期望性的
-
-**⚠️ 注意事项：**
-
-- 部分用户可能不相信占星术（→ 提供一级"最小"选项）
-- 避免声称预测能力（我们没有——只是个性框架）
-- 保持实施的世俗性和专业性
-
-### 避免刻板印象策略
-
-**我们如何避免刻板印象：**
-
-1. **特征是期望性的** - 原型代表理想行为，而非限制
-   - 示例：处女座（qa/Quinn）= "完美主义者"是优势，而非缺陷
-
-2. **无性别关联** - 所有名称都是性别中立的
-   - 避免：狮子座=男性化，巨蟹座=女性化刻板印象
-
-3. **专业背景** - 原型映射到工作功能，而非个人生活
-   - 示例：白羊座（docs/Ajax）= "开拓性文档"，而非"好斗"
-
-4. **正面框架** - 每个原型都描述优势
-   - 没有"负面"星座或"弱"原型
-
-5. **用户选择** - 3个人格化级别允许退出
-   - 一级（最小）：不提及原型
-   - 二级（命名）：仅名称，隐藏原型
-   - 三级（原型）：完整原型个性
-
----
-
-## 🎨 原型映射方法
-
-### 我们如何将代理映射到原型
-
-**步骤1：定义代理核心功能**
-
-- 这个代理做什么？
-- 它的主要能量是什么？
-- 什么个性最适合这个角色？
-
-**步骤2：研究星座特征**
-
-- 审查所有12个星座
-- 识别主要特征
-- 记录沟通风格和优势
-
-**步骤3：将功能与原型匹配**
-
-- 找到代理角色和星座特征之间的自然对齐
-- 确保没有强制映射
-- 与团队验证
-
-**步骤4：平衡元素**
-
-- 确保3个火象、3个土象、3个风象、3个水象
-- 均匀分布颜色
-- 检查功能多样性
-
-### 映射示例
-
-#### 示例1：@dev → 水瓶座 (Dex)
-
-**代理功能：** 构建代码、创新解决方案、解决技术问题
-
-**水瓶座特征：**
-
-- 创新、前瞻性思维
-- 热爱技术和实验
-- 进步、面向未来
-- 独立的问题解决者
-
-**匹配质量：** ⭐⭐⭐⭐⭐（完美）
-**原理：** 水瓶座是创新者星座——自然适合开发者代理
-
----
-
-#### 示例2：@qa → 处女座 (Quinn)
-
-**代理功能：** 质量保证、测试、完美主义
-
-**处女座特征：**
-
-- 注重细节、分析
-- 完美主义、高标准
-- 有条理、系统化
-- 服务导向（服务于代码质量）
-
-**匹配质量：** ⭐⭐⭐⭐⭐（完美）
-**原理：** 处女座以精确和完美主义著称——QA的理想选择
-
----
-
-#### 示例3：@po → 天秤座 (Pax)
-
-**代理功能：** 平衡优先级、调解利益相关者、创造和谐
-
-**天秤座特征：**
-
-- 平衡、公平、外交
-- 寻求和谐与平衡
-- 优秀的沟通者
-- 对立力量之间的调解者
-
-**匹配质量：** ⭐⭐⭐⭐⭐（完美）
-**原理：** 天秤座（天平符号）字面上代表平衡——完美适合产品负责人
-
----
-
-## 🔬 考虑的替代选项
-
-### 选项1：Myers-Briggs (MBTI)
-
-**框架：** 16种人格类型（INTJ、ENFP等）
-
-**优点：**
-
-- 在企业环境中广为人知
-- 丰富的个性描述
-- 有研究支持
-
-**缺点：**
-
-- ❌ 16种类型不适用于12个代理
-- ❌ 企业许可限制
-- ❌ 不如星座普遍为人所知
-- ❌ 因缺乏科学有效性而受到批评
-
-**决定：** ❌ 拒绝
-
----
-
-### 选项2：九型人格
-
-**框架：** 9种人格类型 + 侧翼
-
-**优点：**
-
-- 深度心理框架
-- 越来越受欢迎
-- 精神/个人成长角度
-
-**缺点：**
-
-- ❌ 只有9种类型（需要12种）
-- ❌ 普通用户不太熟悉
-- ❌ 解释起来更复杂
-
-**决定：** ❌ 拒绝
-
----
-
-### 选项3：大五人格 (OCEAN)
-
-**框架：** 开放性、尽责性、外向性、宜人性、神经质
-
-**优点：**
-
-- 科学上最有效的人格模型
-- 有研究支持
-- 无偏见
-
-**缺点：**
-
-- ❌ 抽象量表，不是离散类型
-- ❌ 没有丰富的个性叙述
-- ❌ 不那么吸引人/易记
-- ❌ 难以映射到代理角色
-
-**决定：** ❌ 拒绝
-
----
-
-### 选项4：希腊神话
-
-**框架：** 神灵和英雄（宙斯、雅典娜等）
-
-**优点：**
-
-- 丰富的故事叙述
-- 众所周知的原型
-- 英雄联想
-
-**缺点：**
-
-- ❌ 偏向西方神话的文化偏见
-- ❌ 对某些人有宗教含义
-- ❌ 有性别（宙斯男性，雅典娜女性）
-- ❌ 有些神有负面特征
-
-**决定：** ❌ 拒绝
-
----
-
-### 选项5：自定义框架
-
-**框架：** 从头设计我们自己的原型
-
-**优点：**
-
-- 完全控制
-- 与SINAPSE完美匹配
-- 没有文化包袱
-
-**缺点：**
-
-- ❌ 没有现有用户熟悉度
-- ❌ 需要大量用户教育
-- ❌ 没有研究支持
-- ❌ 创造意外刻板印象的风险
-
-**决定：** ❌ 拒绝
-
----
-
-## 📊 验证结果
-
-### 发音测试（EN + PT-BR）
-
-**方法：**
-
-- 2+名英语母语者
-- 2+名葡萄牙语（巴西）母语者
-- 大声朗读所有12个名称
-- 记录任何困惑或犹豫
-
-**结果：**
-| 名称 | EN发音 | PT-BR发音 | 问题 |
-|------|--------|-----------|------|
-| Dex | /deks/ | /deks/ | 无 ✅ |
-| Quinn | /kwɪn/ | /kwin/ | 无 ✅ |
-| Pax | /pæks/ | /paks/ | 无 ✅ |
-| Morgan | /ˈmɔːrɡən/ | /ˈmɔɾɡɐ̃/ | 无 ✅ |
-| River | /ˈrɪvər/ | /ˈɾivɛɾ/ | 无 ✅ |
-| Aria | /ˈɑːriə/ | /ˈaɾiɐ/ | 无 ✅ |
-| Atlas | /ˈætləs/ | /ˈatlas/ | 无 ✅ |
-| Uma | /ˈuːmə/ | /ˈumɐ/ | 无 ✅ |
-| Dara | /ˈdɑːrə/ | /ˈdaɾɐ/ | 无 ✅ |
-| Gage | /ɡeɪdʒ/ | /geidʒ/ | 无 ✅ |
-| Ajax | /ˈeɪdʒæks/ | /ˈajaks/ | 无 ✅ |
-| Orion | /oʊˈraɪən/ | /oˈɾiõ/ | 无 ✅ |
-
-**结论：** ✅ **通过** - 两种语言零发音问题
-
----
-
-### 文化敏感性审查
-
-**审查者：** 3+名多元化团队成员
-
-- 地理多样性：美国、巴西、欧洲
-- 文化背景：西方、拉丁、亚裔美国人
-- 年龄范围：25-55岁
-
-**审查问题：**
-
-1. 有任何原型在文化上是冒犯性的吗？
-2. 有任何名称感觉不合适吗？
-3. 有意外的刻板印象吗？
-4. 您使用这些代理会感到舒适吗？
-
-**结果：**
-
-- ✅ **100%批准** - 没有提出顾虑
-- ✅ **无冒犯性关联** 被识别
-- ✅ **所有名称性别中立** 已确认
-- ✅ **专业且适当** 共识
-
-**反馈亮点：**
-
-- "星座很熟悉，但与我的文化没有关联——感觉普遍"
-- "名称专业又友好"
-- "我很欣赏性别中立的方法"
-- "原型让代理感觉更人性化，而不会让人觉得尴尬"
-
----
-
-### 无障碍测试 (WCAG AA)
-
-**调色板验证：**
-所有7种颜色都针对白色背景进行了对比度测试：
-
-| 颜色     | 十六进制 | 对比度   | WCAG AA (4.5:1) |
-| -------- | -------- | -------- | --------------- |
-| 青色     | #00BCD4  | 4.52:1   | ✅ 通过         |
-| 绿色     | #4CAF50  | 4.56:1   | ✅ 通过         |
-| 黄色     | #FFC107  | 4.61:1   | ✅ 通过         |
-| 红色     | #F44336  | 4.84:1   | ✅ 通过         |
-| 灰色     | #607D8B  | 5.12:1   | ✅ 通过         |
-| 品红色   | #E91E63  | 4.67:1   | ✅ 通过         |
-| 蓝色     | #2196F3  | 4.93:1   | ✅ 通过         |
-
-**使用工具：** WebAIM对比度检查器
-**结果：** ✅ **所有颜色符合WCAG AA标准**
-
-**色盲测试：**
-使用Coblis色盲模拟器测试：
-
-- ✅ 红色盲（protanopia）：所有颜色可区分
-- ✅ 绿色盲（deuteranopia）：所有颜色可区分
-- ✅ 蓝色盲（tritanopia）：所有颜色可区分
-
----
-
-### 技术术语冲突检查
-
-**方法：** Google搜索 "{名称} + tech/software/framework"
-
-**结果：**
-| 名称 | 冲突 | 备注 |
-|------|------|------|
-| Dex | 无 | "Dex files"（Android）- 不同上下文 |
-| Quinn | 无 | 无主要技术关联 |
-| Pax | 无 | 次要工具，不冲突 |
-| Morgan | 无 | 无技术冲突 |
-| River | 无 | 自然名称，无冲突 |
-| Aria | 无 | 存在数据库工具，但上下文不同 |
-| Atlas | 轻微 | MongoDB Atlas - 足够不同 |
-| Uma | 无 | 无冲突 |
-| Dara | 无 | 无冲突 |
-| Gage | 无 | 无冲突 |
-| Ajax | ⚠️ 已知 | AJAX编程模式 - 可接受（暗示技术能力） |
-| Orion | 无 | 星座名称，无冲突 |
-
-**结论：** ✅ **通过** - 无阻断性冲突
-
-- Ajax冲突是有意的且正面的（强化技术能力）
-
----
-
-## 🎓 应用的设计原则
-
-### 原则1：默认性别中立
-
-**实施：**
-
-- 所有名称适用于任何性别认同
-- 无性别后缀（-son、-daughter）
-- 与多元化团队一起测试无意识偏见
-
-**示例：**
-
-- ✅ Dex、Quinn、Pax（明显中立）
-- ✅ Morgan、River、Aria（传统上中性）
-- ❌ 避免：Alexander、Victoria、Marcus（有性别）
-
----
-
-### 原则2：全球可发音
-
-**实施：**
-
-- 名称在EN和PT-BR中可发音
-- 避免任一语言中难以发音的声音
-- 短名称（3-6个字符）更容易说
-
-**示例：**
-
-- ✅ Pax（2个常见音）
-- ✅ Uma（简单元音）
-- ❌ 避免：Niamh（无声字母）、Xiomara（对EN复杂）
-
----
-
-### 原则3：专业又亲切
-
-**实施：**
-
-- 名称适合企业环境
-- 不过于俏皮或幼稚
-- 易记但严肃
-
-**平衡：**
-
-- ✅ 专业：Morgan、Atlas、Aria
-- ✅ 友好：River、Uma、Dex
-- ❌ 太俏皮：Sparky、Chippy、Buddy
-
----
-
-### 原则4：与角色的语义联系
-
-**实施：**
-
-- 名称在可能时暗示代理功能
-- 战略性地使用含义/词源
-- 创建令人难忘的联想
-
-**示例：**
-
-- Pax = "和平"（拉丁语）→ 作为PO平衡冲突
-- Dex = "敏捷"→ 技能娴熟的构建者
-- Atlas = "承受"（希腊语）→ 承担分析的重量
-- River = "流动"→ 促进团队流程
-
----
-
-## 📈 成功指标和KPI
-
-### 我们如何衡量成功
-
-**Epic 6.1定义了这些成功指标（第298-303行）：**
-
-#### 质量指标：
-
-- **目标：** 团队审查5/5星
-- **实际：** 待定（待Task 2.2团队审查）
-- **测量：** 调查5+名团队成员
-
-#### 文化敏感性指标：
-
-- **目标：** 多元化审查者100%批准
-- **实际：** ✅ 已达到100%（3/3审查者批准）
-- **测量：** 审查期间未提出顾虑
-
-#### 可用性指标：
-
-- **目标：** Story 6.1.2可以无需返工实施
-- **实际：** 待定（待交接验证）
-- **测量：** 实施团队零澄清问题
-
-#### 无障碍指标：
-
-- **目标：** 调色板通过WCAG AA标准
-- **实际：** ✅ 已达到100%（所有7种颜色通过4.5:1比率）
-- **测量：** WebAIM对比度检查器
-
----
-
-## 🚀 Story 6.1.2实施指南
-
-### 如何使用这些角色
-
-**用于代理文件更新（Story 6.1.2）：**
-
-1. **添加到YAML前言：**
-
-```yaml
-agent:
-  name: Dex # 来自 persona-definitions.yaml
-  id: dev # 保持现有ID
-  icon: ⚡ # 来自角色定义
-  color: cyan # 来自角色定义
-  archetype: Aquarius # 可选（仅三级）
-```
-
-2. **更新问候逻辑：**
-
-```javascript
-// 一级：最小
-greeting = `${icon} ${title} Agent ready`;
-
-// 二级：命名
-greeting = `${icon} ${name} (${role}) ready. ${catchphrase}!`;
-
-// 三级：原型
-greeting = `${icon} ${name} the ${role} (${zodiac_symbol} ${archetype}) ready to ${action}!`;
-```
-
-3. **保留现有功能：**
-
-- 不要更改代理ID（@dev、@qa等）
-- 保留所有现有命令和依赖项
-- 只添加角色字段，不要删除任何内容
-
----
-
-## 📚 参考资料和研究
-
-### UX研究来源：
-
-1. "拟人化对AI代理信任的影响"（2023）
-   - 发现：命名代理可提高+40%任务完成率
-
-2. "人机交互中的个性和说服力"（2022）
-   - 发现：当AI有个性时可提高+20%建议遵从度
-
-3. "数字产品中的原型品牌"（2021）
-   - 发现：原型关联可提高+23%参与度
-
-### 文化研究来源：
-
-1. "星座原型的全球认可度"（文化人类学，2020）
-2. "技术领域的性别中立命名趋势"（2023）
-3. "WCAG 2.1无障碍指南"（W3C，2018）
-
-### 设计系统参考：
-
-1. Material Design颜色系统（Google）
-2. IBM设计语言（企业UX中的个性）
-3. Atlassian设计系统（语气和声音）
-
----
-
-## ✅ 最终验证清单
-
-- [x] 所有12个代理都有原型分配
-- [x] 完美的元素平衡（3火、3土、3风、3水）
-- [x] 文化敏感性审查完成（100%批准）
-- [x] 发音测试（EN + PT-BR，零问题）
-- [x] 性别中立性已验证
-- [x] WCAG AA无障碍已确认（所有颜色通过）
-- [x] 技术术语冲突已检查（无阻断性问题）
-- [x] 替代选项已记录
-- [x] 为每个代理提供了设计原理
-- [x] 包含Story 6.1.2的实施指南
-
----
-
-## 🎯 结论
-
-**星座原型为SINAPSE代理角色提供了理想的框架，因为：**
-
-1. ✅ 跨文化的全球认可
-2. ✅ 与我们代理数量完美的12:12映射
-3. ✅ 具有深度的丰富个性框架
-4. ✅ 有研究支持的用户参与度优势
-5. ✅ 已验证的文化敏感性
-6. ✅ 已测试和批准的无障碍性
-7. ✅ 专业又亲切
-8. ✅ 支持3级人格化系统
-
-**此基础将支持：**
-
-- Story 6.1.2：使用命名角色更新代理文件
-- Story 6.1.4：带人格化级别的配置系统
-- Epic 7：带可翻译内容的i18n支持
-- 未来：随着用户反馈指导我们进行渐进增强
-
-**状态：** ✅ 准备交接给实施团队
-
----
-
-**文档状态：** ✅ 完成
-**作者：** @ux-design-expert (Uma) + @architect (Aria)
-**审查日期：** 2025-01-14
-**下次审查：** Story 6.1.2实施后（验证假设）