初始化提交

backend/app/api/v1/endpoints/skills.py

@@ -0,0 +1,54 @@
+"""Skill 能力包 API（/tools/skills，skills-design §6）。"""
+
+from fastapi import APIRouter, Query, status
+
+from app.schemas.skills import (
+    CreateSkillRequest,
+    SkillResponse,
+    UpdateSkillRequest,
+)
+from app.services import skills as skills_service
+
+router = APIRouter(prefix="/tools/skills", tags=["skills"])
+
+
+@router.post("", response_model=SkillResponse, status_code=status.HTTP_201_CREATED)
+async def create_skill(payload: CreateSkillRequest) -> SkillResponse:
+    """注册 Skill 能力包（name 唯一）。"""
+    return await skills_service.create_skill(
+        name=payload.name,
+        description=payload.description,
+        trigger=payload.trigger,
+        prompt_fragment=payload.prompt_fragment,
+        tool_bindings=payload.tool_bindings,
+        risk_level=payload.risk_level,
+        status=payload.status,
+    )
+
+
+@router.get("", response_model=list[SkillResponse])
+async def list_skills(
+    status: str | None = Query(default=None, description="按状态过滤：enabled/disabled"),
+) -> list[SkillResponse]:
+    """列举 Skill（可按 status 过滤）。"""
+    return await skills_service.list_skills(status=status)
+
+
+@router.patch("/{skill_id}", response_model=SkillResponse)
+async def update_skill(skill_id: str, payload: UpdateSkillRequest) -> SkillResponse:
+    """更新 / 启用 / 禁用 Skill。"""
+    return await skills_service.update_skill(
+        skill_id,
+        description=payload.description,
+        trigger=payload.trigger,
+        prompt_fragment=payload.prompt_fragment,
+        tool_bindings=payload.tool_bindings,
+        risk_level=payload.risk_level,
+        status=payload.status,
+    )
+
+
+@router.delete("/{skill_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_skill(skill_id: str) -> None:
+    """删除 Skill。"""
+    await skills_service.delete_skill(skill_id)