iriver/PromptX
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
264 Commits 6 Branches 0 Tags
32c9a521b8cf1b48db311eeca8be9220d685201c
Commit Graph

8 Commits

Author SHA1 Message Date
Sean
d1d38e046b fix: 鲁班工具开发体验优化 - 五组件架构升级与智能错误处理 (#116) 
* feat: 为promptx_tool增加forceReinstall选项支持

解决工具沙箱缓存机制问题，允许强制重新安装工具依赖。

## 修改内容

### 1. 工具定义更新 (toolDefinitions.js)
- 增加 context.options.forceReinstall 参数支持
- 增加 context.options.timeout 参数支持
- 完善参数描述，说明context用途
- 移除暂时不需要的role_id和session_id参数

### 2. 执行逻辑优化 (ToolCommand.js)
- 支持从context.options提取执行选项
- 将选项传递给ToolSandbox构造函数
- 增加调试日志输出沙箱选项
- 完善JSDoc注释

## 解决的问题

- Issue #107: PromptX工具沙箱缓存机制不支持工具集更新
- 鲁班等AI角色在调试工具时遇到的缓存问题
- 工具依赖更新后无法自动重新安装的问题

## 使用方式

```javascript
// 强制重新安装依赖
{
  tool_resource: "@tool://tool-name",
  parameters: { /* 工具参数 */ },
  context: {
    options: {
      forceReinstall: true
    }
  }
}
```

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化context参数，移除暂时不需要的role_id和session_id

按照奥卡姆剃刀原则，移除当前没有实际用途的参数：
- 移除 context.role_id
- 移除 context.session_id
- 保留 context.options 用于执行配置
- 简化API接口，降低复杂度

未来如需要可重新添加这些参数。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* refactor: 简化promptx_tool参数结构，移除context层级

## 主要改进

### 1. 扁平化参数结构
- 移除复杂的context嵌套，直接使用顶级参数
- forceReinstall 和 timeout 作为可选的顶级参数
- 遵循MCP协议惯例，降低AI理解成本

### 2. 参数说明优化
- forceReinstall: 明确默认值为false
- 详细说明使用场景：工具开发和调试中的缓存问题
- timeout: 明确默认值为30000ms

### 3. 防止盲目调用
- 增加重要提醒：要求AI先了解工具说明再调用
- 避免大模型在不了解工具的情况下盲目执行

## 新的调用方式

## 优势
- 符合MCP预训练共识，降低AI学习成本
- 参数结构简洁直观
- 保持向后兼容性

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* fix: 修正鲁班工具开发提示词 - 更新为五组件架构并增加AI引导机制

- 更新DPML工具标签知识：从四组件升级到五组件架构（增加identity标签）
- 在工具开发工作流中增加.tool.md说明书创建步骤
- 添加AI使用提醒机制，强化工具使用前必读原则
- 完善工具标签编写模板，包含完整的五标签结构
- 更新质量检查标准，适配新的标签体系

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

* feat: 添加智能require错误过滤机制到ToolSandbox

解决工具开发中的常见问题：analyze阶段require依赖导致的错误

核心改进：
- 添加_filterRequireError()私有方法，智能识别MODULE_NOT_FOUND错误
- 通过静态分析提取getDependencies()声明的依赖列表
- 对比缺失模块与声明依赖，区分合法缺失和代码错误
- 支持版本号格式的依赖声明(如axios@^1.6.0)

开发者体验提升：
- 可以自然地在文件顶部写require()语句
- 忘记声明依赖时仍会得到明确错误提示
- 降低工具开发的认知负担和学习成本
- 遵循奥卡姆剃刀原则：用技术解决技术问题

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

---------

Co-authored-by: Claude <noreply@anthropic.com>
 2025-07-05 09:10:43 +08:00
sean
248358e2dc fix: 优化女娲角色知识生成机制，解决token爆炸问题 
## 核心改进
- 建立增量价值三重检验机制，严格控制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 <noreply@anthropic.com>
 2025-07-05 07:25:37 +08:00
sean
08d4c1d194 refactor: 完成PromptX资源架构重构和工具系统集成 
- 将prompt/目录重构为resource/目录，统一资源管理
- 删除DACP相关代码，聚焦核心PromptX功能
- 新增鲁班角色，支持工具开发工作流
- 优化无面角色，增强学习和内容保存能力
- 修复角色加载和激活机制
- 完善MCP工具定义和适配器
- 清理过时的前端开发者等角色资源

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 22:44:04 +08:00
sean
ffb5b4adaf fix: 修复InitCommand项目路径识别问题，优化角色发现机制 
主要修改：
• 修复InitCommand.js中AI提供路径优先级配置问题
• 重构Luban角色思维模式文件结构，提升代码组织
• 优化工具执行系统，清理技术债务
• 更新package.registry.json反映最新资源结构

影响：解决了technical-product-manager等角色无法发现的关键问题

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 22:11:17 +08:00
sean
071138ef57 refactor: 完成domain到role目录结构统一和硬编码清理 
## 核心变更
1. **女娲角色知识更新**
   - dpml-authoring.execution.md: 更新镜像结构约束为.promptx/resource/role/
   - role-generation.execution.md: 4处domain路径更新为role
   - role-creation.thought.md: 文件组织思维从domain改为role

2. **命令类硬编码清理**
   - InitCommand.js: 移除domain目录创建，改为按需创建
   - RegisterCommand.js: 使用ResourceManager协议查找替代硬编码路径
   - WelcomeCommand.js: 简化loadRoleRegistry()方法，直接使用注册表

3. **包注册表同步**
   - 重新生成package.registry.json确保资源发现一致性

## 技术价值
- ✅ 统一目录语义：role比domain更准确描述AI角色
- ✅ 清理边角料代码：移除不必要的硬编码路径依赖
- ✅ 增强系统架构：基于注册表的资源发现更稳定
- ✅ 女娲知识同步：包含最新的role目录结构认知

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 19:59:28 +08:00
sean
eea46a8ee1 feat: 优化鲁班角色并完善ToolSandbox工具开发体系 
## 鲁班角色优化
- 新增tool-best-practices知识模块：工具设计最佳实践、性能优化、安全防护
- 新增dpml-tool-tagging知识模块：DPML工具标签四组件架构精通
- 增强craftsmanship思维模式：现代工具特征完善
- 资源迁移到包级别：支持跨项目共享

## ToolSandbox架构完善
- 实现ToolSandbox类：支持@tool://协议的三阶段执行流程
- 优化依赖管理：getDependencies()接口标准化
- 完善UserProtocol：支持@user://沙箱目录访问
- 增强工具发现：FilePatternDiscovery支持多种文件模式

## 工具生态建设
- 添加tool.tag.md：DPML工具标签框架完整定义
- 重构ToolInterface：统一getDependencies()接口规范
- 优化ToolExecutor：集成ToolSandbox执行流程
- 更新注册表：29个资源完整注册发现

## 技术架构改进
- pnpm依赖集成：自动化沙箱环境管理
- 协议系统完善：@tool://和@user://协议标准化
- 资源结构统一：包级别和项目级别一致性
- 开发流程标准化：从需求分析到质量保证的完整工作流

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 19:42:16 +08:00
sean
3bbf4445d7 cleanup: 精简系统角色 - 保留四个核心角色 
删除了不必要的系统角色，只保留核心的四个角色：
- nuwa (女娲) - AI创造与优化角色
- assistant (助手) - 通用助手角色
- sean (Sean) - 个人化角色
- noface (无脸) - 中性化角色

删除的角色：
- java-backend-developer - Java后端开发者
- frontend-developer - 前端开发者
- product-manager - 产品经理
- xiaohongshu-marketer - 小红书营销专家

同时清理了重复的项目级角色文件(.promptx/resource/domain和role目录)，
避免角色重复和混乱，让系统更加精简和高效。

项目注册表已自动更新，现在只包含项目级工具资源。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 15:56:02 +08:00
sean
559c146af1 refactor: 重构resource/domain为resource/role - 提升目录语义化 
## 核心改进
- 将resource/domain重命名为resource/role，语义更清晰直观
- 统一更新所有硬编码路径引用，确保系统完整性
- 重新生成注册表，所有61个资源引用路径完全更新

## 目录结构优化
- resource/role (原domain) - 角色定义和专家能力
- resource/tool - JavaScript工具资源
- resource/protocol - 协议规范文档
- resource/core - 核心思维和执行模式

## 技术实现
### 发现器更新
- ProjectDiscovery.js: _scanDomainDirectory → _scanRoleDirectory
- PackageDiscovery.js: 同步更新函数名和路径引用
- 所有@project://.promptx/resource/domain/ → @project://.promptx/resource/role/
- 所有@package://resource/domain/ → @package://resource/role/

### 协议处理器
- PromptProtocol.js: domain注册表映射 → role注册表映射
- 更新协议示例和描述信息

### 注册表重新生成
- 使用generate-package-registry.js重新生成
- 61个资源路径引用全部更新为resource/role/
- 保持所有功能完全兼容

## 验证结果
- ✅ 角色发现功能正常：8个系统角色+1个项目角色
- ✅ 资源加载完全正常：61个资源正确识别
- ✅ 零功能影响：所有现有功能继续工作

这个重构显著提升了代码的语义化程度，role比domain更直观地表达目录用途，
同时建立了清晰的资源分类体系：role、tool、protocol、core。

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-06-28 15:24:19 +08:00