🛠 22 Hack 实施笔记

voice-to-text + pre-commit-active + skill-run — 3 个新工具

📊 实施总览

🎙 Hack #1: voice-to-text (3.8KB)

目的: CLI/TUI 模式下用 macOS Dictation 录音转写 (替代 Web Speech API 的限制)

voice-to-text                  # 录音, 转写结果到 stdout
voice-to-text --out FILE      # 转写结果写入 FILE
voice-to-text --paste         # 直接复制到剪贴板
voice-to-text --timeout N     # 设置超时秒数

前置条件:

1. System Settings > Keyboard > Dictation > ON
2. Dictation 快捷键设 Fn Fn (或自定义)
3. 首次会弹"允许 Dictation"权限

限制:

• 仅 macOS 12+
• 需在线 (Apple servers) 或本地 Siri
• 中文支持好 (简体/繁体)
• 延迟 1-2s (实时)

🔨 Hack #2: pre-commit-active (4.2KB)

目的: 高危操作前主动 commit (替代 1 小时兜底 git-auto-sync.sh)

pre-commit-active                  # 有变更则 commit
pre-commit-active --force          # 强制 commit
pre-commit-active --task "描述"     # 写详细 commit message
pre-commit-active --stash          # 暂存 (后续 --stash-pop 恢复)
pre-commit-active --workspace DIR  # 指定 workspace
pre-commit-active --stash-pop      # 恢复暂存

与 git-auto-sync.sh 区别:

• git-auto-sync.sh: 1 小时兜底 (事后)
• pre-commit-active.sh: 高危操作前主动 commit (事前)

Commit message 格式:

active-commit: 2026-06-11 14:30:00

🔨 Auto pre-commit (Hack #5 from MAT 22 Hacks)

- Time: 2026-06-11 14:30:00
- Workspace: patricks-reports
- Branch: main
- Files: 5 changed
- Stats: 2 files changed, 100 insertions(+), 5 deletions(-)

🔗 Hack #3: skill-run (3.6KB) — Skill-to-Skill API

目的: Skill 之间显式调用 + 共享数据 (避免重复 prompt)

skill-run SKILL_NAME               # view SKILL.md
skill-run --list                   # list all skills
skill-run --search KEYWORD         # search skills
skill-run --chain s1,s2,s3         # chain (output piped)
skill-run SKILL_NAME --run         # run skill's scripts/run.sh
skill-run SKILL_NAME --section SEC # view specific section

示例 chain (Patrick 实际工作流):

# 场景: 用户问"今天 WWDC 视频怎么样"
skill-run --chain "video-to-obsidian,patrick-knowledge"

# 场景: 用户说"推 vault 内容到公网"
skill-run --chain "obsidian-vault-bidirectional-sync,public-html-deploy-cloudflare-pages"

优势:

• 复用: 不重写 prompt
• 可追溯: chain 模式记录每步结果
• 可测试: 单独测每个 skill
• 可分享: 别人用同样 chain 跑自己的任务

🔧 配 PATH + alias (顺手修)

之前 ~/bin 不在 PATH, 需全路径。现在修了:

• ~/.zshrc 加 export PATH="$HOME/bin:$PATH"
• 加 5 个 alias (无 .sh 后缀): voice-to-text, pre-commit-active, vault-sync, vault-knowledge-sync, daily-reports-sync

✅ 验证

$ zsh -c "source ~/.zshrc; which voice-to-text pre-commit-active vault-sync"
voice-to-text: aliased to /Users/patrick/bin/voice-to-text.sh
pre-commit-active: aliased to /Users/patrick/bin/pre-commit-active.sh
vault-sync: aliased to /Users/patrick/bin/sync-vault-bidirectional.sh

$ skill-run --list | wc -l
# 250+ skills

$ skill-run --chain "voice-to-text,skill-run-api" 2>&1 | grep "=== Running"
=== Running: voice-to-text ===
=== Running: skill-run-api ===

📈 22 Hack 覆盖度 (更新)

21 → 23/22 (原 21 强推 + 2 升级)

📋 后续 (可选)

• 把 pre-commit-active 集成到 Hermes 高危操作 (skill_manage action=delete, terminal rm) 之前
• 给更多 skill 加 scripts/run.sh (think-quest, video-to-obsidian, vault-sync) 让 chain 更实用
• 把 voice-to-text 配 Hermes TUI 快捷键 (e.g. Ctrl+B)
• 写一个 skill new NAME --from SKILL.md 工具