用途：为单个 MCP codeful 工具生成配对产物，即 <tool-name>.tool.js（完整 JavaScript 服务端实现）与 <tool-name>.tool.json（含名称、描述、输入/输出 schema 和 MCP 工具注解的注册元数据）。宿主导入 JS 模块并调用 await runTool({ toolInput, dataApi })。
主要能力：生成仅含一个 runTool 入口的纯 ESM JavaScript，无运行时导入、无网络与文件系统访问；生成合法 JSON sidecar，包含 name、description、annotations（readOnlyHint、destructiveHint、idempotentHint、openWorldHint，后者恒为 false）、inputSchema、outputSchema；支持读取或写入 Dataverse，并可通过 generate-mcp-app-ui 生成可选 MCP 部件。
必要用法：生成前先确定工具用途、kebab-case 名称、输入字段与约束（须提供 JSON Schema、代表性输入对象或精确字段描述，不得猜测）、预期输出，以及 Dataverse 读写意图；仅缺失时询问。使用前阅读运行时契约参考文件：codeful-tool-host-data-api.d.ts、account-summary.tool.js、account-summary.tool.json。涉及 Dataverse 时需确认 PAC CLI 已认证到目标环境，用 pac model list-tables --search "table terms" 发现表并精确匹配逻辑名，再以 pac model genpage generate-types --data-sources "logical1,logical2" --output-file "<temp>/RuntimeTypes.ts" 生成类型，仅使用其中验证过的逻辑列名、查找形状与选项原始数值，随后删除临时产物。
限制：不得编造表或列，schema 发现失败即停止上报；输出不得含占位符、TODO、测试凭据或真实环境 ID；仅返回可 JSON 序列化值；dataApi 失败须抛出并按原错误为 cause 重抛，不得返回成功形兜底；注解仅为提示性元数据，不替代运行时校验或授权。编辑既有工具时须同步更新运行时校验与元数据 schema。部件输出须与工具文件分离，CDN 策略须显式指定。