Skip to content

Dianel555/DSkills / skills/agent-wiki

agent-wiki

Unverified

Incremental LLM-friendly wiki generator for Obsidian note vaults. Use when: (1) Building wiki from notes, (2) Ingesting notes to wiki, (3) Obsidian LLM wiki, (4) Incremental knowledge base management. Triggers: 'build wiki from notes', 'ingest notes to wiki', 'Obsidian LLM wiki', 'incremental knowledge base'.

FileKindSize
.env.exampleother408 B
README.mdmarkdown15.3 KB
SKILL.mdskill md23.3 KB
pyproject.tomlmanifest2.1 KB
references/cli-matrix.mdmarkdown5.9 KB
references/homepage.mdmarkdown6.1 KB
references/index-schema.mdmarkdown6.9 KB
references/site-export.mdmarkdown3.1 KB
references/topic-authoring.mdmarkdown5.1 KB
scripts/agent_wiki/__init__.pyscript103 B
scripts/agent_wiki/authors.pyscript3.9 KB
scripts/agent_wiki/bases.pyscript4.0 KB
scripts/agent_wiki/batch.pyscript3.7 KB
scripts/agent_wiki/boundary.pyscript55.8 KB
scripts/agent_wiki/cache.pyscript5.5 KB
scripts/agent_wiki/canvas.pyscript8.0 KB
scripts/agent_wiki/cleanup.pyscript2.4 KB
scripts/agent_wiki/cli.pyscript97 B
scripts/agent_wiki/commands.pyscript28.3 KB
scripts/agent_wiki/config.pyscript4.2 KB
scripts/agent_wiki/coverage.pyscript2.1 KB
scripts/agent_wiki/frontmatter.pyscript1.6 KB
scripts/agent_wiki/home.pyscript7.9 KB
scripts/agent_wiki/keywords.pyscript2.0 KB
scripts/agent_wiki/links.pyscript14.7 KB
scripts/agent_wiki/plugins.pyscript2.1 KB
scripts/agent_wiki/quality.pyscript7.6 KB
scripts/agent_wiki/scanner.pyscript6.7 KB
scripts/agent_wiki/site.pyscript39.2 KB
scripts/agent_wiki/source_type.pyscript3.2 KB
scripts/agent_wiki/wiki_index.pyscript17.4 KB
scripts/agent_wiki/worklist.pyscript5.7 KB
scripts/agent_wiki_cli.pyscript5.5 KB
templates/home/academic.mdmarkdown2.9 KB
templates/home/dashboard.mdmarkdown2.7 KB
templates/home/magazine.mdmarkdown2.5 KB
templates/query/research.mdmarkdown787 B
tests/conftest.pyscript177 B
tests/fixtures/sample_vault/attachments/image.pngbinary26 B
tests/fixtures/sample_vault/课程/双缝实验.mdmarkdown47 B
tests/fixtures/sample_vault/课程/量子力学.mdmarkdown75 B
tests/test_alias_resolution.pyscript7.5 KB
tests/test_authors.pyscript2.2 KB
tests/test_backlinks.pyscript7.0 KB
tests/test_bases.pyscript4.7 KB
tests/test_batch.pyscript3.0 KB
tests/test_benchmark_index.pyscript2.1 KB
tests/test_boundary_platform.pyscript695 B
tests/test_cache.pyscript2.1 KB
tests/test_cache_strict.pyscript2.1 KB
tests/test_canvas.pyscript8.3 KB
tests/test_capture.pyscript5.5 KB
tests/test_cleanup.pyscript1.2 KB
tests/test_cleanup_init_strict.pyscript2.1 KB
tests/test_cli.pyscript6.2 KB
tests/test_config.pyscript2.0 KB
tests/test_coverage.pyscript7.2 KB
tests/test_e2e.pyscript2.5 KB
tests/test_evaluate_enhancements.pyscript14.7 KB
tests/test_featured_base.pyscript4.3 KB
tests/test_final_security_review.pyscript6.6 KB
tests/test_frontmatter.pyscript1.1 KB
tests/test_gen_home.pyscript4.9 KB
tests/test_gen_site_cli.pyscript3.9 KB
tests/test_home.pyscript7.7 KB
tests/test_immutability.pyscript1.4 KB
tests/test_immutability_capture.pyscript2.4 KB
tests/test_index_capture.pyscript4.5 KB
tests/test_index_cli.pyscript5.4 KB
tests/test_index_extension.pyscript17.0 KB
tests/test_index_source_count.pyscript3.0 KB
tests/test_package_structure.pyscript3.4 KB
tests/test_plugins.pyscript3.1 KB
tests/test_quality.pyscript21.3 KB
tests/test_quality_cli.pyscript5.5 KB
tests/test_quality_prose_weight.pyscript3.8 KB
tests/test_quality_script_fairness.pyscript4.7 KB
tests/test_quality_tier_refactor.pyscript4.0 KB
tests/test_scanner.pyscript2.6 KB
tests/test_scanner_fast_path.pyscript3.5 KB
tests/test_scanner_strict.pyscript2.1 KB
tests/test_secure_temporary_writes.pyscript978 B
tests/test_site.pyscript20.2 KB
tests/test_site_import_isolation.pyscript3.9 KB
tests/test_site_slug_refactor.pyscript3.6 KB
tests/test_source_type.pyscript3.5 KB
tests/test_status_metrics.pyscript4.1 KB
tests/test_status_quality.pyscript5.3 KB
tests/test_status_worklist.pyscript3.0 KB
tests/test_structure.pyscript501 B
tests/test_topic_category.pyscript4.2 KB
tests/test_topic_path_boundary.pyscript2.2 KB
tests/test_vault_boundary.pyscript24.3 KB
tests/test_wiki_index.pyscript13.3 KB
tests/test_worklist.pyscript12.3 KB
tests/test_worklist_cli.pyscript1.9 KB

