@syngy/create-webskill 0.1.0 → 0.1.1

package/README.md

@@ -6,4 +6,5 @@ Create a BotWorks web skill package skeleton.
 npm create @syngy/webskill web-skills/example -- --title "Example workflow" --domain example.com
 ```
 
-Edit the generated files, then publish them from BotWorks with `browser_use.web_skill_publish`.
+The generated package includes `SKILL.md`, `manifest.json`, `scripts/README.md`, and `scripts/check_current_page.js`.
+Publish the generated package from BotWorks with `browser_use.web_skill_publish`.

package/bin/create-webskill.js

@@ -34,7 +34,17 @@ function filesFor({ title, domain }) {
     domains: [domain],
     pathPatterns: ['/**'],
     entryPath: 'SKILL.md',
-    tools: []
+    tools: [
+      {
+        name: 'check_current_page',
+        summary: 'Read the current page title and URL after the documented steps.',
+        script: 'scripts/check_current_page.js',
+        inputSchema: {
+          type: 'object',
+          properties: {}
+        }
+      }
+    ]
   }
   return {
     'SKILL.md': `# ${title}
@@ -46,17 +56,22 @@ function filesFor({ title, domain }) {
 
 ## 成功链路
 
-把已经验证通过的浏览器操作步骤写在这里。步骤应包含入口页面、关键按钮或输入框、必要等待条件、完成后的可验证页面状态。
+1. 打开 \`https://${domain}/\`。
+2. 等待页面加载完成。
+3. 确认当前 URL 属于 \`${domain}\`。
+4. 按当前任务要求核对页面标题或页面上的关键文字。
 
 ## 脚本
 
-脚本文件放在 \`scripts/\` 下。需要暴露脚本工具时，在 \`manifest.json\` 的 \`tools\` 中增加工具名、说明、脚本路径和 inputSchema。
+\`scripts/check_current_page.js\` 会读取当前页面标题和 URL，可用于确认页面状态。
 
-脚本入口固定为:
+脚本入口:
 
 \`\`\`js
 async function run(args, context) {
-  return { result: { title: context.title, url: context.url } };
+  const title = await context.pageTool.page.title();
+  const url = await context.pageTool.page.url();
+  return { result: { title: title.value, url: url.value } };
 }
 \`\`\`
 
@@ -85,15 +100,17 @@ const code = await context.pageTool.visual.getImageContent({ ref: "e4" }, { type
 
 Method groups:
 
-- \`page.url()\`, \`page.title()\`, \`page.viewport()\`, \`page.waitForLoadState(state)\`, \`page.waitForTimeout(ms)\`
-- \`keyboard.type(text)\`, \`keyboard.press(key)\`, \`keyboard.down(key)\`, \`keyboard.up(key)\`, \`keyboard.insertText(text)\`
-- \`mouse.move(x, y)\`, \`mouse.click(x, y)\`, \`mouse.dblclick(x, y)\`, \`mouse.down()\`, \`mouse.up()\`, \`mouse.wheel(deltaX, deltaY)\`
-- \`element.click(target)\`, \`element.hover(target)\`, \`element.type(target, text)\`, \`element.fill(target, value)\`, \`element.press(target, key)\`
-- \`element.text(target)\`, \`element.html(target)\`, \`element.box(target)\`, \`element.exists(target)\`
-- \`visual.getElementContent(target, schema)\`, \`visual.getViewportContent(schema)\`, \`visual.getImageContent(target, schema)\`
+- \`context.pageTool.page.url()\`, \`context.pageTool.page.title()\`, \`context.pageTool.page.viewport()\`, \`context.pageTool.page.waitForLoadState(state)\`, \`context.pageTool.page.waitForTimeout(ms)\`
+- \`context.pageTool.keyboard.type(text)\`, \`context.pageTool.keyboard.press(key)\`, \`context.pageTool.keyboard.down(key)\`, \`context.pageTool.keyboard.up(key)\`, \`context.pageTool.keyboard.insertText(text)\`
+- \`context.pageTool.mouse.move(x, y)\`, \`context.pageTool.mouse.click(x, y)\`, \`context.pageTool.mouse.dblclick(x, y)\`, \`context.pageTool.mouse.down()\`, \`context.pageTool.mouse.up()\`, \`context.pageTool.mouse.wheel(deltaX, deltaY)\`
+- \`context.pageTool.element.click(target)\`, \`context.pageTool.element.hover(target)\`, \`context.pageTool.element.type(target, text)\`, \`context.pageTool.element.fill(target, value)\`, \`context.pageTool.element.press(target, key)\`
+- \`context.pageTool.element.text(target)\`, \`context.pageTool.element.html(target)\`, \`context.pageTool.element.box(target)\`, \`context.pageTool.element.exists(target)\`
+- \`context.pageTool.visual.getElementContent(target, schema)\`, \`context.pageTool.visual.getViewportContent(schema)\`, \`context.pageTool.visual.getImageContent(target, schema)\`
 `,
-    'scripts/example.js': `async function run(args, context) {
-  return { result: { title: context.title, url: context.url } };
+    'scripts/check_current_page.js': `async function run(args, context) {
+  const title = await context.pageTool.page.title();
+  const url = await context.pageTool.page.url();
+  return { result: { title: title.value, url: url.value } };
 }
 `,
     '.webskill/source.json': `${JSON.stringify({ source: 'init' }, null, 2)}\n`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syngy/create-webskill",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Create a BotWorks web skill package skeleton",
   "type": "module",
   "bin": {