harveyz-skill 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.13.0] - 2026-06-12
+
+### Fixed
+- `opencode-runner`：description 移除中文字符，符合 F3 英文规范
+- `doc-forge`：测试 CSS 路径改为动态选取首个可用文件，不再依赖不存在的 `default.css`
+
+## [0.12.1] - 2026-06-10
+
+## [0.12.0] - 2026-06-09
+
+### Added
+- `url-extract`：新增 `detect_chrome_profile.py` 脚本，扫描本机 Chrome profile 并检测 X.com 登录态
+- `url-extract`：安装时 `CHROME_PROFILE` 变量改为 select 选择列表（自动列出所有 profile + 对应 Google 账号），保留手动输入兜底
+- `hskill`：安装/卸载完成后新增 "按 Enter 返回列表" 提示，避免 summary 被 fzf 立即覆盖
+
+### Changed
+- `url-extract` `vars.json`：`CHROME_PROFILE` 默认值从 `Profile 2` 更新为 `Default`
+
 ## [0.11.0] - 2026-06-09
 
 ### Added

package/bin/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
-import { select } from '@inquirer/prompts'
+import { select, input } from '@inquirer/prompts'
 import chalk from 'chalk'
 import { execSync, spawnSync } from 'child_process'
+import { existsSync } from 'fs'
 import { createRequire } from 'module'
 import os from 'os'
 import path from 'path'
