doc first implementation

src/personal_mcp/skills/fastapi_uv_docker/server.py

@@ -1,88 +1,14 @@
-from pathlib import Path
-
 from fastmcp import FastMCP
 
+from personal_mcp.skills.document_loader import load_skill_document
+
 fastapi_uv_docker_server = FastMCP("fastapi-uv-docker")
 
-_REFERENCE_DIR = (
-    Path(__file__).resolve().parents[4]
-    / "skills"
-    / "fastapi-uv-docker"
-    / "references"
-)
-_REFERENCE_FILES = {
-    "fastapi_best_practices": _REFERENCE_DIR / "fastapi-best-practices.md",
-    "uv_project_layout": _REFERENCE_DIR / "uv-project-layout.md",
-    "uvicorn_settings": _REFERENCE_DIR / "uvicorn-settings.md",
-    "docker_cloud_native": _REFERENCE_DIR / "docker-cloud-native.md",
-}
 
-
-def _load_reference_bundle() -> dict[str, str]:
-    bundle: dict[str, str] = {}
-    for key, path in _REFERENCE_FILES.items():
-        bundle[key] = path.read_text(encoding="utf-8")
-    return bundle
-
-
-@fastapi_uv_docker_server.resource("resource://skills/fastapi_uv_docker/overview")
-def fastapi_overview() -> dict:
-    """Return high-level intent for FastAPI plus uv plus Docker migration."""
-    return {
-        "id": "fastapi-uv-docker",
-        "intent": "Migrate projects toward cloud-native FastAPI architecture managed by uv.",
-        "focus": [
-            "src package layout",
-            "uv-based dependency and lock management",
-            "container-ready runtime conventions",
-        ],
-    }
-
-
-@fastapi_uv_docker_server.resource("resource://skills/fastapi_uv_docker/rules")
-def fastapi_rules() -> dict:
-    """Return migration rules for stable FastAPI service architecture."""
-    return {
-        "rules": [
-            "Prefer src layout and installable package boundaries.",
-            "Use app factory and lifespan hooks for startup/shutdown ownership.",
-            "Keep runtime configuration in environment-backed settings.",
-            "Use uv lockfile and avoid drift between local and container environments.",
-        ]
-    }
-
-
-@fastapi_uv_docker_server.resource("resource://skills/fastapi_uv_docker/checklist")
-def fastapi_checklist() -> dict:
-    """Return a compact migration checklist for FastAPI plus uv plus Docker."""
-    return {
-        "checklist": [
-            "Audit current project manager, layout, and runtime settings.",
-            "Establish uv project metadata and lockfile ownership.",
-            "Implement app factory, lifespan, and health endpoints.",
-            "Create multi-stage Docker image with non-root runtime user.",
-        ]
-    }
-
-
-@fastapi_uv_docker_server.resource("resource://skills/fastapi_uv_docker/references")
-def fastapi_references() -> dict:
-    """Return bundled references for detailed implementation guidance."""
-    return {
-        "sources": {key: str(path) for key, path in _REFERENCE_FILES.items()},
-        "format": "markdown",
-        "content": _load_reference_bundle(),
-    }
-
-
-@fastapi_uv_docker_server.tool()
-def fastapi_uv_docker_mvp_checklist(current_state: str = "bare python project") -> list[str]:
-    """Return a compact migration checklist for FastAPI + uv + Docker."""
-    return [
-        f"Current state: {current_state}",
-        "Create src/ package layout for the FastAPI app.",
-        "Manage dependencies with uv and keep uv.lock committed.",
-        "Use an app factory and lifespan hooks.",
-        "Add /healthz endpoint for operational checks.",
-        "Build with a multi-stage Dockerfile and run as non-root user.",
-    ]
+@fastapi_uv_docker_server.resource("resource://skills/fastapi-uv-docker/document")
+def skill_document() -> dict[str, str]:
+    """Return the canonical Markdown document for this skill."""
+    return load_skill_document(
+        skill_id="fastapi-uv-docker",
+        skill_slug="fastapi-uv-docker",
+    )