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_gen_home.py

View on GitHub
"""In-process tests for gen-home: atomic write, cards resolution, managed-block
merge, and ``--emit-only`` (content handed to the agent for an MCP-side write).

These monkeypatch ``commands.plugins`` / ``commands.emit``; the subprocess
``run_cli`` path in test_home.py cannot reach in-process patches.
"""

import json
import subprocess
import sys
import types
from pathlib import Path

import pytest
from agent_wiki import commands, config, home

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


def _args(vault, cards="auto", emit_only=False):
    return types.SimpleNamespace(vault=str(vault), cards=cards, emit_only=emit_only)


@pytest.fixture
def initialized(tmp_path):
    commands.cmd_init(_args(tmp_path))
    return tmp_path


@pytest.fixture
def capture_emit(monkeypatch):
    payloads = []
    monkeypatch.setattr(commands, "emit", lambda payload: payloads.append(payload))
    return payloads


def _idx(vault):
    return (config.wiki_root(vault) / "index.md").read_text(encoding="utf-8")


def test_atomic_write_by_default(initialized, capture_emit):
    commands.cmd_gen_home(_args(initialized))
    payload = capture_emit[-1]
    assert payload["write_via"] == "atomic"
    assert payload["path"] == "wiki/index.md"
    assert payload["cards"] is False  # no .obsidian under tmp_path
    text = _idx(initialized)
    assert text == home.render_skeleton(initialized, False)
    assert home.AUTO_START in text


# --- cards resolution -------------------------------------------------------

def test_cards_auto_follows_detection(initialized, capture_emit, monkeypatch):
    monkeypatch.setattr(commands.plugins, "cards_available", lambda vault: True)
    commands.cmd_gen_home(_args(initialized, cards="auto"))
    assert capture_emit[-1]["cards"] is True
    assert "```dataviewjs" in _idx(initialized)


def test_cards_off_overrides_positive_detection(initialized, capture_emit, monkeypatch):
    monkeypatch.setattr(commands.plugins, "cards_available", lambda vault: True)
    commands.cmd_gen_home(_args(initialized, cards="off"))
    assert capture_emit[-1]["cards"] is False
    assert "```dataviewjs" not in _idx(initialized)


def test_cards_on_overrides_negative_detection(initialized, capture_emit, monkeypatch):
    monkeypatch.setattr(commands.plugins, "cards_available", lambda vault: False)
    commands.cmd_gen_home(_args(initialized, cards="on"))
    assert capture_emit[-1]["cards"] is True
    assert "```dataviewjs" in _idx(initialized)


def test_merge_preserves_prose_in_process(initialized, capture_emit):
    custom = f"# Wiki Index\n\n手写散文。\n\n{home.AUTO_START}\n\nSTALE\n\n{home.AUTO_END}\n"
    (config.wiki_root(initialized) / "index.md").write_text(custom, encoding="utf-8")
    commands.cmd_gen_home(_args(initialized, cards="on"))
    text = _idx(initialized)
    assert "手写散文。" in text
    assert "STALE" not in text
    assert "```dataviewjs" in text


# --- emit-only ---------------------------------------------------------------

def test_emit_only_returns_content_without_writing(initialized, capture_emit):
    commands.cmd_gen_home(_args(initialized, emit_only=True))

    payload = capture_emit[-1]
    assert payload["write_via"] == "none"
    assert payload["content"] == home.render_skeleton(initialized, False)
    assert payload["obsidian_path"] == "wiki/index.md"
    # init placeholder is untouched: the agent owns the write
    index_file = config.wiki_root(initialized) / "index.md"
    assert index_file.read_text(encoding="utf-8") == "# Wiki Index\n\n"


def test_emit_only_content_matches_merge_for_existing_page(initialized, capture_emit):
    custom = f"# Wiki Index\n\n手写散文。\n\n{home.AUTO_START}\n\nSTALE\n\n{home.AUTO_END}\n"
    index_file = config.wiki_root(initialized) / "index.md"
    index_file.write_text(custom, encoding="utf-8")

    commands.cmd_gen_home(_args(initialized, cards="on", emit_only=True))

    content = capture_emit[-1]["content"]
    assert content == home.merge(custom, initialized, True)
    assert "手写散文。" in content
    assert "STALE" not in content
    # still no write
    assert index_file.read_text(encoding="utf-8") == custom


def test_emit_only_obsidian_path_carries_scope_prefix(tmp_path, capture_emit):
    (tmp_path / ".obsidian").mkdir()
    vault = tmp_path / "记录"
    vault.mkdir()
    commands.cmd_init(_args(vault))

    commands.cmd_gen_home(_args(vault, emit_only=True))

    assert capture_emit[-1]["obsidian_path"] == "记录/wiki/index.md"


def test_emit_only_payload_is_json_serializable(initialized):
    result = subprocess.run(
        [sys.executable, str(CLI), "gen-home", "--emit-only", "--vault", str(initialized)],
        text=True, encoding="utf-8", capture_output=True,
    )
    assert result.returncode == 0
    payload = json.loads(result.stdout)
    assert payload["ok"] is True
    assert payload["write_via"] == "none"
    assert payload["content"].endswith("\n")
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 CodeCodexUnverifiedInstall
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