@@ -26,7 +27,7 @@ const jsonFlag = args.includes('--json')
 // ── Help ─────────────────────────────────────────────────────────────────────
 function printHelp() {
   console.log(`
-  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, and Hermes  v${version}
+  ${chalk.bold('hskill')} — skill manager for Claude Code, Cursor, Codex, OpenClaw, Hermes, and OpenCode  v${version}
 
   ${chalk.cyan('Usage:')}
     hskill                         interactive install (requires TTY + fzf)
@@ -34,7 +35,7 @@ function printHelp() {
     hskill install --bundle <b>    install a skill bundle
     hskill install --skill <s>     install specific skill(s)
     hskill install --tool <t>      install shell tool(s)
-    hskill install --target <t>    set target (claude/cursor/codex/openclaw/hermes/all)
+    hskill install --target <t>    set target (claude/cursor/codex/openclaw/hermes/opencode/all)
     hskill install --scope <s>     set scope: user (default) or project
     hskill install --force         overwrite existing installs
     hskill list [--json]           list available skills and bundles
@@ -86,7 +87,7 @@ if (args[0] === '--help' || args[0] === '-h') {
             { name: '--bundle', arg: '<name>',   description: 'Install a skill bundle (comma-separated)' },
             { name: '--skill',  arg: '<name>',   description: 'Install specific skill(s) (comma-separated)' },
             { name: '--tool',   arg: '<name>',   description: 'Install shell tool(s) (comma-separated)' },
-            { name: '--target', arg: '<target>', description: 'Install target', enum: ['claude','cursor','codex','openclaw','hermes','all'] },
+            { name: '--target', arg: '<target>', description: 'Install target', enum: ['claude','cursor','codex','openclaw','hermes','opencode','all'] },
             { name: '--scope',  arg: '<scope>',  description: 'Install scope', enum: ['user','project'], default: 'user' },
             { name: '--force',  description: 'Overwrite existing installs' },
           ],
@@ -153,6 +154,15 @@ if (subcommand === 'update') {
     console.error(chalk.red('  ✗ Update failed. Try: npm update -g harveyz-skill'))
     process.exit(1)
   }
+  const legacyDir = path.join(os.homedir(), '.local', 'share', 'hskill')
+  if (existsSync(legacyDir)) {
+    console.log('')
+    console.log(chalk.yellow('  ⚠ Legacy data detected at ~/.local/share/hskill/'))
+    console.log(chalk.dim('  Run the migration script to move data to the new location:'))
+    console.log('')
+    console.log('     ' + chalk.bold.cyan('bash "$(npm root -g)/harveyz-skill/scripts/migrate-data-dir.sh"'))
+    console.log('')
+  }
   process.exit(0)
 }
 
@@ -221,7 +231,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
   })
 
   if (jsonFlag) {
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
     const jsonSkills = skillRows.map(r => ({
       name: r.name,
       version: r.version,
@@ -253,7 +263,7 @@ if (subcommand === 'status' || subcommand === 'outdated') {
       process.exit(0)
     }
 
-    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    const targets = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
     if (outdatedSkills.length) {
       console.log('\n  ' + chalk.bold('SKILLS WITH UPDATES'))
@@ -438,7 +448,7 @@ if (subcommand === 'uninstall') {
   const scope = scopeArg2
   const selectedTargets = targetArg2
     ? [targetArg2]
-    : ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+    : ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
   const targets = resolveTargets(selectedTargets, scope)
 
   let anyRemoved = false
@@ -598,7 +608,7 @@ 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']
+const ALL_SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
 function selectTargetThenScope() {
   // Step 1: platform (target)
@@ -608,7 +618,8 @@ function selectTargetThenScope() {
     'codex     ~/.codex/skills/',
     'openclaw  ~/.openclaw/skills/',
     'hermes    ~/.hermes/skills/',
-    'all       all 5 targets',
+    'opencode  ~/.config/opencode/skills/',
+    'all       all 6 targets',
   ].join('\n')
 
   const targetResult = spawnSync('fzf', [
@@ -1069,6 +1080,8 @@ try {
       // In test mode with HSKILL_TEST_ACTION, run once and exit
       if (process.env.HSKILL_TEST_ACTION) break
 
+      if (process.stdout.isTTY) await input({ message: chalk.dim('按 Enter 返回列表…'), default: '' })
+
       // Loop back to skill selector automatically
     }
 
@@ -1105,7 +1118,7 @@ try {
     // When only --skill is given and no --target, use the combined selector.
     if (targetArg) {
       const scope = scopeArg ?? 'user'
-      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes'] : [targetArg]
+      const selectedTargets = targetArg === 'all' ? ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode'] : [targetArg]
       const targets = resolveTargets(selectedTargets, scope)
       console.log('')
       skillSummary = await installSkills(skillItems, targets, forceFlag)

package/bin/preview.mjs

@@ -19,7 +19,7 @@ if (!skillName) process.exit(0)
 if (kind !== 'skill') {
   const home = os.homedir()
   const installedBin  = path.join(home, '.local', 'bin', skillName)
-  const installedMeta = path.join(home, '.local', 'share', 'hskill', 'tools', `${skillName}.json`)
+  const installedMeta = path.join(home, '.hskill', 'tools', `${skillName}.json`)
 
   function readToolMeta(jsonPath) {
     try {

package/lib/bundles.js

@@ -3,7 +3,7 @@ import os from 'os'
 import { createRequire } from 'module'
 import path from 'path'
 import { fileURLToPath } from 'url'
-import { SKILL_TARGETS, USER_ONLY_TARGETS } from './targets.js'
+import { SKILL_TARGETS, USER_ONLY_TARGETS, userSkillDir } from './targets.js'
 
 const require = createRequire(import.meta.url)
 const __dirname = path.dirname(fileURLToPath(import.meta.url))
@@ -154,7 +154,7 @@ export function checkInstalled(skillName, availableVersion) {
   const noneScope = Object.fromEntries(targets.map(t => [t, { version: '—', status: 'none' }]))
 
   return {
-    user:    checkScope(t => path.join(home, `.${t}`, 'skills')),
+    user:    checkScope(t => userSkillDir(t)),
     project: cwd === home ? noneScope : checkScope(t =>
       USER_ONLY_TARGETS.has(t) ? null : path.join(cwd, `.${t}`, 'skills')
     ),
@@ -263,7 +263,7 @@ export function checkHookInstalled(hookName) {
 
 export { formatChoice, readVersion, readHookVersion }
 
-const HSKILL_TOOLS_DATA = path.join(os.homedir(), '.local', 'share', 'hskill', 'tools')
+const HSKILL_TOOLS_DATA = path.join(os.homedir(), '.hskill', 'tools')
 
 function readToolMeta(jsonPath) {
   try {

package/lib/installer.js

@@ -55,7 +55,7 @@ export async function installTools(tools, targetDir, force = false) {
     if (destExists && !force) {
       // Version-aware upgrade logic (mirrors skill behavior)
       const home          = os.homedir()
-      const dataDir       = path.join(home, '.local', 'share', 'hskill', 'tools')
+      const dataDir       = path.join(home, '.hskill', 'tools')
       const installedMeta = path.join(dataDir, `${toolName}.json`)
       const sourceMeta    = path.join(srcPath, 'tool.json')
 
@@ -130,7 +130,7 @@ export async function installTools(tools, targetDir, force = false) {
       const content = await fs.readFile(scriptSrc, 'utf-8')
       await fs.writeFile(destPath, substituteVars(content, varsMap), { encoding: 'utf-8', mode: 0o755 })
 
-      const dataDir = path.join(os.homedir(), '.local', 'share', 'hskill', 'tools')
+      const dataDir = path.join(os.homedir(), '.hskill', 'tools')
 
       const toolJsonSrc = path.join(srcPath, 'tool.json')
       if (await fs.pathExists(toolJsonSrc)) {
@@ -537,7 +537,7 @@ export async function uninstallTool(toolName, opts = {}) {
   const { yes = false } = opts
   const home     = os.homedir()
   const binPath  = path.join(home, '.local', 'bin', toolName)
-  const dataDir  = path.join(home, '.local', 'share', 'hskill', 'tools')
+  const dataDir  = path.join(home, '.hskill', 'tools')
   const jsonPath = path.join(dataDir, `${toolName}.json`)
   const pyPath   = path.join(dataDir, `${toolName}.py`)
 

package/lib/targets.js

@@ -1,13 +1,22 @@
 import os from 'os'
 import path from 'path'
 
-export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes']
+export const SKILL_TARGETS = ['claude', 'cursor', 'codex', 'openclaw', 'hermes', 'opencode']
 
 export const USER_ONLY_TARGETS = new Set(['openclaw', 'hermes'])
 
+// Targets whose user-level skill dir doesn't follow ~/.{name}/skills
+const USER_DIR_OVERRIDES = {
+  opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
+}
+
+export function userSkillDir(name) {
+  return USER_DIR_OVERRIDES[name] ?? path.join(os.homedir(), `.${name}`, 'skills')
+}
+
 function skillDir(name, scope) {
   if (USER_ONLY_TARGETS.has(name) || scope !== 'project')
-    return path.join(os.homedir(), `.${name}`, 'skills')
+    return userSkillDir(name)
   return path.join(process.cwd(), `.${name}`, 'skills')
 }
 
@@ -17,6 +26,7 @@ export const TARGETS = {
   codex:    path.join(os.homedir(), '.codex',    'skills'),
   openclaw: path.join(os.homedir(), '.openclaw', 'skills'),
   hermes:   path.join(os.homedir(), '.hermes',   'skills'),
+  opencode: path.join(os.homedir(), '.config', 'opencode', 'skills'),
   shell:    path.join(os.homedir(), '.local', 'bin'),
 }
 

package/lib/vars.js

@@ -2,7 +2,7 @@
 import fs from 'fs-extra'
 import path from 'path'
 import os from 'os'
-import { input } from '@inquirer/prompts'
+import { input, select } from '@inquirer/prompts'
 
 export function buildAutoVars() {
   return { HOME: os.homedir() }
@@ -20,10 +20,49 @@ export function substituteVars(text, varsMap) {
   return text.replace(/\{\{(\w+)\}\}/g, (_, name) => varsMap[name] ?? `{{${name}}}`)
 }
 
+async function detectChromeProfiles() {
+  const chromeBase = path.join(os.homedir(), 'Library/Application Support/Google/Chrome')
+  if (!await fs.pathExists(chromeBase)) return []
+
+  const entries = await fs.readdir(chromeBase)
+  const profileDirs = entries.filter(e => e === 'Default' || e.startsWith('Profile '))
+  profileDirs.sort((a, b) => (a === 'Default' ? -1 : b === 'Default' ? 1 : a.localeCompare(b)))
+
+  const profiles = []
+  for (const name of profileDirs) {
+    const dir = path.join(chromeBase, name)
+    let email = ''
+    try {
+      const prefs = await fs.readJson(path.join(dir, 'Preferences'))
+      const accounts = prefs.account_info ?? []
+      email = accounts[0]?.email ?? prefs.user_name ?? ''
+    } catch { /* unreadable */ }
+    profiles.push({ name, dir, email })
+  }
+  return profiles
+}
+
 export async function resolveVars(varDefs = [], autoVars) {
   const result = { ...autoVars }
   for (const def of varDefs) {
     const defaultVal = substituteVars(def.default ?? '', autoVars)
+
+    if (def.type === 'chrome_profile_select') {
+      const profiles = await detectChromeProfiles()
+      if (profiles.length > 0) {
+        const choices = profiles.map(p => ({
+          name: p.email ? `${p.name}  (${p.email})` : p.name,
+          value: p.dir,
+        }))
+        choices.push({ name: '手动输入路径…', value: '__manual__' })
+        const selected = await select({ message: `${def.description}:`, choices })
+        if (selected !== '__manual__') {
+          result[def.name] = selected
+          continue
+        }
+      }
+    }
+
     const value = await input({
       message: `${def.description}:`,
       default: defaultVal,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harveyz-skill",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "description": "Skill manager for Claude Code, Cursor, and Codex",
   "type": "module",
   "bin": {
@@ -16,30 +16,30 @@
     "bundles.json",
     "skills-index.json",
     "CHANGELOG.md",
-    "skills/analysis/skill-analyzer/",
-    "skills/harness/diataxis-docs/",
-    "skills/harness/full-stack-debug-env/",
-    "skills/superpowers-fork/brainstorming/",
-    "skills/harness/git-workflow-init/",
-    "skills/superpowers-fork/executing-plans/",
-    "skills/superpowers-fork/systematic-debugging/",
-    "skills/superpowers-fork/using-git-worktrees/",
-    "skills/superpowers-fork/writing-plans/",
-    "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/research/article-fetcher/",
+    "skills/research/url-extract/",
+    "skills/research/vision-extract/",
+    "skills/research/youtube-learner/",
+    "skills/creative/add-todo/",
+    "skills/creative/insight/",
+    "skills/coding/git-workflow-init/",
+    "skills/coding/full-stack-debug-env/",
+    "skills/coding/pm-task-dispatch/",
+    "skills/coding/task-close/",
+    "skills/writing/doc-forge/",
+    "skills/writing/diagram/",
+    "skills/writing/diataxis-docs/",
+    "skills/writing/dir-manage/",
+    "skills/writing/migrate-specs/",
+    "skills/design/brand-scout/",
+    "skills/design/style-build/",
     "skills/design/sync-design-html/",
-    "skills/analysis/git-cleanup/",
+    "skills/meta/skill-analyzer/",
+    "skills/meta/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/",
+    "skills/meta/opencode-runner/",
     "tools/p-launch/",
     "hooks/check-similar-branch/"
   ],

package/skills/creative/add-todo/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: add-todo
+version: "4.0.0"
+user_invocable: true
+description: "Add a new requirement, task, or feature request to any project's TODO.md — from any working directory. Triggers whenever the user wants to capture a new need — even phrased casually like 'we should do X later', 'add this to the backlog', 'note this down', 'remember to build X', 'we need to do Y at some point', or 'record this for later'."
+---
+
+# 写入 TODO
+
+快速捕获需求：先用 2-3 个问题把需求说清楚，再根据完整的需求信息匹配项目、生成标题，最后写入 TODO.md。
+
+## 核心原则
+
+**先把需求说清楚，再定项目归属。** 完整的需求描述是项目匹配最好的材料。问题只聚焦需求本身，不聚焦方案。够写一条清晰的任务条目就停，不要拖长。
+
+---
+
+## 阶段一 — 需求确认（2-3 轮）
+
+**按需提问，已从上下文明确的直接跳过：**
+
+1. **需求** — 要解决什么问题、实现什么功能？（用户已清晰描述则复述确认即可）
+2. **紧急程度** — 有多急？（默认 P2，只在用户暗示紧急或不重要时调整）
+3. **背景** — 为什么现在提出来？（可选，有助于写出有上下文的描述）
+
+**提问方式：**
+- 每次只问一个问题
+- 优先给选项而非开放题："这个更像 (A) 缺失功能 还是 (B) 现有功能的问题？"
+- 2 轮够用时不要凑到 3 轮
+
+---
+
+## 阶段二 — 确认项目归属
+
+需求收集完毕后，用 Read 工具读取项目注册表：
+
+```
+~/.hskill/todo-tool/PROJECTS.md
+```
+
+同时用 Bash 运行 `pwd` 获取当前目录。
+
+### 匹配逻辑
+
+综合以下信号推断候选项目：
+
+1. **当前目录**：`pwd` 输出是否是某个项目 `local_path` 的子路径 → 强信号
+2. **需求关键词 + 项目描述**：需求描述中的词汇是否与项目名或描述匹配 → 中信号
+3. **语义推断**：需求内容在哪个项目的业务范围内 → 弱信号
+
+### 确认策略
+
+| 情况 | 行动 |
+|------|------|
+| 唯一高置信匹配 | 告知并请确认："这是 **[项目名]** 的需求，对吗？" |
+| 2-3 个候选 | 列出候选，请用户选择 |
+| 无匹配或不确定 | 展示完整项目列表，让用户选 |
+
+> **谨慎原则**：宁可多问一次，不写入错误项目。
+
+### 生成标题
+
+项目确认后，根据完整需求生成任务标题：
+
+- 祈使句，动词开头，直接说明要做什么
+- ≤20 字，超出则提炼核心、去掉修饰语
+- 足够具体，让人一眼看出任务核心，避免泛泛的"优化"、"修复"
+- 不堆砌细节，只抓最关键的区分点
+
+**示例：**
+- ✗ "优化系统" → ✓ "重构视频解析模块以支持多格式输入"
+- ✗ "修复 bug" → ✓ "修复字幕导出时 UTF-8 编码乱码"
+- ✗ "添加功能" → ✓ "为 add-todo skill 添加 SQLite 持久化层"
+
+展示摘要等用户确认：
+> "记录为：**[项目名]** — [生成的标题]，[优先级]。确认吗？"
+
+---
+
+## 阶段三 — 写入 TODO.md
+
+### 确定文件路径
+
+从阶段二确认的项目的 `local_path` 取出路径，TODO.md 位于 `{local_path}/TODO.md`。
+
+若该项目无 `local_path`，询问用户本地目录，写入后提示注册：
+```bash
+todo project set-path [项目名] [本地路径]
+```
+
+### 重复检查
+
+加载文件，扫描是否有语义重叠的已有条目。若有：
+> "发现可能重叠的条目：**[已有标题]**。这是同一件事还是独立需求？"
+
+由用户决定：跳过、替换或独立写入。
+
+### 写入格式
+
+追加到 `## 🚧 待开发` 末尾：
+
+```markdown
+### [任务标题（≤20 字）]
+**优先级**: P? | **日期**: YYYY-MM-DD
+
+[描述：做什么、为什么。不写怎么做。篇幅以说清楚为准，不限长短。]
+
+---
+```
+
+文件不存在则创建，初始结构：
+
+```markdown
+# TODO / Backlog
+
+## 🚧 待开发
+
+## ✅ 已完成
+```
+
+写入后确认：
+
+> "✅ 已将 **[任务标题]** 写入 `{local_path}/TODO.md`。"

package/skills/{writing/capture-insight → creative/insight}/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: capture-insight
+name: insight
 version: "1.1.0"
 user_invocable: true
 description: "Capture and record a fleeting insight or observation. Triggers immediately when the user expresses an observation, judgment, or idea — phrases like 'I noticed', 'just an observation', 'record this', 'insight', 'I have a judgment', or tossing out an opinionated thought. Distinct from 'I have an idea to execute' (that's a task). Clarifies the core with 2-3 quick Q&As, then saves to the insights/ folder. Trigger early — insights are fragile."