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/canvas.py

View on GitHub
"""Deterministic JSON Canvas 1.0 knowledge-graph generation.

Builds a per-topic subgraph from the retrieval index: the topic at visual
center, its ``sources[]`` on an inner ring, and 1-hop neighbour topics on an
outer ring. Layout is closed-form (no randomness, no iteration) with ring radii
that scale with member count so same-ring boxes never overlap. The canvas is a
derived, regenerable artifact written only under ``wiki/graphs/``; topic
frontmatter remains the single source of truth.

Verified against the official JSON Canvas 1.0 spec (obsidianmd/jsoncanvas):
nodes require ``id``/``type``/``x``/``y``/``width``/``height`` with positive-int
sizes and integer coords; ``text`` nodes add ``text``, ``file`` nodes add
``file``, ``link`` nodes add
``url``; edges require ``id``/``fromNode``/``toNode`` (``toEnd`` optional);
``color`` is a preset ``"1"``–``"6"`` or hex.
"""

from __future__ import annotations

import json
import math
from pathlib import Path, PurePosixPath
from typing import Any

from . import boundary, config, links

# Node box geometry (positive-int width/height, integer coords).
CENTER_WIDTH = 480
CENTER_HEIGHT = 260
RING_WIDTH = 420
RING_HEIGHT = 190
GAP = 120
_CENTER_DIAG = math.ceil(math.hypot(CENTER_WIDTH, CENTER_HEIGHT))
_RING_DIAG = math.ceil(math.hypot(RING_WIDTH, RING_HEIGHT))
R1_BASE = 520
R2_BASE = 1100

# Hex colors for light/dark theme compatibility.
TOPIC_COLOR = "#2563EB"
SOURCE_COLOR = "#D97706"
NEIGHBOR_COLOR = "#0D9488"


class CanvasWriteError(OSError):
    pass


def _join(*parts: str) -> str:
    return "/".join(part for part in parts if part)


def _stem(name: str) -> str:
    base = PurePosixPath(name).name
    return base[:-3] if base.lower().endswith(".md") else base


def _is_url(value: str) -> bool:
    return value.lower().startswith(("http://", "https://"))


def _text_node(node_id: str, x: int, y: int, width: int, height: int, text: str, color: str) -> dict[str, Any]:
    return {"id": node_id, "type": "text", "x": x, "y": y,
            "width": width, "height": height, "text": text, "color": color}


def _link_node(node_id: str, x: int, y: int, url: str, color: str) -> dict[str, Any]:
    return {"id": node_id, "type": "link", "x": x, "y": y,
            "width": RING_WIDTH, "height": RING_HEIGHT, "url": url, "color": color}


def _edge(edge_id: str, from_node: str, to_node: str, color: str, label: str = "") -> dict[str, Any]:
    edge = {"id": edge_id, "fromNode": from_node, "toNode": to_node, "toEnd": "arrow", "color": color}
    if label:
        edge["label"] = label
    return edge


def _wikilink_target(vault_path: str) -> str:
    """Strip .md extension from vault path for wikilink target."""
    return vault_path[:-3] if vault_path.lower().endswith(".md") else vault_path


def _center_card(title: str, summary: str, wikilink: str) -> str:
    """Markdown for center topic card: heading + link + optional summary."""
    parts = [f"# {title}", f"[[{wikilink}|阅读全文 →]]"]
    if summary:
        parts.append(summary)
    return "\n\n".join(parts)


def _neighbor_card(title: str, summary: str, wikilink: str) -> str:
    """Markdown for neighbor topic card: subheading + link + optional summary."""
    parts = [f"## {title}", f"[[{wikilink}|查看主题 →]]"]
    if summary:
        parts.append(summary)
    return "\n\n".join(parts)


def _source_card(stem: str, wikilink: str) -> str:
    """Markdown for file source card: bold stem + link."""
    return f"**{stem}**\n\n[[{wikilink}|打开来源 →]]"


def _ring_radius(n: int, base: int, diag: int) -> int:
    """Radius placing ``n`` boxes (with bounding diagonal ``diag``) on a ring so
    adjacent centers are >= ``diag + GAP`` apart. ``n<=1`` collapses to base."""
    if n <= 1:
        return base
    return max(base, math.ceil((diag + GAP) / (2 * math.sin(math.pi / n))))


def _position(radius: int, k: int, n: int, width: int, height: int) -> tuple[int, int]:
    """Top-left corner of member ``k`` of ``n`` on ``radius`` (box dims ``width``×``height``,
    centered on ring point at ``theta = 2*pi*k/n``); ``n<=1`` uses ``theta=0``."""
    theta = 0.0 if n <= 1 else 2 * math.pi * k / n
    x = round(radius * math.cos(theta) - width / 2)
    y = round(radius * math.sin(theta) - height / 2)
    return x, y


