Agent Skills › opensquilla/opensquilla › history-explorer

history-explorer

GitHub

分析技能调用日志，统计共现模式、元技能使用率及路由器测试用例。用于回顾历史使用数据，辅助下游任务或独立查询高频技能使用情况。

src/opensquilla/skills/bundled/history-explorer/SKILL.md opensquilla/opensquilla

触发场景

查看本周最常使用的技能分析技能共现模式获取元技能使用统计

安装

npx skills add opensquilla/opensquilla --skill history-explorer -g -y

更多选项

非标准路径

npx skills add https://github.com/opensquilla/opensquilla/tree/main/src/opensquilla/skills/bundled/history-explorer -g -y

不安装直接使用

npx skills use opensquilla/opensquilla@history-explorer

指定 Agent (Claude Code)

npx skills add opensquilla/opensquilla --skill history-explorer -a claude-code -g -y

安装 repo 全部 skill

npx skills add opensquilla/opensquilla --all -g -y

预览 repo 内 skill

npx skills add opensquilla/opensquilla --list

SKILL.md

Frontmatter

{
    "name": "history-explorer",
    "metadata": {
        "requires": {
            "anyBins": [
                "python",
                "python3"
            ]
        }
    },
    "entrypoint": {
        "args": [
            "--query",
            "{{ with.query | truncate(512) }}",
            "--window-days",
            "{{ with.window_days | default('30') }}",
            "--include",
            "{{ with.include | join(',') if with.include is sequence and with.include is not string else with.include | default('co_occurrences,meta_usage,router_fixtures') }}",
            "--top-k",
            "10"
        ],
        "parse": "json",
        "command": "python {baseDir}\/scripts\/explore.py",
        "timeout": 30
    },
    "provenance": {
        "origin": "opensquilla-original",
        "license": "Apache-2.0"
    },
    "description": "Query the per-turn DecisionEntry log for skill co-occurrence patterns, meta-skill usage stats, and the router fixture corpus. Returns a JSON summary suitable for downstream LLM consumption. Used by meta-skill-creator's harvest step but also useful standalone for 'which skills did I use most this week?'",
    "description_zh": "查询每轮的DecisionEntry日志，分析技能共现模式、元技能使用统计和路由器fixture语料库，返回适合下游LLM消费的JSON摘要。供meta-skill-creator的harvest步骤使用，也可单独用于'本周我最常用哪些技能？'之类的查询。"
}

History Explorer

Lightweight read-only view over ~/.opensquilla/logs/decisions-*.jsonl. Aggregates DecisionEntry.skills_invoked (SCHEMA_VERSION 10) into co-occurrence frequencies, joins with SkillLoader.list_meta_specs() for meta-skill usage stats, and surfaces the tests/test_skills/router_fixtures/ corpus.

Usage

uv run python {baseDir}/scripts/explore.py \
  --log-dir ~/.opensquilla/logs \
  --query "Co-occurring chains for PDF workflows" \
  --window-days 30 \
  --include co_occurrences,meta_usage,router_fixtures \
  --top-k 10

Output

JSON to stdout with keys co_occurrences, meta_usage, router_fixtures, and a placeholder string when the log is empty.

Fallback

If no decision-log exists, return an empty result with a placeholder string explaining "no history; downstream should rely on user intent only".

版本历史

f662be3 当前 2026-07-31 11:48
7f72a32 2026-07-05 18:38

元信息

文件数: 0
版本: 186b3c1
Hash: ade34800
收录时间: 2026-07-05 18:38

history-explorer