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

tests/test_capture.py

View on GitHub
import hashlib
import json
import subprocess
import sys
from pathlib import Path

from agent_wiki import config, frontmatter

ROOT = Path(__file__).resolve().parents[1]
CLI = ROOT / "scripts" / "agent_wiki_cli.py"


def run_cli(*args):
    return subprocess.run(
        [sys.executable, str(CLI), *args],
        text=True, encoding="utf-8", capture_output=True,
    )


def _page(directory: Path, name: str, meta: dict, body: str = "正文 [[别处]]\n") -> Path:
    directory.mkdir(parents=True, exist_ok=True)
    path = directory / name
    path.write_text(frontmatter.dump(meta, body), encoding="utf-8")
    return path


def _log_lines(vault: Path) -> list[str]:
    log = config.wiki_root(vault) / "log.md"
    return [ln for ln in log.read_text(encoding="utf-8").splitlines() if ln.strip()]


# --- init creates / backfills capture & graph dirs -------------------------

def test_init_creates_capture_and_graph_dirs(tmp_path):
    payload = json.loads(run_cli("init", "--vault", str(tmp_path)).stdout)
    for sub in ("queries", "graphs"):
        assert (config.wiki_root(tmp_path) / sub).is_dir()
        assert f"wiki/{sub}" in payload["created"]


def test_init_backfills_missing_capture_dirs(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    import shutil
    shutil.rmtree(config.queries_dir(tmp_path))
    shutil.rmtree(config.graphs_dir(tmp_path))
    payload = json.loads(run_cli("init", "--vault", str(tmp_path)).stdout)
    assert payload["status"] == "already_initialized"
    assert set(payload["created"]) == {"wiki/queries", "wiki/graphs"}
    assert config.queries_dir(tmp_path).is_dir()
    assert config.graphs_dir(tmp_path).is_dir()


# --- save-report placement + kind ------------------------------------------

def test_save_report_registers_and_sets_kind(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    _page(config.queries_dir(tmp_path), "报告.md", {"title": "报告", "sources": ["a.pdf"]})
    payload = json.loads(run_cli("save-report", "报告", "--vault", str(tmp_path)).stdout)
    assert payload == {"ok": True, "path": "queries/报告.md", "kind": "query"}
    meta, _ = frontmatter.parse((config.queries_dir(tmp_path) / "报告.md").read_text(encoding="utf-8"))
    assert meta["kind"] == "query"
    log = _log_lines(tmp_path)
    assert log[-1].endswith("capture | save_report | queries/报告.md")


def test_save_report_appends_md_suffix_and_sanitizes_name(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    _page(config.queries_dir(tmp_path), "plain.md", {"title": "p", "sources": []})
    # malicious traversal + missing suffix both collapse to plain.md
    payload = json.loads(run_cli("save-report", "../../plain", "--vault", str(tmp_path)).stdout)
    assert payload["path"] == "queries/plain.md"


# --- byte-unchanged when kind already correct ------------------------------

def test_capture_leaves_correct_kind_byte_unchanged(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    page = _page(config.queries_dir(tmp_path), "已标注.md", {"title": "t", "sources": [], "kind": "query"})
    before = page.read_bytes()
    payload = json.loads(run_cli("save-report", "已标注", "--vault", str(tmp_path)).stdout)
    assert payload["ok"] is True
    assert page.read_bytes() == before  # not rewritten
    assert len([ln for ln in _log_lines(tmp_path) if "capture" in ln]) == 1  # exactly one log entry


def test_capture_logs_exactly_one_entry_per_call(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    _page(config.queries_dir(tmp_path), "s.md", {"title": "s", "sources": []})
    run_cli("save-report", "s", "--vault", str(tmp_path))
    run_cli("save-report", "s", "--vault", str(tmp_path))
    capture_lines = [ln for ln in _log_lines(tmp_path) if "capture |" in ln]
    assert len(capture_lines) == 2


# --- guards ----------------------------------------------------------------

def test_capture_requires_initialized_wiki(tmp_path):
    result = run_cli("save-report", "x", "--vault", str(tmp_path))
    assert result.returncode == 1
    assert json.loads(result.stderr) == {"error": "wiki_not_initialized", "hint": "run init first"}


def test_capture_missing_page_errors(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    result = run_cli("save-report", "ghost", "--vault", str(tmp_path))
    assert result.returncode == 1
    assert json.loads(result.stderr) == {"error": "capture_not_found", "path": "queries/ghost.md"}


def test_capture_bad_frontmatter_no_side_effects(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    bad = config.queries_dir(tmp_path) / "bad.md"
    bad.write_text("---\nkey: [\n---\nbody", encoding="utf-8")
    before = bad.read_bytes()
    log_before = _log_lines(tmp_path)
    result = run_cli("save-report", "bad", "--vault", str(tmp_path))
    assert result.returncode == 1
    assert "error" in json.loads(result.stderr)
    assert bad.read_bytes() == before  # not rewritten
    assert _log_lines(tmp_path) == log_before  # no log entry


# --- source-note immutability ----------------------------------------------

def test_capture_never_modifies_sources(tmp_path):
    run_cli("init", "--vault", str(tmp_path))
    note = tmp_path / "笔记" / "source.md"
    note.parent.mkdir(parents=True)
    note.write_text("# Source\n[[link]]\n", encoding="utf-8")
    fp = (hashlib.sha256(note.read_bytes()).digest(), note.stat().st_mtime_ns)
    _page(config.queries_dir(tmp_path), "s.md", {"title": "s", "sources": ["笔记/source.md"]})
    run_cli("save-report", "s", "--vault", str(tmp_path))
    assert (hashlib.sha256(note.read_bytes()).digest(), note.stat().st_mtime_ns) == fp
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: 472kUpdated 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