84 lines
3.3 KiB
Python
84 lines
3.3 KiB
Python
"""规范索引维护 Skill 的确定性行为测试。"""
|
|
|
|
import json
|
|
from pathlib import Path
|
|
import subprocess
|
|
import sys
|
|
import tempfile
|
|
import unittest
|
|
|
|
|
|
ROOT = Path(__file__).resolve().parents[2]
|
|
SKILL = ROOT / "plugins" / "skill" / "skills" / "guidance-edit"
|
|
SCRIPT = SKILL / "scripts" / "check_index.py"
|
|
|
|
|
|
class GuidanceEditTest(unittest.TestCase):
|
|
"""验证索引检查器和读写职责边界。"""
|
|
|
|
def run_check(self, standards: Path) -> subprocess.CompletedProcess[str]:
|
|
"""以 JSON 模式执行检查器。"""
|
|
return subprocess.run(
|
|
[sys.executable, str(SCRIPT), str(standards), "--json"],
|
|
check=False,
|
|
capture_output=True,
|
|
text=True,
|
|
encoding="utf-8",
|
|
)
|
|
|
|
def test_clean_index_is_reachable(self) -> None:
|
|
"""根索引能够逐级访问所有规范时应检查通过。"""
|
|
with tempfile.TemporaryDirectory() as temp:
|
|
standards = Path(temp)
|
|
(standards / "frontend").mkdir()
|
|
(standards / "index.md").write_text(
|
|
"[前端](frontend/index.md)\n", encoding="utf-8"
|
|
)
|
|
(standards / "frontend" / "index.md").write_text(
|
|
"[组件](components.md)\n", encoding="utf-8"
|
|
)
|
|
(standards / "frontend" / "components.md").write_text(
|
|
"# 组件\n", encoding="utf-8"
|
|
)
|
|
result = self.run_check(standards)
|
|
self.assertEqual(0, result.returncode, result.stderr)
|
|
report = json.loads(result.stdout)
|
|
self.assertEqual([], report["unindexed"])
|
|
self.assertEqual([], report["broken"])
|
|
|
|
def test_reports_unindexed_broken_and_cycle(self) -> None:
|
|
"""未索引文件、失效链接和循环引用应同时报告。"""
|
|
with tempfile.TemporaryDirectory() as temp:
|
|
standards = Path(temp)
|
|
(standards / "index.md").write_text(
|
|
"[主题](topic.md)\n[缺失](missing.md)\n", encoding="utf-8"
|
|
)
|
|
(standards / "topic.md").write_text(
|
|
"[返回](index.md)\n", encoding="utf-8"
|
|
)
|
|
(standards / "orphan.md").write_text("# 未索引\n", encoding="utf-8")
|
|
result = self.run_check(standards)
|
|
self.assertEqual(1, result.returncode)
|
|
report = json.loads(result.stdout)
|
|
self.assertEqual(["orphan.md"], report["unindexed"])
|
|
self.assertEqual("missing.md", report["broken"][0]["target"])
|
|
self.assertTrue(report["cycles"])
|
|
|
|
def test_missing_entry_is_input_error(self) -> None:
|
|
"""入口不存在时应返回输入错误，而不是覆盖问题。"""
|
|
with tempfile.TemporaryDirectory() as temp:
|
|
result = self.run_check(Path(temp))
|
|
self.assertEqual(2, result.returncode)
|
|
self.assertIn("索引入口不存在", result.stderr)
|
|
|
|
def test_skill_separates_read_and_write_modes(self) -> None:
|
|
"""检查默认只读，所有写入均需预览与确认。"""
|
|
content = (SKILL / "SKILL.md").read_text(encoding="utf-8")
|
|
self.assertIn("检查默认只读", content)
|
|
self.assertIn("经用户确认后写入", content)
|
|
self.assertIn("不强制创建固定层级", content)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|