Utility Skills

通用辅助技能，用于日常任务：文档处理（PDF、XLSX）、记忆管理、屏幕截图、密码管理、天气查询、文字转语音、视频下载等。这些技能处理那些不太适合归入其他类别的杂项但必要的操作。

概览

Utility 技能涵盖广泛的日常操作。一些是由 harness 直接加载的内置技能，另一些则以 MCP 服务器或外部工具集成的形式实现。其中五个技能默认激活（开箱即用）；其余七个可用但需要配置或外部依赖。

memory

跨会话持久化记忆。memory 技能会自动保存重要上下文——决策、偏好、项目笔记、反馈——并在相关时自动召回。记忆以 Markdown 文件形式存储在 ~/.cli-jaw/memory/ 下，并通过 SQLite 索引实现快速检索。

功能

使用示例

# Manually save a note
/memory save "JWT tokens expire after 24h in this project"

# Search memories
/memory search "authentication"

# List all memory files
/memory list

# Delete a specific memory
/memory delete shared/old-decision.md

记忆结构

记忆被组织为命名空间化的 Markdown 文件。自动记忆系统将 MEMORY.md 作为索引，详细条目存储在特定主题的文件中。

~/.cli-jaw/memory/
  MEMORY.md                    # Index with links to detailed files
  feedback_goal_done_method.md # Specific feedback entry
  feedback_poll_dont_wait.md   # Another feedback entry
  shared/
    decisions.md               # Shared project decisions
    preferences.md             # User preferences

pdf

基于文本的 PDF 处理。读取 PDF 文件，提取文本内容，解析结构（标题、表格、列表），并支持摘要。最适合包含可选中文本的数字化 PDF。

功能

使用示例

# Read a PDF file
/pdf read ~/Documents/report.pdf

# Read specific pages
/pdf read ~/Documents/report.pdf --pages 1-5

# Summarize a PDF
/pdf summarize ~/Documents/whitepaper.pdf

# Extract metadata
/pdf info ~/Documents/contract.pdf

pdf-vision

基于视觉的 PDF 阅读。使用多模态模型来解读扫描文档、图片密集的 PDF 以及文本提取失败的页面。每一页都被渲染为图像并进行视觉分析，因此该技能对于手写笔记、扫描收据和复杂排版至关重要。

何时使用 pdf-vision 与 pdf

使用示例

# Read a scanned PDF with vision
/pdf-vision read ~/Documents/scanned-receipt.pdf

# Analyze specific pages visually
/pdf-vision read ~/Documents/diagram-heavy.pdf --pages 3-5

# Extract text from a handwritten note
/pdf-vision read ~/Documents/handwritten.pdf

screen-capture

截取整个屏幕、特定窗口或指定区域的截图。截取的图像可以由视觉模型分析、保存到磁盘，或作为其他技能（如 vision-click）的输入。

功能

使用示例

# Capture full screen
/screen-capture

# Capture and analyze the screen
/screen-capture --analyze

# Save to a specific path
/screen-capture --output ~/Desktop/screenshot.png

# Capture a specific region (x, y, width, height)
/screen-capture --region 0,0,800,600

xlsx

Excel 电子表格处理。读取、写入和操作 .xlsx 文件——从工作表中提取数据、创建新工作簿、更新单元格，以及在不同格式（CSV、JSON）之间转换。支持公式、多工作表和基本格式化。

功能

使用示例

# Read an Excel file
/xlsx read ~/Documents/sales-data.xlsx

# Read a specific sheet
/xlsx read ~/Documents/report.xlsx --sheet "Q4 Summary"

# Convert XLSX to CSV
/xlsx convert ~/Documents/data.xlsx --to csv

# Create a new spreadsheet from data
/xlsx write ~/Documents/output.xlsx --data '[{"name":"Alice","score":95},{"name":"Bob","score":87}]'

1password

从 1Password 保险库安全查找凭证。1password 技能使用 1Password CLI（op）搜索和检索项目——登录信息、密码、安全笔记、API 密钥——而不会在对话中以明文形式暴露。凭证直接注入到命令或环境变量中。

功能

使用示例

# Search for a credential
/1password search "GitHub token"

# Get a specific password
/1password get "AWS Production" --field password

# Inject a secret into a command
op run --env-file=.env -- jaw serve

# List all vaults
/1password vaults

goplaces