def neighbors(target_key: str, index_data: dict[str, Any]) -> set[str]:
    """Topic keys sharing sources or resolved links with ``target_key``."""
    topics = index_data.get("topics", {})
    queries = index_data.get("queries", {})
    target = topics[target_key]
    topic_keys = set(topics)
    query_keys = set(queries)
    alias_index = index_data.get("alias_index", {})
    target_sources = set(target.get("sources", []))
    linked_topics: set[str] = set()
    for ref in links.from_entry(target):
        resolution = links.resolve(ref.target, topic_keys, query_keys, alias_index)
        if resolution.status == "resolved" and resolution.key is not None and resolution.key in topic_keys:
            linked_topics.add(resolution.key)

    result: set[str] = linked_topics - {target_key}
    for key, entry in topics.items():
        if key == target_key:
            continue
        if target_sources & set(entry.get("sources", [])):
            result.add(key)
            continue
        for ref in links.from_entry(entry):
            resolution = links.resolve(ref.target, topic_keys, query_keys, alias_index)
            if resolution.status == "resolved" and resolution.key == target_key:
                result.add(key)
                break
    return result


def build_canvas(target_key: str, index_data: dict[str, Any], prefix: str = "") -> dict[str, Any]:
    """JSON Canvas dict for ``target_key`` from the rebuilt index. ``prefix`` is
    the obsidian-vault-relative folder of the agent-wiki vault (``bases.obsidian_prefix``)."""
    target = index_data["topics"][target_key]
    topic_id = f"topic:{target_key}"
    topic_path = _join(prefix, "wiki", "topics", target_key)
    topic_wikilink = _wikilink_target(topic_path)
    center_text = _center_card(target["title"], target["summary"], topic_wikilink)
    nodes: list[dict[str, Any]] = [
        _text_node(topic_id, round(-CENTER_WIDTH / 2), round(-CENTER_HEIGHT / 2),
                   CENTER_WIDTH, CENTER_HEIGHT, center_text, TOPIC_COLOR)
    ]
    edges: list[dict[str, Any]] = []

    sources = sorted(set(target["sources"]))
    r1 = _ring_radius(len(sources), R1_BASE, _RING_DIAG)
    for k, src in enumerate(sources):
        x, y = _position(r1, k, len(sources), RING_WIDTH, RING_HEIGHT)
        sid = f"source:{src}"
        if _is_url(src):
            nodes.append(_link_node(sid, x, y, src, SOURCE_COLOR))
        else:
            src_path = _join(prefix, src)
            src_wikilink = _wikilink_target(src_path)
            src_text = _source_card(_stem(src), src_wikilink)
            nodes.append(_text_node(sid, x, y, RING_WIDTH, RING_HEIGHT, src_text, SOURCE_COLOR))
        edges.append(_edge(f"edge:{topic_id}=>{sid}", topic_id, sid, SOURCE_COLOR, "来源"))

    nbrs = sorted(neighbors(target_key, index_data))
    r2 = max(_ring_radius(len(nbrs), R2_BASE, _RING_DIAG), r1 + _CENTER_DIAG + GAP)
    for k, nb in enumerate(nbrs):
        x, y = _position(r2, k, len(nbrs), RING_WIDTH, RING_HEIGHT)
        nid = f"neighbor:{nb}"
        nb_entry = index_data["topics"][nb]
        nb_path = _join(prefix, "wiki", "topics", nb)
        nb_wikilink = _wikilink_target(nb_path)
        nb_text = _neighbor_card(nb_entry["title"], nb_entry["summary"], nb_wikilink)
        nodes.append(_text_node(nid, x, y, RING_WIDTH, RING_HEIGHT, nb_text, NEIGHBOR_COLOR))
        edges.append(_edge(f"edge:{topic_id}=>{nid}", topic_id, nid, NEIGHBOR_COLOR, "相关"))

    return {"nodes": nodes, "edges": edges}


def serialize(canvas: dict[str, Any]) -> str:
    return json.dumps(canvas, ensure_ascii=False, indent=2, sort_keys=True) + "\n"


def write_canvas(path: Path, canvas: dict[str, Any]) -> None:
    try:
        boundary.ensure_directory(path.parent)
        config.atomic_write_text(path, serialize(canvas))
    except OSError as exc:
        raise CanvasWriteError(str(exc)) from exc
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