对齐文件规范

scripts/resolve_verify_playbook.py

@@ -0,0 +1,29 @@
+#!/usr/bin/env python3
+"""将 doc_id 解析为 verify playbook 绝对路径（唯一真源：ansible/playbooks/verify/<doc_id>.yml）。
+
+历史上曾解析 labs/matrix-doc-playbooks.yml（“验证矩阵”）；该概念已废弃。
+"""
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+
+
+def main() -> None:
+    if len(sys.argv) != 2:
+        print("用法: resolve_verify_playbook.py <doc_id>", file=sys.stderr)
+        sys.exit(2)
+    doc_id = sys.argv[1].strip()
+    if not doc_id:
+        sys.exit(2)
+    p = ROOT / "ansible" / "playbooks" / "verify" / f"{doc_id}.yml"
+    if not p.is_file():
+        print(f"ERR: playbook 不存在：{p}", file=sys.stderr)
+        sys.exit(2)
+    print(p.resolve())
+
+
+if __name__ == "__main__":
+    main()