基于位置的搜索和导航。查找地点、提供路线导航，并返回商家、地标和地址的相关信息。通过 MCP 服务器调用地图 API 实现。

功能

使用示例

# Search for a place
/goplaces search "coffee shops near Gangnam Station"

# Get directions
/goplaces directions "Seoul Station" "Gangnam Station"

# Get details about a specific place
/goplaces details "Starbucks Gangnam"

# Find nearby restaurants
/goplaces nearby --type restaurant --radius 500m

summarize

将长文本浓缩为简洁摘要。适用于文章、录音记录、会议笔记、文档和任何长文本输入。支持多种摘要样式——要点列表、段落、执行摘要和关键要点。

使用示例

# Summarize a file
/summarize ~/Documents/meeting-notes.md

# Summarize with a specific style
/summarize ~/Documents/report.pdf --style bullets

# Summarize clipboard content
/summarize --clipboard

# Summarize a web article
/summarize https://example.com/long-article

tts

文字转语音。使用 TTS 引擎（系统语音或云端 API）将文本输入转换为语音音频。适用于朗读文档、从文本生成音频文件以及无障碍访问。

使用示例

# Speak text aloud
/tts "Hello, this is a test of the text-to-speech system."

# Save to file
/tts "Meeting summary follows..." --output ~/Desktop/summary.mp3

# Use a specific voice
/tts "안녕하세요" --voice korean --engine openai

# Read a file aloud
/tts --file ~/Documents/notes.md

video-downloader

使用 yt-dlp 从 URL 下载视频。支持 YouTube、Vimeo 以及数百个其他视频平台。可以选择画质、仅提取音频、下载字幕，并保存到指定目录。

功能

使用示例

# Download a video
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ

# Download audio only
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --audio

# Download with specific quality
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --quality 720p

# Download subtitles
/video-downloader https://www.youtube.com/watch?v=dQw4w9WgXcQ --subs ko

video-frames

从视频文件中提取单帧用于分析。按指定的时间间隔或时间戳截取帧，输出为图像，并可选择将其发送到视觉模型进行描述。适用于视频摘要、内容分析和缩略图生成。

使用示例

# Extract one frame per second
/video-frames ~/Videos/demo.mp4 --interval 1s

# Extract frame at a specific timestamp
/video-frames ~/Videos/demo.mp4 --at 01:23:45

# Extract and analyze frames with vision model
/video-frames ~/Videos/demo.mp4 --interval 10s --analyze

# Generate thumbnails for a video
/video-frames ~/Videos/demo.mp4 --count 5 --output ~/Desktop/thumbs/

weather

当前天气状况和预报。提供任意位置的温度、湿度、风速、降水和多日预报。以 MCP 服务器的形式实现，查询天气 API。

功能

使用示例

# Get current weather
/weather Seoul

# Get a 5-day forecast
/weather forecast "San Francisco" --days 5

# Get hourly forecast
/weather hourly Tokyo --hours 24

# Check weather alerts
/weather alerts "New York"

配置

{
  "mcpServers": {
    "weather": {
      "command": "npx",
      "args": ["-y", "weather-mcp-server"],
      "env": {
        "WEATHER_API_KEY": "your-api-key",
        "WEATHER_DEFAULT_LOCATION": "Seoul"
      }
    }
  }
}

技能对比

快速参考，帮助您为任务选择合适的 Utility 技能。

文档处理

媒体与截取

信息与密钥

常见模式

文档处理流水线

组合 PDF 和摘要技能，实现端到端的文档处理。

# Read a PDF, summarize it, and save the summary
"이 PDF 읽고 요약해서 엑셀로 정리해줘"

# The agent chains:
# 1. pdf → read the document
# 2. summarize → condense key points
# 3. xlsx → write summary to a spreadsheet

调研工作流

将天气、位置和记忆技能结合使用，完成规划任务。

# Plan a trip
"이번 주말 부산 날씨 알려주고, 근처 맛집 찾아줘. 결과 기억해둬."

# The agent chains:
# 1. weather → forecast for Busan this weekend
# 2. goplaces → search restaurants near Busan
# 3. memory → save results for later reference

安全开发

从 1Password 获取凭证并注入到您的开发环境中。

# Set up dev environment with secure credentials
"1Password에서 DB 비밀번호 찾아서 .env에 넣어줘"

# The agent chains:
# 1. 1password → get "Database Production" password
# 2. inject into .env file via op:// reference