scripts/agent_wiki/worklist.py

View on GitHub
"""Maintenance worklists: wanted (broken link targets) and stale (low-quality/outdated) topics."""

from __future__ import annotations

import contextlib
from pathlib import Path
from typing import Any

from . import boundary, cache, config, links, scanner, wiki_index
from .config import nfc as _nfc


def compute_worklist(vault: str | Path, data: dict[str, Any] | None = None) -> dict[str, Any]:
    """Compute wanted and stale worklists.

    ``data`` is a prebuilt ``wiki_index.rebuild`` result; ``None`` rebuilds here.

    Returns:
        {
            "wanted": [{"target": str, "inbound": int, "linked_from": [str]}],
            "stale": [{"path": str, "tier": str, "reason": str}]
        }

    Raises:
        ValueError: if wiki not initialized
    """
    boundary.bind(vault)
    vault = Path(vault)
    wiki_root = config.wiki_root(vault)

    if not wiki_root.exists():
        raise ValueError("wiki_not_initialized")

    # Rebuild index to get all pages and links
    if data is None:
        data, _ = wiki_index.rebuild(vault)

    # --- WANTED: missing dedicated page targets ---
    target_sources: dict[str, set[str]] = {}
    ambiguous_sources: dict[str, tuple[set[str], set[str]]] = {}
    topic_keys = set(data["topics"])
    query_keys = set(data["queries"])
    alias_index = data.get("alias_index", {})

    all_entries = list(data["topics"].items()) + list(data["queries"].items())
    for page_key, entry in all_entries:
        for ref in links.from_entry(entry):
            resolution = links.resolve(ref.target, topic_keys, query_keys, alias_index)
            if resolution.status == "missing":
                target_sources.setdefault(ref.target, set()).add(page_key)
            elif resolution.status == "ambiguous":
                candidates, sources = ambiguous_sources.setdefault(ref.target, (set(resolution.candidates), set()))
                candidates.update(resolution.candidates)
                sources.add(page_key)

    wanted: list[dict[str, Any]] = []
    for target, sources in target_sources.items():
        linked_from = sorted(sources, key=lambda x: _nfc(x))
        wanted.append({
            "target": target,
            "inbound": len(sources),
            "linked_from": linked_from,
        })
    wanted.sort(key=lambda x: (-x["inbound"], _nfc(x["target"])))

    unresolved = [
        {
            "target": target,
            "status": "ambiguous",
            "candidates": sorted(candidates, key=_nfc),
            "linked_from": sorted(sources, key=_nfc),
        }
        for target, (candidates, sources) in ambiguous_sources.items()
    ]
    unresolved.sort(key=lambda item: _nfc(str(item["target"])))

    # --- STALE: low-tier or index-stale topics ---

    stale = []

    # A source change is a knowledge-review signal, not an index/cache signal.
    changed_paths: set[str] = set()
    changed_derived_topics: set[str] = set()
    try:
        classified = scanner.classify(vault, cache.load(vault))
    except (OSError, ValueError):
        classified = {}
    for bucket in ("new", "modified", "deleted"):
        for item in classified.get(bucket, []):
            if isinstance(item, dict) and isinstance(item.get("path"), str):
                changed_paths.add(config.normalize_relpath(item["path"]))
                derived = item.get("derived_topics", [])
                if isinstance(derived, list):
                    changed_derived_topics.update(
                        config.normalize_relpath(str(topic)) for topic in derived
                    )

    def source_changed(page_key: str, entry: dict[str, Any]) -> bool:
        if entry.get("kind") == "topic" and page_key in changed_derived_topics:
            return True
        return any(
            isinstance(source, str)
            and not source.lower().startswith(("http://", "https://"))
            and config.normalize_relpath(source) in changed_paths
            for source in entry.get("sources", [])
        )

    review = [
        {"path": key, "kind": entry.get("kind", "topic"), "reason": "source_changed"}
        for key, entry in all_entries
        if source_changed(key, entry)
    ]
    review.sort(key=lambda item: _nfc(str(item["path"])))

    # Check if index file exists and get its mtime
    index_path = config.index_path(vault)
    index_mtime = None
    if index_path.exists():
        with contextlib.suppress(OSError):
            index_mtime = index_path.stat().st_mtime_ns

    for topic_key, entry in data["topics"].items():
        tier = entry.get("quality_tier", "stub")
        topic_path = config.topics_dir(vault) / topic_key

        is_low_tier = tier in ["stub", "basic"]
        is_index_stale = False
        is_source_changed = source_changed(topic_key, entry)

        # Check index staleness
        if topic_path.exists():
            try:
                topic_mtime = topic_path.stat().st_mtime_ns
                # Topic is index-stale if:
                # - index doesn't exist, OR
                # - topic is newer than index
                if index_mtime is None or topic_mtime > index_mtime:
                    is_index_stale = True
            except OSError:
                pass

        reasons = []
        if is_low_tier:
            reasons.append("low_tier")
        if is_source_changed:
            reasons.append("source_changed")
        if is_index_stale:
            reasons.append("index_stale")
        if reasons:
            primary = "low_tier" if is_low_tier else "source_changed" if is_source_changed else "index_stale"
            stale.append({
                "path": topic_key,
                "tier": tier,
                "reason": primary,
                "reasons": reasons,
            })

    return {
        "wanted": wanted,
        "unresolved": unresolved,
        "review": review,
        "stale": stale,
    }
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall