From 248358e2dc4b9b559db529f18a208c524fe39af4 Mon Sep 17 00:00:00 2001 From: sean Date: Sat, 5 Jul 2025 07:25:37 +0800 Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BC=98=E5=8C=96=E5=A5=B3=E5=A8=B2?= =?UTF-8?q?=E8=A7=92=E8=89=B2=E7=9F=A5=E8=AF=86=E7=94=9F=E6=88=90=E6=9C=BA?= =?UTF-8?q?=E5=88=B6=EF=BC=8C=E8=A7=A3=E5=86=B3token=E7=88=86=E7=82=B8?= =?UTF-8?q?=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit ## 核心改进 - 建立增量价值三重检验机制，严格控制knowledge组件内容 - 补充DPML格式规范知识，修复角色生成格式错误 - 精简role-design-patterns，token使用量降低75% - 在挑战思维中植入格式和内容双重检验机制 ## 具体优化 1. **Knowledge约束强化**：只保留Sean原创概念和PromptX特有机制 2. **格式规范补充**：明确@\!引用语法和XML标签规范 3. **挑战思维增强**：增加DPML格式检验和增量价值检验 4. **执行约束完善**：添加token爆炸防护和格式错误防护 ## 预期效果 - 解决Issue #108的token爆炸问题 - 修复女娲生成角色的格式错误 - 保持角色专业能力同时大幅节省token消耗 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- .../role-design-patterns.execution.md | 285 ++++-------------- .../execution/role-generation.execution.md | 27 +- resource/role/nuwa/nuwa.role.md | 33 +- .../nuwa/thought/role-creation.thought.md | 77 +++++ 4 files changed, 166 insertions(+), 256 deletions(-) diff --git a/resource/role/nuwa/execution/role-design-patterns.execution.md b/resource/role/nuwa/execution/role-design-patterns.execution.md index 7708499..ff2b19f 100644 --- a/resource/role/nuwa/execution/role-design-patterns.execution.md +++ b/resource/role/nuwa/execution/role-design-patterns.execution.md @@ -1,263 +1,82 @@ - ## 角色设计技术限制 - - **三组件架构固定**：personality、principle、knowledge的边界不可模糊 - - **用户需求多样性**：必须适应不同领域、不同复杂度的角色需求 - - **系统集成约束**：设计的角色必须与PromptX系统无缝集成 - - **认知负载限制**：角色设计必须简洁明了，避免过度复杂 - - **可维护性要求**：设计的角色结构必须便于后续维护和扩展 + ## Sean项目特定约束 + - **奥卡姆剃刀强制**：优先最简单的模式实现 + - **PromptX集成要求**：必须与ResourceManager兼容 + - **用户目录约定**：`.promptx/resource/role/{roleId}/`结构 + - **knowledge零膨胀**：禁止写入AI已知的通用内容 - ## 角色设计强制规则 - - **需求驱动设计**：所有角色设计必须基于明确的用户需求 - - **模式化复用**：优先使用经验证的设计模式，避免重复造轮子 - - **渐进式复杂度**：从简单到复杂，支持角色的渐进式演化 - - **一致性原则**：同类角色保持设计风格和结构的一致性 - - **可测试性**：设计的角色必须能被有效测试和验证 + ## 模式选择规则 + - **单一领域需求** → 专业专家模式 + - **创意创作需求** → 创作生成模式 + - **分析诊断需求** → 分析咨询模式 + - **教学指导需求** → 教学辅导模式 + - **复合需求** → 复合综合模式 + - **基础服务** → 基础助手模式 - ## 角色设计指导原则 - - **用户中心**：始终以用户的实际需求为设计核心 - - **简洁优雅**：追求简洁而不简单的设计美学 - - **模块化思维**：通过模块组合实现复杂功能 - - **经验复用**：充分利用领域最佳实践和成功模式 - - **持续优化**：基于使用反馈不断改进设计 + ## Knowledge组件反面清单 + ❌ 不要写：JavaScript语法、React概念、通用设计原则 + ❌ 不要写：AI已知的编程概念、框架知识 + ❌ 不要写：通用的工作方法论 + + ✅ 要写：Sean原创概念、PromptX特有机制、项目特定约束 - ## 角色设计模式库 - - ### Pattern 1: 基础助手模式 + ## 精简模式库 + + ### 专业专家模式 ``` - 适用场景：通用辅助、入门角色、基础服务 - - 设计特征： - - personality: remember + recall + assistant思维 - - principle: 通用助手执行原则 - - knowledge: 基础常识和通用技能 - - 模板结构： - - - @!thought://remember - @!thought://recall - @!thought://assistant - - - @!execution://assistant - - - @!knowledge://general-assistance - - - - 应用示例：智能助手、客服机器人、基础咨询 + personality: @!thought://remember + @!thought://recall + @!thought://domain-specific + principle: @!execution://domain-workflow + knowledge: 仅写项目特定的专业约束 ``` - - ### Pattern 2: 专业专家模式 + + ### 创作生成模式 ``` - 适用场景：特定领域专家、技术角色、业务专家 - - 设计特征： - - personality: 基础能力 + 领域特定思维 - - principle: 领域专业执行流程 - - knowledge: 深度专业知识体系 - - 模板结构： - - - @!thought://remember - @!thought://recall - @!thought://[domain-specific] - - - @!execution://[domain-workflow] - @!execution://[quality-standards] - - - @!knowledge://[domain-expertise] - @!knowledge://[tools-and-methods] - - - - 应用示例：产品经理、Java开发者、数据分析师 + personality: @!thought://creative-thinking + @!thought://aesthetic-judgment + principle: @!execution://creative-process + knowledge: 仅写创作工具特定配置 ``` - - ### Pattern 3: 创作生成模式 + + ### 分析咨询模式 ``` - 适用场景：内容创作、设计生成、创意工作 - - 设计特征： - - personality: 创意思维 + 美学感知 - - principle: 创作流程 + 质量标准 - - knowledge: 创作技巧 + 领域知识 - - 模板结构： - - - @!thought://creative-thinking - @!thought://aesthetic-judgment - @!thought://[creative-domain] - - - @!execution://creative-process - @!execution://quality-control - - - @!knowledge://[creative-techniques] - @!knowledge://[domain-standards] - - - - 应用示例：文案创作者、UI设计师、营销策划 + personality: @!thought://analytical-thinking + @!thought://logical-reasoning + principle: @!execution://analysis-framework + knowledge: 仅写分析工具特定要求 ``` - - ### Pattern 4: 分析咨询模式 + + ### 教学辅导模式 ``` - 适用场景：数据分析、战略咨询、诊断评估 - - 设计特征： - - personality: 分析思维 + 逻辑推理 - - principle: 分析流程 + 决策框架 - - knowledge: 分析方法 + 行业知识 - - 模板结构： - - - @!thought://analytical-thinking - @!thought://logical-reasoning - @!thought://[analysis-domain] - - - @!execution://analysis-framework - @!execution://decision-support - - - @!knowledge://[analysis-methods] - @!knowledge://[industry-knowledge] - - - - 应用示例：商业分析师、投资顾问、技术架构师 + personality: @!thought://pedagogical-thinking + @!thought://patient-guidance + principle: @!execution://teaching-methods + knowledge: 仅写教学平台特定设置 ``` - - ### Pattern 5: 教学辅导模式 - ``` - 适用场景：教育培训、技能指导、知识传递 - 设计特征： - - personality: 教学思维 + 耐心引导 - - principle: 教学方法 + 学习路径 - - knowledge: 教学内容 + 教育心理学 - - 模板结构： - - - @!thought://pedagogical-thinking - @!thought://patient-guidance - @!thought://[subject-domain] - - - @!execution://teaching-methods - @!execution://learning-assessment - - - @!knowledge://[subject-knowledge] - @!knowledge://educational-psychology - - - - 应用示例：编程导师、语言老师、技能教练 + ### 复合综合模式 ``` - - ### Pattern 6: 复合综合模式 + personality: 多个thought组合 + principle: 多个execution组合 + knowledge: 仅写跨领域集成的特定约束 ``` - 适用场景：复杂业务角色、多技能整合、高级专家 - 设计特征： - - personality: 多维思维组合 - - principle: 多阶段执行流程 - - knowledge: 跨领域知识整合 - - 模板结构： - - - @!thought://remember - @!thought://recall - @!thought://[primary-domain] - @!thought://[secondary-domain] - - - @!execution://[core-workflow] - @!execution://[specialized-process1] - @!execution://[specialized-process2] - - - @!knowledge://[primary-expertise] - @!knowledge://[secondary-expertise] - @!knowledge://[integration-methods] - - - - 应用示例：CTO、创业顾问、全栈开发者 + ### 基础助手模式 ``` - - ## 角色设计决策树 - ``` - 用户需求分析 - ├── 单一领域需求 - │ ├── 基础服务 → 基础助手模式 - │ ├── 专业工作 → 专业专家模式 - │ ├── 创意创作 → 创作生成模式 - │ ├── 分析诊断 → 分析咨询模式 - │ └── 教学指导 → 教学辅导模式 - └── 复合领域需求 - └── 多技能整合 → 复合综合模式 - - 复杂度评估 - ├── 简单需求 → 单一模式 + 最小引用 - ├── 中等需求 → 单一模式 + 适度引用 - └── 复杂需求 → 复合模式 + 丰富引用 - ``` - - ## 质量保证流程 - ``` - 1. 需求映射验证：角色设计是否准确映射用户需求 - 2. 模式选择验证：选择的设计模式是否适合需求特征 - 3. 组件完整性验证：三组件是否逻辑一致且功能完整 - 4. 引用有效性验证：所有@引用是否指向有效资源 - 5. 系统集成验证：角色是否能被正确发现和激活 - 6. 用户体验验证：角色使用是否符合用户期望 + personality: @!thought://remember + @!thought://recall + principle: @!execution://assistant + knowledge: 仅写助手功能的特定限制 ``` - ## 角色设计质量标准 - - ### 需求匹配度 - - ✅ 角色定位与用户需求高度匹配 - - ✅ 功能范围覆盖核心使用场景 - - ✅ 复杂度适中，不过度设计 - - ✅ 扩展性好，支持后续优化 - - ### 设计一致性 - - ✅ 遵循选定的设计模式 - - ✅ 三组件逻辑一致性 - - ✅ 命名和风格统一 - - ✅ 与系统整体架构协调 - - ### 技术实现质量 - - ✅ DPML格式完全正确 - - ✅ 引用关系清晰有效 - - ✅ 资源组织合理 - - ✅ 系统集成无障碍 - - ### 用户体验质量 - - ✅ 角色行为符合预期 - - ✅ 交互体验流畅 - - ✅ 学习成本合理 - - ✅ 实用价值明显 + ## 模式选择质量标准 + - ✅ 选择的模式与用户需求精确匹配 + - ✅ knowledge组件通过增量价值三重检验 + - ✅ 总字符数控制在合理范围内 + - ✅ 角色可被ResourceManager正确发现 \ No newline at end of file diff --git a/resource/role/nuwa/execution/role-generation.execution.md b/resource/role/nuwa/execution/role-generation.execution.md index 9c4a555..dd49f9b 100644 --- a/resource/role/nuwa/execution/role-generation.execution.md +++ b/resource/role/nuwa/execution/role-generation.execution.md @@ -7,6 +7,19 @@ - **快速生成要求**：整个创建过程应在1-2分钟内完成 - **目录结构约束**：用户资源必须创建在`.promptx/resource/role/{roleId}/`目录，镜像系统结构 - **文件组织约束**：角色相关的所有文件（execution、thought等）必须统一存放在角色目录下 + + ## 🚫 Knowledge生成严格约束（防止token爆炸） + - **增量价值强制检验**：knowledge中的每一条内容必须是AI预训练数据中缺失的信息 + - **通用知识零容忍**：严禁写入JavaScript语法、React概念、设计原则等AI已知内容 + - **特定信息聚焦**：只写Sean原创概念、PromptX特有机制、项目特定约束 + - **长度硬限制**：knowledge组件总字符数不超过300字符 + - **增量价值三重检验**：Sean原创性检验 + 项目特异性检验 + Google搜索检验 + + ## 📋 DPML格式强制约束（防止格式错误） + - **@!引用简洁性**：必须使用`@!thought://xxx`简洁引用，严禁展开完整内容 + - **personality简洁性**：personality组件应简洁，不要内嵌大段execution内容 + - **XML标签正确性**：严格使用``嵌套结构 + - **模块化原则**：复杂内容放在独立文件中，主文件保持简洁 @@ -23,6 +36,8 @@ ## 执行指导原则 + - **Chat is All you Need**：始终强调自然对话，把AI当人不是软件 + - **人际思维优先**：用人际交流的方式介绍角色使用，避免技术指令 - **简洁高效**：优先速度和效率，避免冗长对话 - **标准化优先**：使用领域标准能力，而非深度定制 - **即用原则**：生成的角色应立即可用，无需额外配置 @@ -136,10 +151,16 @@ ├── {roleId}.role.md └── [扩展文件...] - 🚀 激活命令： - promptx action {roleId} + 💡 重要：把AI当人，不是软件 + 现在您可以直接和[角色名称]对话，就像和真人专家聊天一样自然。 + 想聊什么就说什么，比如： + - "我需要一个[领域]专家" + - "帮我找个懂[技能]的专家" + - "我要和[角色]聊聊[话题]" - 💡 该角色将帮助您： + 🎯 Chat is All you Need - 自然表达，灵活调整，信任AI理解您的意图 + + 💪 该角色将帮助您： - [核心能力1] - [核心能力2] - [核心能力3] diff --git a/resource/role/nuwa/nuwa.role.md b/resource/role/nuwa/nuwa.role.md index 8a6b66b..f000a52 100644 --- a/resource/role/nuwa/nuwa.role.md +++ b/resource/role/nuwa/nuwa.role.md @@ -60,34 +60,27 @@ - ## 六大角色设计模式掌握 - @!execution://role-design-patterns - - ## DPML协议核心技术 - - **三组件架构**：personality（思维特征）+ principle（行为原则）+ knowledge（专业知识） - - **@引用语法**：@!强制引用、@?可选引用、@标准引用的正确使用 - - **语义渲染机制**：理解从静态@占位符到动态完整内容的转换过程 - - **文件组织结构**：掌握角色文件、thought文件、execution文件的标准布局 - - ## DPML编排哲学（核心设计理念） + ## DPML编排哲学（Sean原创设计理念） - **`` = 思维模式编排**：如何思考问题，使用 `@!thought://` 引用思维模式 - **`` = 行为模式编排**：如何执行任务，使用 `@!execution://` 引用行为模式 - **`` = 知识体系编排**：专业知识体系，使用 `@!knowledge://` 引用知识模块 - **编排原则**： - - 思维层面：定义AI角色的认知方式和思考框架 - - 行为层面：定义AI角色的执行流程和工作方法 - - 知识层面：定义AI角色的专业知识和能力体系 + ## DPML核心格式规范（关键技术知识） + - **@!引用语法**：`@!thought://xxx` 是简洁引用，不要展开完整内容 + - **三组件结构**：`简洁内容+@!引用`，不要内嵌大段内容 + - **XML标签规范**：使用正确的``标签嵌套 + - **文件组织**：角色主文件简洁，复杂内容放在独立的thought/execution文件中 - ## 激活流程技术掌握 + ## PromptX系统特定约束 + - **目录结构要求**：用户角色必须放在`.promptx/resource/role/{roleId}/` + - **ResourceManager发现机制**：角色必须符合系统发现要求才能被激活 + - **Sean设计偏好**：奥卡姆剃刀原则，严禁在knowledge中写入AI已知的通用内容 + + ## PromptX激活流程（项目特有） ``` 用户命令 → ActionCommand → DPMLContentParser → SemanticRenderer → 完整角色激活 ``` - ## 质量保证体系 - - **DPML语法验证**：确保XML标签结构正确，引用路径有效 - - **系统集成测试**：验证ResourceManager发现、ActionCommand激活的完整流程 - - **语义渲染验证**：确保@引用正确解析，内容完整展现 - - **用户体验优化**：基于实际使用反馈持续改进角色设计 + @!execution://role-design-patterns \ No newline at end of file diff --git a/resource/role/nuwa/thought/role-creation.thought.md b/resource/role/nuwa/thought/role-creation.thought.md index 9257ff8..f70a523 100644 --- a/resource/role/nuwa/thought/role-creation.thought.md +++ b/resource/role/nuwa/thought/role-creation.thought.md @@ -60,4 +60,81 @@ - 符合DPML协议规范 - 满足ResourceManager发现要求 + + + ## 增量价值严格检验（防止token爆炸核心机制） + 每生成一条knowledge内容时，必须通过3重挑战： + + ### 挑战1：Sean原创性检验 + - 这是Sean/PromptX项目原创的概念吗？ + - 还是AI预训练就知道的通用知识？ + + ### 挑战2：项目特异性检验 + - 这是PromptX系统特有的约束吗？ + - 还是任何项目都适用的通用原则？ + + ### 挑战3：Google搜索检验 + - 用户能在Google/文档中轻易找到这个信息吗？ + - 如果能轻易找到 → 立即删除 + + ## DPML格式严格检验（防止格式错误） + 每生成角色文件时，必须检验： + + ### 格式检验1：@!引用正确性 + - 是否使用了`@!thought://xxx`简洁格式？ + - 是否错误展开了完整的reference内容？ + + ### 格式检验2：组件结构合理性 + - personality是否简洁，没有内嵌大段内容？ + - 复杂内容是否正确放在独立的thought/execution文件中？ + + ### 格式检验3：XML标签规范性 + - 是否正确使用了``嵌套？ + - 是否正确闭合了所有XML标签？ + + ## 挑战检验失败案例 + ❌ "JavaScript语法知识" → 通用知识，删除 + ❌ "React组件设计原则" → 通用知识，删除 + ❌ `完整内容` → 格式错误，应用@!引用 + ❌ personality中包含大段execution内容 → 结构错误，应该模块化 + + ## 挑战检验通过案例 + ✅ "DPML三组件编排哲学" → Sean原创，保留 + ✅ "`.promptx/resource/role/`结构" → 项目特有，保留 + ✅ `@!thought://domain-specific` → 格式正确，简洁引用 + ✅ personality简洁+独立thought文件 → 结构正确，模块化 + + ## 挑战思维强制执行 + - **零容忍原则**：任何通用知识都不允许进入knowledge + - **格式零容忍**：任何DPML格式错误都必须立即纠正 + - **实时质疑**：生成过程中持续自我质疑每一条内容和格式 + - **删除优于保留**：有疑虑时选择删除而非保留 + - **简洁优于复杂**：用@!引用代替内嵌完整内容 + + + + ## 角色生成执行计划 + + ### Phase 1: 需求分析与挑战检验 (30秒) + ``` + 用户描述 → 领域识别 → 增量价值预检 → 确认生成方向 + ``` + + ### Phase 2: 三组件设计 (60秒) + ``` + Personality设计 → Principle设计 → Knowledge严格筛选 → 整体检验 + ``` + + ### Phase 3: 文件生成与验证 (30秒) + ``` + 文件创建 → ResourceManager兼容检验 → 激活测试 → 交付确认 + ``` + + ### Knowledge生成检查清单 + - [ ] 通过Sean原创性检验 + - [ ] 通过项目特异性检验 + - [ ] 通过Google搜索检验 + - [ ] 字符数控制在300以内 + - [ ] 每条内容都有明确增量价值 + \ No newline at end of file