菜单
Generate diagnostic HTML reports from utility-bill-manager sync logs. Analyzes logs for errors, identifies root causes, and creates a visual report in a temp directory. Use when debugging failed syncs, understanding why 0 bills were downloaded, or reviewing navigator behavior.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/mccode415/agent --skill sync-report命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
基于 SOC 职业分类
正在显示 SKILL.md
| name | sync-report |
| description | Generate diagnostic HTML reports from utility-bill-manager sync logs. Analyzes logs for errors, identifies root causes, and creates a visual report in a temp directory. Use when debugging failed syncs, understanding why 0 bills were downloaded, or reviewing navigator behavior. |
| tools | Bash, Read, Write, Grep |
Generate visual HTML diagnostic reports from utility-bill-manager sync logs. Reports are created in a temp directory (not in the repo) and automatically opened in the browser.
Invoke this skill with:
/sync-report /path/to/sync.log| Category | Patterns | Severity |
|---|---|---|
| VectorDB | sqlite-vec search failed, SqliteError | High |
| LLM Failures | LLM failed, No high-confidence memory match | Medium |
| Selector Issues | not found on page, Invalid selector, SyntaxError | High |
| Element Issues | detached from DOM, Element detached | Medium |
| PDF Download | Could not extract PDF, blob extraction failed | High |
| Navigation | FAILED:, action_failed | Medium |
| Timeout | exceeded timeout, timed out | Medium |
If user provides a file path, read it. Otherwise, check recent logs:
# Find recent utility-bill-manager logs
ls -lt ~/Library/Logs/utility-bill-manager/*.log 2>/dev/null | head -5
# Or check Electron dev logs
ls -lt /tmp/utility-bill-manager*.log 2>/dev/null | head -5
Parse the log for important events:
# Count errors by type
grep -c "ERROR\|FAILED\|failed" "$LOG_FILE"
# Find VectorDB issues
grep "VectorDB.*failed\|SqliteError" "$LOG_FILE"
# Find selector failures
grep "not found on page\|SyntaxError" "$LOG_FILE"
# Find LLM status
grep "LLM failed\|LLM.*trying" "$LOG_FILE"
# Find download results
grep "bills downloaded\|PDF.*captured\|PDF.*extracted" "$LOG_FILE"
# Find bill amounts from HTML
grep "HTML-EXTRACT" "$LOG_FILE"
Create the report in the scratchpad directory (session-specific temp):
# Get the scratchpad directory from environment or use fallback
SCRATCHPAD="${CLAUDE_SCRATCHPAD:-/tmp/claude-sync-reports}"
mkdir -p "$SCRATCHPAD"
# Generate unique filename
REPORT_FILE="$SCRATCHPAD/sync-report-$(date +%Y%m%d-%H%M%S).html"
The HTML report should include:
Summary Card
Failure Cascade Flow
Root Causes
Event Timeline
Recommendations
# macOS
open "$REPORT_FILE"
# Linux
xdg-open "$REPORT_FILE" 2>/dev/null || echo "Report saved to: $REPORT_FILE"
Use this template structure for the report:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Sync Diagnostic Report</title>
<style>
:root {
--bg: #0f1419;
--card-bg: #1a1f2e;
--accent: #3b82f6;
--success: #10b981;
--warning: #f59e0b;
--error: #ef4444;
--text: #e5e7eb;
--text-muted: #9ca3af;
--border: #374151;
}
body {
font-family: 'SF Mono', 'Fira Code', monospace;
background: var(--bg);
color: var(--text);
padding: 2rem;
line-height: 1.6;
}
.container { max-width: 1200px; margin: 0 auto; }
.card {
: (--card-bg);
: ;
: ;
: ;
: solid (--border);
}
{
: inline-block;
: ;
: ;
: ;
: ;
}
{ : (, , , ); : (--error); }
{ : (, , , ); : (--success); }
{ : (, , , ); : (--warning); }
{ : (--accent); }
{ : solid (--border); : ; }
pre {
: ;
: ;
: ;
: auto;
: ;
}
{
: relative;
: ;
}
{
: ;
: absolute;
: ;
: ;
: ;
: ;
: (--border);
}
{
: relative;
: ;
}
{
: ;
: absolute;
: -;
: ;
: ;
: ;
: ;
: (--border);
}
{ : (--error); }
{ : (--success); }
{
: flex;
: wrap;
: ;
: center;
}
{
: (--card-bg);
: ;
: ;
: ;
: solid (--border);
}
{ : (--error); : (--error); }
{ : (--success); : (--success); }
{ : (--text-muted); }
Sync Diagnostic Report
Generated: [TIMESTAMP] | Profile: [PROFILE]
Result: [RESULT]
Steps: [STEPS] | Errors: [ERRORS] | Bills: [DOWNLOADED]/[FOUND]
Failure Cascade
[FLOW_STEPS]
Issues Identified
[ISSUE_CARDS]
Event Timeline
[TIMELINE_ITEMS]
Recommendations
[RECOMMENDATIONS]
Pattern: "sqlite-vec search failed" OR "SqliteError"
Root Cause: LIMIT and k=? conflict in query
Impact: Navigation memory disabled, forces LLM fallback
Pattern: "SyntaxError" + "querySelectorAll" + ":has-text"
Root Cause: Playwright selector used with native DOM API
Impact: Retry logic fails completely
Pattern: "Could not extract PDF content from blob"
Root Cause: Cross-origin restriction on blob URL
Impact: PDF viewer opens but content not captured
Pattern: "detached from DOM" OR "Element detached"
Root Cause: SPA navigation changes DOM during click
Impact: Click succeeds but follow-up actions fail
Pattern: "LLM failed Xx" followed by "hardcoded fallback"
Root Cause: Vision model couldn't identify correct element
Impact: Falls back to potentially stale selectors
After running, report the location:
Sync diagnostic report generated:
/tmp/claude-sync-reports/sync-report-20260204-063126.html
Opening in browser...
/Users/mcai/src/util/utility-bill-manager/electron/main/services/intelligent-navigator.ts - Main navigation/Users/mcai/src/util/utility-bill-manager/electron/main/services/vector-db.ts - Navigation memory/Users/mcai/src/util/utility-bill-manager/electron/main/services/browser-agent.ts - PDF handling