Add DATA_PATHS golden standard and resolve_data_path helpers.

Document skill-owned file layout under user data dir, extend runtime_paths with standard subdir helpers, add POLICY-DATA-PATH-001, and update CONFIG/RUNTIME cross-references.

Co-authored-by: Cursor <cursoragent@cursor.com>

tests/test_runtime_paths.py

@@ -82,6 +82,68 @@ class TestRuntimePaths(unittest.TestCase):
             self.assertTrue(os.path.normpath(data_dir).startswith(os.path.normpath(tmp)))
             self.assertIn("_test", data_dir.replace("\\", "/"))
 
+    def test_resolve_data_path_defaults_under_skill_data_dir(self) -> None:
+        with IsolatedDataRoot() as tmp:
+            import importlib
+
+            import util.runtime_paths as rp
+
+            importlib.reload(rp)
+            path = rp.resolve_data_path(None, "downloads", create=True)
+            norm = os.path.normcase(os.path.normpath(path))
+            norm_tmp = os.path.normcase(os.path.normpath(tmp))
+            self.assertTrue(norm.startswith(norm_tmp))
+            self.assertTrue(norm.endswith(os.path.normcase(os.path.join("downloads"))))
+
+    def test_resolve_data_path_relative_uses_data_dir_not_cwd(self) -> None:
+        with IsolatedDataRoot() as tmp:
+            import importlib
+
+            import util.runtime_paths as rp
+
+            importlib.reload(rp)
+            os.environ["SKILL_DOWNLOAD_DIR"] = "downloads/videos"
+            from jiangchang_skill_core import config
+
+            config.reset_cache()
+            importlib.reload(rp)
+            path = rp.resolve_data_path("SKILL_DOWNLOAD_DIR", "downloads", create=False)
+            norm = os.path.normcase(os.path.normpath(path))
+            self.assertIn(os.path.normcase("downloads"), norm)
+            self.assertIn(os.path.normcase("videos"), norm)
+            self.assertTrue(norm.startswith(os.path.normcase(os.path.normpath(tmp))))
+            os.environ.pop("SKILL_DOWNLOAD_DIR", None)
+            config.reset_cache()
+
+    def test_resolve_input_path_relative_under_imports(self) -> None:
+        with IsolatedDataRoot() as tmp:
+            import importlib
+
+            import util.runtime_paths as rp
+
+            importlib.reload(rp)
+            resolved = rp.resolve_input_path("urls.txt", create_parent=True)
+            norm = os.path.normcase(os.path.normpath(resolved))
+            self.assertIn(os.path.normcase("imports"), norm)
+            self.assertTrue(norm.startswith(os.path.normcase(os.path.normpath(tmp))))
+
+    def test_list_resolved_data_paths_keys(self) -> None:
+        with IsolatedDataRoot():
+            import importlib
+
+            import util.runtime_paths as rp
+
+            importlib.reload(rp)
+            paths = rp.list_resolved_data_paths()
+            for key in (
+                "skill_data_dir",
+                "downloads_dir",
+                "imports_dir",
+                "exports_dir",
+            ):
+                self.assertIn(key, paths)
+                self.assertTrue(paths[key])
+
 
 if __name__ == "__main__":
     unittest.main()