初始化提交

backend/app/schemas/skills.py

@@ -0,0 +1,49 @@
+"""Skill API schema（skills-design §4.1）。"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+from app.schemas.common import OrmModel
+
+
+class SkillResponse(OrmModel):
+    id: str
+    name: str
+    description: str
+    trigger: str
+    prompt_fragment: str
+    tool_bindings: list[str] = Field(default_factory=list)
+    risk_level: str
+    status: str
+    created_at: datetime
+    updated_at: datetime
+
+
+class CreateSkillRequest(BaseModel):
+    name: str = Field(min_length=1)
+    description: str = ""
+    trigger: str = ""
+    prompt_fragment: str = ""
+    tool_bindings: list[str] = Field(default_factory=list)
+    risk_level: str = "L1"
+    status: str = "enabled"
+
+
+class UpdateSkillRequest(BaseModel):
+    description: str | None = None
+    trigger: str | None = None
+    prompt_fragment: str | None = None
+    tool_bindings: list[str] | None = None
+    risk_level: str | None = None
+    status: str | None = None
+
+
+class ToolCapability(BaseModel):
+    """统一能力列举项（builtin / mcp / skill 三源）。"""
+
+    name: str
+    description: str
+    source: str  # builtin / mcp / skill
+    risk_level: str
+    status: str