Dianel555/DSkills / skills/agent-wiki
agent-wiki
UnverifiedIncremental 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'.
tests/test_bases.py
View on GitHubimport json
import subprocess
import sys
from pathlib import Path
import yaml
from agent_wiki import bases
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 test_obsidian_prefix_detects_vault_root(tmp_path):
(tmp_path / ".obsidian").mkdir()
sub = tmp_path / "文献阅读记录"
sub.mkdir()
assert bases.obsidian_prefix(sub) == "文献阅读记录"
assert bases.obsidian_prefix(tmp_path) == ""
def test_obsidian_prefix_absent_returns_empty(tmp_path):
notes = tmp_path / "notes"
notes.mkdir()
assert bases.obsidian_prefix(notes) == ""
def test_index_base_is_valid_yaml_and_scoped():
data = yaml.safe_load(bases.build_index_base("文献阅读记录"))
assert data["filters"]["and"][0] == 'file.inFolder("文献阅读记录/wiki/topics")'
assert data["formulas"]["source_count"]
names = [v["name"] for v in data["views"]]
assert names == ["主题总览", "精选", "按作者", "按主题", "按机构", "按方法", "按来源类型", "按年份", "卡片视图"]
def test_index_base_per_dimension_views_surface_frontmatter_columns():
data = yaml.safe_load(bases.build_index_base(""))
for key in ("authors", "institutions", "methods", "source_type"):
assert key in data["properties"]
views = {v["name"]: v for v in data["views"]}
assert views["按作者"]["order"][0] == "authors"
assert views["按机构"]["order"][0] == "institutions"
assert views["按方法"]["order"][0] == "methods"
assert views["按来源类型"]["order"][0] == "source_type"
assert views["按年份"]["order"][:2] == ["year_start", "year_end"]
for key in ("year_start", "year_end"):
assert key in data["properties"]
# Only the existing source_count formula — no complex plugin-version-sensitive formulas.
assert set(data["formulas"]) == {"source_count"}
def test_master_base_excludes_wiki_and_keeps_tags():
data = yaml.safe_load(bases.build_master_base("文献阅读记录"))
and_clause = data["filters"]["and"]
assert 'file.inFolder("文献阅读记录")' in and_clause
assert {"not": ['file.inFolder("文献阅读记录/wiki")']} in and_clause
assert data["properties"]["tags"]["displayName"] == "标签"
assert data["formulas"]["year"]
def test_master_base_root_vault_omits_include():
data = yaml.safe_load(bases.build_master_base(""))
and_clause = data["filters"]["and"]
assert and_clause[0] == 'file.ext == "md"'
assert {"not": ['file.inFolder("wiki")']} in and_clause
def test_gen_base_cli_writes_both_files(tmp_path):
assert run_cli("init", "--vault", str(tmp_path)).returncode == 0
result = run_cli("gen-base", "--name", "Notions", "--vault", str(tmp_path))
assert result.returncode == 0, result.stderr
payload = json.loads(result.stdout)
assert payload["ok"] is True
assert set(payload["written"]) == {"wiki/index.base", "Notions.base"}
yaml.safe_load((tmp_path / "wiki" / "index.base").read_text(encoding="utf-8"))
yaml.safe_load((tmp_path / "Notions.base").read_text(encoding="utf-8"))
def test_gen_base_default_name_and_path_traversal_guard(tmp_path):
run_cli("init", "--vault", str(tmp_path))
payload = json.loads(run_cli("gen-base", "--name", "../evil", "--vault", str(tmp_path)).stdout)
assert "evil.base" in payload["written"]
assert (tmp_path / "evil.base").exists()
assert not (tmp_path.parent / "evil.base").exists()
def test_gen_base_requires_init(tmp_path):
result = run_cli("gen-base", "--vault", str(tmp_path))
assert result.returncode == 1
assert json.loads(result.stderr)["error"] == "wiki_not_initialized"
def test_child_scopes_keep_independent_wikis_inside_one_obsidian_root(tmp_path):
"""The configured source scope need not equal the registered Obsidian root."""
(tmp_path / ".obsidian").mkdir()
scopes = [tmp_path / "research-notes", tmp_path / "course-notes"]
for scope in scopes:
scope.mkdir()
assert run_cli("init", "--vault", str(scope)).returncode == 0
result = run_cli("gen-base", "--name", "sources", "--vault", str(scope))
assert result.returncode == 0, result.stderr
payload = json.loads(result.stdout)
assert payload["prefix"] == scope.name
assert (scope / "wiki" / "index.base").exists()
assert (scope / "sources.base").exists()
assert not (tmp_path / "wiki").exists()
index_base = yaml.safe_load((scope / "wiki" / "index.base").read_text(encoding="utf-8"))
assert index_base["filters"]["and"][0] == f'file.inFolder("{scope.name}/wiki/topics")'
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |