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>

resource/role/luban/knowledge/dpml-tool-tagging.knowledge.md

@@ -4,11 +4,12 @@
 
 ## 🏷️ DPML工具标签框架深度理解
 
-### 四组件架构精通
-DPML#工具提示单元 基于四组件架构构建完整的AI工具定义：
+### 五组件架构精通
+DPML#工具提示单元 基于五组件架构构建完整的AI工具定义：
 
 ```xml
 <tool>
+  <identity>工具身份 - 工具名称和简介</identity>
   <purpose>用途说明 - 明确工具解决什么问题</purpose>
   <usage>使用方法 - 详细说明如何正确使用</usage>
   <parameter>参数定义 - 明确工具需要什么输入</parameter>
@@ -23,9 +24,22 @@ DPML#工具提示单元 基于四组件架构构建完整的AI工具定义：
 
 ## 📝 标准工具标签编写模板
 
+### Identity组件编写精要
+```xml
+<identity>
+## 工具名称
+@tool://tool-name
+
+## 简介
+简洁明确的工具功能描述，一句话说明工具的核心能力
+</identity>
+```
+
 ### Purpose组件编写精要
 ```xml
 <purpose>
+⚠️ **AI重要提醒**: 调用此工具前必须完整阅读本说明书，理解工具功能边界、参数要求和使用限制。禁止在不了解工具功能的情况下盲目调用。
+
 ## 核心问题定义
 明确描述工具要解决的具体问题和适用场景
 
@@ -139,6 +153,12 @@ DPML#工具提示单元 基于四组件架构构建完整的AI工具定义：
 
 ## 🎯 工具标签质量标准
 
+### Identity质量检查
+- ✅ 工具名称符合@tool://格式
+- ✅ 简介简洁明确一句话概括
+- ✅ 体现工具核心能力
+- ✅ 便于快速识别和理解
+
 ### Purpose质量检查
 - ✅ 问题定义清晰具体
 - ✅ 价值主张明确量化
@@ -227,15 +247,16 @@ return {
 
 ```mermaid
 flowchart TD
-    A[用户需求] --> B[编写Purpose]
-    B --> C[设计Usage]
-    C --> D[定义Parameter]
-    D --> E[规划Outcome]
-    E --> F[生成工具标签]
-    F --> G[映射到代码接口]
-    G --> H[实现具体逻辑]
-    H --> I[测试验证]
-    I --> J[完整工具交付]
+    A[用户需求] --> B[定义Identity]
+    B --> C[编写Purpose]
+    C --> D[设计Usage]
+    D --> E[定义Parameter]
+    E --> F[规划Outcome]
+    F --> G[生成工具标签]
+    G --> H[映射到代码接口]
+    H --> I[实现具体逻辑]
+    I --> J[测试验证]
+    J --> K[完整工具交付]
 ```
 
 ### 开发质量保证