harveyz-skill 0.9.0 → 0.10.0

package/CHANGELOG.md

@@ -7,7 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.9.0] - 2026-05-28
+## [0.10.0] - 2026-06-08
+
+### Added
+- `url-extract` skill（`data-extraction` bundle）：跨平台 URL 存档工具，支持 Claude Code / Codex / Hermes，含 Playwright 抓取、SQLite 存储、VAULT_PATH / SKILL_DIR / CHROME_PROFILE 配置
+- `vision-extract` skill（`data-extraction` bundle）：从 hermes-skills 贡献的视觉数据提取 skill
+- `skill-publish` skill（`meta` bundle）：检查 skill 格式合规性与 skills-index.json 注册状态
+- `npm-release` skill（`meta` bundle）：完整 npm 发布工作流（版本号 → CHANGELOG → 分支 → tag → publish）
+- `migrate-specs` skill（`harness` bundle）：将旧 spec 文档迁移为 Diataxis 结构
+- `dir-manage` skill（`document` bundle）：从 writing-agent 贡献的目录管理 skill
+- `capture-insight` skill（`writing` bundle）：从 writing-agent 贡献的洞察捕获 skill
+- `add-todo` skill（`workflow` bundle）：从 harveyz-skill workflow 贡献的 TODO 追踪 skill
+- Diataxis 结构文档：cache、config、bundle、info 模块的参考文档与指南
+
+### Changed
+- `hskill` 安装交互优化：改为两步式（先选 target，再选 scope），更符合操作直觉
+- `url-extract`：通用 SKILL.md + 各平台 patch 文件，支持跨平台复用
+
+### Fixed
+- installer：`--force` 时按 `uninstallPaths` 精确清理，支持版本感知 venv 升级
+- `url-extract`：以 `source_url` 为主键，支持存量 DB schema 迁移
+- `url-extract`：命令注入安全加固，usability 改进
+- SKILL.md frontmatter 跨所有 skill 规范化
+
+## [0.9.0] - 2026-05-29
 
 ### Added
 - `hskill uninstall <tool>` 命令：清理 binary、Python 模块、tool.json、venv 及 zshrc snippet
@@ -22,6 +45,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Changed
 - p-launch `tool.json` 新增 `uninstallPaths`（`p-launch-venv`）和 `configPaths`（`~/.config/p-launch`）
 
+### Fixed
+- installer：`--force` 重装时根据 `uninstallPaths` 精确清理旧版本文件，避免残留
+- installer：`--force` 重装时正确清理 venv，支持版本感知升级
+- tool 版本对比逻辑：upgrade 前先读取已安装版本，跳过同版本重复安装
+
 ## [0.8.1] - 2026-05-24
 
 ### Fixed

package/bin/cli.js

@@ -12,7 +12,7 @@ import {
   resolveSkills, resolveSkillsByName, resolveTools, resolveToolsByName,
   TOOL_BUNDLE_CHOICES,
 } from '../lib/bundles.js'
-import { buildTargetChoices, resolveTargets, TARGETS } from '../lib/targets.js'
+import { buildTargetChoices, resolveTargets, TARGETS, USER_ONLY_TARGETS } from '../lib/targets.js'
 import { installSkills, installTools, installHooks, installHooksForTarget, uninstallHook, uninstallTool, uninstallSkill } from '../lib/installer.js'
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -594,6 +594,69 @@ const scopeArg  = scopeIdx  !== -1 ? installArgs[scopeIdx  + 1] : undefined
 
 const TOOL_BUNDLE_VALUES = new Set(TOOL_BUNDLE_CHOICES.map(c => c.value))
 
+// ── Two-step target→scope selector ───────────────────────────────────────────
+const ALL_SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+
+function selectTargetThenScope() {
+  // Step 1: platform (target)
+  const targetInput = [
+    'claude    ~/.claude/skills/',
+    'cursor    ~/.cursor/skills/',
+    'codex     ~/.codex/skills/',
+    'openclaw  ~/.openclaw/skills/',
+    'hermes    ~/.hermes/skills/',
+    'all       all 5 targets',
+  ].join('\n')
+
+  const targetResult = spawnSync('fzf', [
+    '--multi',
+    '--prompt=  › ',
+    '--header=  安装到  ·  tab 多选  ·  enter 确认  ·  esc 取消',
+    '--layout=reverse',
+    '--border=rounded',
+    '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+  ], {
+    input: targetInput,
+    encoding: 'utf8',
+    stdio: ['pipe', 'pipe', 'inherit'],
+  })
+
+  if (!targetResult.stdout.trim()) return null
+
+  const rawTargets = targetResult.stdout.trim().split('\n')
+    .map(l => l.trim().split(/\s+/)[0])
+  const expandedTargets = rawTargets.includes('all') ? ALL_SKILL_TARGETS : rawTargets
+
+  // Step 2: scope (user/project) — skip if all selected targets are user-only
+  const allUserOnly = expandedTargets.every(t => USER_ONLY_TARGETS.has(t))
+  let scope = 'user'
+  if (!allUserOnly) {
+    const scopeResult = spawnSync('fzf', [
+      '--prompt=  › ',
+      '--header=  安装范围  ·  enter 确认  ·  esc 取消',
+      '--layout=reverse',
+      '--border=rounded',
+      '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
+    ], {
+      input: 'user     — 所有项目共享  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
+      encoding: 'utf8',
+      stdio: ['pipe', 'pipe', 'inherit'],
+    })
+    if (!scopeResult.stdout.trim()) return null
+    scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
+  }
+
+  // Build final list — openclaw/hermes always resolve to user scope
+  const seen = new Set()
+  const result = []
+  for (const t of expandedTargets) {
+    const effectiveScope = USER_ONLY_TARGETS.has(t) ? 'user' : scope
+    const key = `${effectiveScope}/${t}`
+    if (!seen.has(key)) { seen.add(key); result.push({ scope: effectiveScope, target: t }) }
+  }
+  return result  // [{ scope, target }]
+}
+
 function requireFzf() {
   const probe = spawnSync('fzf', ['--version'], { encoding: 'utf8' })
   if (probe.error || probe.status !== 0) {
@@ -804,77 +867,66 @@ try {
       if (!skillItems.length && !toolItems.length && !hookItems.length) continue
 
       // ── Action selection (install / uninstall) ─────────────────────────────
+      // Skip the prompt when nothing is installed yet — default to install.
       let action = 'install'
       if (process.env.HSKILL_TEST_ACTION) {
         action = process.env.HSKILL_TEST_ACTION
       } else {
-        const actionResult = spawnSync('fzf', [
-          '--prompt=  › ',
-          '--header=  Action  ·  enter 确认  ·  esc 取消',
-          '--layout=reverse',
-          '--border=rounded',
-          '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-        ], {
-          input: `install    安装 / 重新安装\nuninstall  卸载并清理文件`,
-          encoding: 'utf8',
-          stdio: ['pipe', 'pipe', 'inherit'],
-        })
-        if (!actionResult.stdout.trim()) {
-          console.log(chalk.dim('  · Cancelled'))
-          break
-        }
-        action = actionResult.stdout.trim().startsWith('uninstall') ? 'uninstall' : 'install'
-      }
+        const anyInstalled =
+          skillItems.some(s => {
+            const inst = checkInstalled(s.skillName, s.version ?? '—')
+            return scopeSummary(inst.user) !== 'none' || scopeSummary(inst.project) !== 'none'
+          }) ||
+          toolItems.some(t => checkToolInstalled(t.toolName, t.srcPath).status !== 'none') ||
+          hookItems.some(h => {
+            const inst = checkHookInstalled(h.name)
+            return inst.user.status !== 'none' || inst.project.status !== 'none'
+          })
 
-      if (action === 'install') {
-        let skillSummary = null
-        if (skillItems.length > 0) {
-          // Scope selection
-          const scopeResult = spawnSync('fzf', [
+        if (anyInstalled) {
+          const actionResult = spawnSync('fzf', [
             '--prompt=  › ',
-            '--header=  Scope  ·  enter 确认  ·  esc 取消',
+            '--header=  Action  ·  enter 确认  ·  esc 取消',
             '--layout=reverse',
             '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: `user     — ~/.claude/skills/  (所有项目共享)\nproject  — .claude/skills/    (仅当前项目)`,
+            input: `install    安装 / 重新安装\nuninstall  卸载并清理文件`,
             encoding: 'utf8',
             stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!scopeResult.stdout.trim()) {
+          if (!actionResult.stdout.trim()) {
             console.log(chalk.dim('  · Cancelled'))
             break
           }
-          const scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
+          action = actionResult.stdout.trim().startsWith('uninstall') ? 'uninstall' : 'install'
+        }
+      }
 
-          // Target selection
-          const targetChoices = buildTargetChoices(scope)
-          const targetInput = targetChoices.map(c => c.name).join('\n') + '\nall      — all tools'
-          const targetResult = spawnSync('fzf', [
-            '--multi',
-            '--prompt=  › ',
-            '--header=  Install to  ·  tab 多选  ·  enter 确认  ·  esc 取消',
-            '--layout=reverse',
-            '--border=rounded',
-            '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-          ], {
-            input: targetInput,
-            encoding: 'utf8',
-            stdio: ['pipe', 'pipe', 'inherit'],
-          })
-          if (!targetResult.stdout.trim()) {
+      if (action === 'install') {
+        let skillSummary = null
+        if (skillItems.length > 0) {
+          // Combined scope+target selection (one step instead of two)
+          const selectedST = selectTargetThenScope()
+          if (!selectedST) {
             console.log(chalk.dim('  · Cancelled'))
             break
           }
-          const selectedTargets = targetResult.stdout.trim().split('\n')
-            .map(l => l.trim().split(/\s+/)[0])
 
-          if (selectedTargets.length > 0) {
+          // Group by scope so we make one installSkills call per scope
+          const byScope = {}
+          for (const { scope, target } of selectedST) {
+            if (!byScope[scope]) byScope[scope] = []
+            byScope[scope].push(target)
+          }
+
+          console.log('')
+          for (const [scope, selectedTargets] of Object.entries(byScope)) {
             const targets = resolveTargets(selectedTargets, scope)
-            console.log('')
-            skillSummary = await installSkills(skillItems, targets, forceFlag)
-            console.log('')
+            const result = await installSkills(skillItems, targets, forceFlag)
+            skillSummary = skillSummary ? { ...skillSummary, ...result } : result
           }
+          console.log('')
         }
 
         let toolSummary = null
@@ -960,30 +1012,33 @@ try {
         }
 
         for (const item of uSkillItems) {
-          const scopeRes = spawnSync('fzf', [
-            '--prompt=  › ',
-            '--header=  Uninstall from scope  ·  enter 确认  ·  esc 取消',
+          // Step 1: target (platform)
+          const targetChoices2 = buildTargetChoices('user')
+          const targetRes = spawnSync('fzf', [
+            '--multi', '--prompt=  › ',
+            '--header=  从哪里卸载  ·  tab 多选  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: `user     — ~/.claude/skills/\nproject  — .claude/skills/`,
+            input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all targets',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!scopeRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
-          const scope2 = scopeRes.stdout.trim().startsWith('project') ? 'project' : 'user'
+          if (!targetRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
+          const selTargets2 = targetRes.stdout.trim().split('\n').map(l => l.trim().split(/\s+/)[0])
 
-          const targetChoices2 = buildTargetChoices(scope2)
-          const targetRes = spawnSync('fzf', [
-            '--multi', '--prompt=  › ',
-            '--header=  Uninstall from  ·  tab 多选  ·  enter 确认',
+          // Step 2: scope (user/project)
+          const scopeRes = spawnSync('fzf', [
+            '--prompt=  › ',
+            '--header=  卸载范围  ·  enter 确认  ·  esc 取消',
             '--layout=reverse', '--border=rounded',
             '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
           ], {
-            input: targetChoices2.map(c => c.name).join('\n') + '\nall      — all tools',
+            input: 'user     — 所有项目  (~/.{target}/skills/)\nproject  — 仅当前项目  (.{target}/skills/)',
             encoding: 'utf8', stdio: ['pipe', 'pipe', 'inherit'],
           })
-          if (!targetRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
-          const selTargets2 = targetRes.stdout.trim().split('\n').map(l => l.trim().split(/\s+/)[0])
+          if (!scopeRes.stdout.trim()) { console.log(chalk.dim('  · Cancelled')); break }
+          const scope2 = scopeRes.stdout.trim().startsWith('project') ? 'project' : 'user'
+
           const targets2 = resolveTargets(selTargets2, scope2)
           for (const { dir } of targets2) {
             await uninstallSkill(item.skillName, dir)
@@ -1043,66 +1098,36 @@ try {
   // ── Install skills ──────────────────────────────────────────────────────────
   let skillSummary = null
   if (skillItems.length > 0) {
-    // Resolve scope
-    let scope = scopeArg ?? 'user'
-    if (!scopeArg && !targetArg) {
-      if (!process.stdout.isTTY) {
-        console.error(chalk.red('  ✗ Interactive scope selection requires a TTY. Use --scope user|project.'))
-        process.exit(1)
-      }
-      const scopeResult = spawnSync('fzf', [
-        '--prompt=  › ',
-        '--header=  Scope  ·  enter 确认  ·  esc 取消',
-        '--layout=reverse',
-        '--border=rounded',
-        '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-      ], {
-        input: `user     — ~/.claude/skills/  (所有项目共享)\nproject  — .claude/skills/    (仅当前项目)`,
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'inherit'],
-      })
-      if (!scopeResult.stdout.trim()) {
-        console.log(chalk.dim('  · Cancelled'))
-        process.exit(0)
-      }
-      scope = scopeResult.stdout.trim().startsWith('project') ? 'project' : 'user'
-    }
-
-    // Resolve target
-    let selectedTargets
+    // When --target is given, use it directly (with --scope or default 'user').
+    // When only --skill is given and no --target, use the combined selector.
     if (targetArg) {
-      selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const scope = scopeArg ?? 'user'
+      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const targets = resolveTargets(selectedTargets, scope)
+      console.log('')
+      skillSummary = await installSkills(skillItems, targets, forceFlag)
+      console.log('')
     } else {
       if (!process.stdout.isTTY) {
         console.error(chalk.red('  ✗ Interactive target selection requires a TTY. Use --target claude|cursor|codex|openclaw|hermes|all.'))
         process.exit(1)
       }
-      const targetChoices = buildTargetChoices(scope)
-      const targetInput = targetChoices.map(c => c.name).join('\n') + '\nall      — all tools'
-      const targetResult = spawnSync('fzf', [
-        '--multi',
-        '--prompt=  › ',
-        '--header=  Install to  ·  tab 多选  ·  enter 确认  ·  esc 取消',
-        '--layout=reverse',
-        '--border=rounded',
-        '--color=header:italic:dim,prompt:cyan,pointer:cyan,hl:cyan,hl+:cyan:bold',
-      ], {
-        input: targetInput,
-        encoding: 'utf8',
-        stdio: ['pipe', 'pipe', 'inherit'],
-      })
-      if (!targetResult.stdout.trim()) {
+      const selectedST = selectTargetThenScope()
+      if (!selectedST) {
         console.log(chalk.dim('  · Cancelled'))
         process.exit(0)
       }
-      selectedTargets = targetResult.stdout.trim().split('\n')
-        .map(l => l.trim().split(/\s+/)[0])
-    }
-
-    if (selectedTargets.length > 0) {
-      const targets = resolveTargets(selectedTargets, scope)
+      const byScope = {}
+      for (const { scope, target } of selectedST) {
+        if (!byScope[scope]) byScope[scope] = []
+        byScope[scope].push(target)
+      }
       console.log('')
-      skillSummary = await installSkills(skillItems, targets, forceFlag)
+      for (const [scope, selectedTargets] of Object.entries(byScope)) {
+        const targets = resolveTargets(selectedTargets, scope)
+        const result = await installSkills(skillItems, targets, forceFlag)
+        skillSummary = skillSummary ? { ...skillSummary, ...result } : result
+      }
       console.log('')
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -28,10 +28,18 @@
     "skills/task/pm-task-dispatch/",
     "skills/task/task-close/",
     "skills/web-fetch/article-fetcher/",
+    "skills/web-fetch/url-extract/",
+    "skills/data-extraction/vision-extract/",
     "skills/writing/mermaid-diagram/",
     "skills/design/sync-design-html/",
     "skills/analysis/git-cleanup/",
     "skills/meta/contribute-skill/",
+    "skills/harness/migrate-specs/",
+    "skills/workflow/add-todo/",
+    "skills/harness/dir-manage/",
+    "skills/writing/capture-insight/",
+    "skills/meta/skill-publish/",
+    "skills/meta/npm-release/",
     "tools/p-launch/",
     "hooks/check-similar-branch/"
   ],

package/skills/analysis/git-cleanup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: git-cleanup
-description: "梳理并清理本地 git 分支。规则匹配 + LLM 语义分析，分组确认后批量删除废弃分支。触发词：清理分支、branch cleanup、梳理分支、删除旧分支、整理分支"
+description: "Tidy and clean up local git branches using rule matching and LLM semantic analysis, then batch-delete stale branches after grouped confirmation. Triggers: clean up branches, branch cleanup, tidy branches, delete old branches, organize branches."
 user_invocable: true
 version: "1.0.0"
 ---

package/skills/analysis/skill-analyzer/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-analyzer
-description: "对 Skill 仓库进行系统性分析。触发词：分析这个 skill 仓库、对这个 skill 仓库做系统性研究、输出 skill 仓库的分析报告、理解这个 skill 系统的设计意图"
+description: "Performs systematic analysis of the skill repository. Triggers: analyze this skill repo, do a systematic study of the skill repo, output skill repo analysis report, understand the design intent of this skill system."
 user_invocable: true
 version: "1.0.0"
 ---

package/skills/data-extraction/vision-extract/SKILL.md

@@ -0,0 +1,154 @@
+---
+name: vision-extract
+description: "Use when extracting specific information from images (screenshots, photos, receipts, menus) via PaddleOCR + subagent filtering."
+version: 1.0.0
+user_invocable: true
+author: Hermes Agent
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [OCR, image, text-extraction, screenshots, vision, subagent]
+    related_skills: [ocr-and-documents]
+---
+
+# Image Text Extraction: PaddleOCR + Subagent Filtering
+
+## When to Use
+
+- User shares a screenshot, photo, or image and wants to extract **specific information** (not just "all text")
+- User provides natural language requirements (e.g., "提取金额和日期", "找出总价", "列出所有菜单项及价格")
+- Works for any image format: PNG, JPG, WEBP, BMP, TIFF, PDF pages, etc.
+
+## How It Works
+
+Two-step pipeline:
+
+1. **Step 1 — PaddleOCR**: Extract ALL text from the image (raw, unfiltered)
+2. **Step 2 — Subagent**: Filter the OCR text based on the user's exact requirements and return only what they asked for
+
+## Step 1 — Run PaddleOCR
+
+**IMPORTANT**: This skill uses PaddleOCR v3.x. The API differs significantly from v2.x. Do NOT use `show_log`, `use_angle_cls`, or `cls` parameters — they are invalid or deprecated.
+
+```python
+from paddleocr import PaddleOCR
+
+def ocr_full_text(image_path, lang='en'):
+    """Extract all text from an image using PaddleOCR v3.x."""
+    ocr = PaddleOCR(lang=lang)  # v3: no show_log, no use_angle_cls
+    result = ocr.ocr(image_path)
+    if not result:
+        return ''
+    page = result[0]
+    rec_texts = page.get('rec_texts', [])
+    dt_polys = page.get('dt_polys', [])
+    rec_scores = page.get('rec_scores', [])
+    lines = []
+    for poly, text, score in zip(dt_polys, rec_texts, rec_scores):
+        lines.append(f'{text} | conf={score:.2f}')
+    return '\n'.join(lines)
+
+text = ocr_full_text('/path/to/image.png')
+```
+
+> **API differences from v2**: v3 returns `{'rec_texts': [...], 'dt_polys': [...], 'rec_scores': [...]}` per page instead of `[(bbox, (text, score)), ...]`. Do not use `result[0][0][1][0]` — it will raise `KeyError`.
+
+### Language options
+
+| lang | Language |
+|------|----------|
+| `en` | English |
+| `ch` | Chinese only |
+| `ch+en` | Chinese + English mixed |
+| `fr` | French |
+| `de` | German |
+| `ja` | Japanese |
+| `ko` | Korean |
+
+### Large images
+
+Downscale if >4000px to improve speed and accuracy:
+
+```python
+from PIL import Image
+img = Image.open('large.png')
+img = img.resize((2000, int(2000 * img.height / img.width)))
+img.save('resized.png')
+```
+
+## Step 2 — Subagent Filtering
+
+After getting the full OCR text, spawn a subagent to extract **only what the user wants**:
+
+```python
+delegate_task(
+    goal=f"""Here is the raw OCR text extracted from an image:
+
+--- OCR RESULT START ---
+{ocr_text}
+--- OCR RESULT END ---
+
+User wants: <natural language requirement>
+Extract from the OCR result above only the information the user requested.
+If the user asks for specific fields (e.g. "日期" or "total amount"), return those fields as a JSON object.
+If the user asks to list items, return a structured list.
+Return ONLY the filtered result, do not summarize the image or describe what it is.""",
+    toolsets=["terminal"]
+)
+```
+
+**Important**: The subagent uses `toolsets=["terminal"]` — it only sees the OCR text, not the image.
+
+## Full Example: Receipt Data Extraction
+
+```python
+from paddleocr import PaddleOCR
+
+# Step 1: OCR
+ocr = PaddleOCR(lang='en')
+result = ocr.ocr('/path/to/receipt.png')
+page = result[0]
+rec_texts = page.get('rec_texts', [])
+dt_polys = page.get('dt_polys', [])
+rec_scores = page.get('rec_scores', [])
+ocr_text = '\n'.join(
+    f'{text} | conf={score:.2f}'
+    for text, score in zip(rec_texts, rec_scores)
+)
+
+# Step 2: Subagent filters
+delegate_task(
+    goal=f"""OCR text from a receipt:
+--- START ---
+{ocr_text}
+--- END ---
+
+Extract:
+- vendor_name: the store or company name
+- date: the transaction date
+- total_amount: the total amount paid (just the number)
+- items: list of items purchased as {{"item": "...", "price": "..."}}
+
+Return as JSON.""",
+    toolsets=["terminal"]
+)
+```
+
+## Common Pitfalls
+
+1. **Wrong API (PaddleOCR v3)** — `use_angle_cls`, `show_log`, `cls=True`, and tuple-unpacking `line[1][0]` are all wrong for v3. Use `PaddleOCR(lang=lang)` with no extra params, then access `result[0].get('rec_texts', [])`.
+2. **First-run slow** — PaddleOCR downloads inference models (~300MB) on first OCR call. Models are cached in `~/.paddlex/`.
+3. **Low confidence on small text** — Text below ~10px in the image will have poor accuracy. For menu bar icons / very small UI elements, use the vision subagent instead.
+4. **Subagent receives empty text** — If PaddleOCR returns empty, fall back to a vision subagent directly on the image.
+5. **Chinese + English** — Use `lang='ch+en'` for mixed content.
+
+## Verification Checklist
+
+- [ ] `python3 -c "from paddleocr import PaddleOCR; print('OK')"` runs without import error
+- [ ] OCR returns non-empty `rec_texts` list for a test image
+- [ ] Subagent goal contains the full OCR text (not just a path or summary)
+- [ ] Subagent returns only filtered results per the user's requirement
+
+---
+

package/skills/design/sync-design-html/SKILL.md

@@ -2,6 +2,7 @@
 name: sync-design-html
 description: Use after any UI source file change — detects changed view/component files via git diff and syncs them to high-fidelity HTML design backups. Maintains a manifest as the source-of-truth mapping between source files and HTML previews. Also invocable as a post-step from /ship or /review. Trigger when user says "sync design", "update HTML preview", "design changed", or after UI code edits.
 version: "3.0.0"
+user_invocable: true
 ---
 
 # Sync Design HTML

package/skills/harness/diataxis-docs/SKILL.md

@@ -2,6 +2,7 @@
 name: diataxis-docs
 version: "1.0.0"
 description: Use when creating, updating, or deleting any file under docs/ — including writing a new guide, updating reference content, adding an ADR, or removing an outdated page. Also use when searching docs before writing, to avoid duplicating existing content.
+user_invocable: true
 ---
 
 # Diataxis 文档管理