初始化提交

backend/app/modules/skills/__init__.py

@@ -0,0 +1,5 @@
+"""Skill 能力包领域纯逻辑（关键词触发匹配，禁止 IO）。"""
+
+from app.modules.skills.manifest import SkillManifest, parse_skill_manifest
+
+__all__ = ["SkillManifest", "parse_skill_manifest"]

backend/app/modules/skills/manifest.py

@@ -0,0 +1,40 @@
+"""Skill Manifest：将现有 Skill 记录转换为运行时无 IO 描述。"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Protocol
+
+
+class SkillLike(Protocol):
+    name: str
+    description: str
+    trigger: str
+    prompt_fragment: str
+    risk_level: str
+    status: str
+    tool_bindings_json: str
+
+
+@dataclass(frozen=True)
+class SkillManifest:
+    """一次运行需要的技能声明。"""
+
+    name: str
+    description: str
+    triggers: tuple[str, ...]
+    prompt: str
+    allowed_tools: tuple[str, ...]
+    risk_level: str
+
+
+def parse_skill_manifest(skill: SkillLike, tool_bindings: list[str]) -> SkillManifest:
+    """从既有 Skill ORM 构建 manifest，避免改变数据库结构。"""
+    return SkillManifest(
+        name=skill.name,
+        description=skill.description,
+        triggers=tuple(item.strip() for item in skill.trigger.split(",") if item.strip()),
+        prompt=skill.prompt_fragment,
+        allowed_tools=tuple(tool_bindings),
+        risk_level=skill.risk_level,
+    )

backend/app/modules/skills/matcher.py

@@ -0,0 +1,20 @@
+"""Skill 关键词触发匹配（纯函数，无 IO）。
+
+按 ``trigger`` 逗号分隔关键词，``context_text`` 包含任一关键词（大小写不敏感）则命中。
+仅 ``status=enabled`` 的 skill 参与；返回保持输入顺序。
+"""
+
+from collections.abc import Sequence
+
+
+def match_skills[T](context_text: str, skills: Sequence[T]) -> list[T]:
+    text = context_text.lower()
+    result: list[T] = []
+    for skill in skills:
+        if getattr(skill, "status", "enabled") != "enabled":
+            continue
+        trigger = getattr(skill, "trigger", "") or ""
+        keywords = [k.strip().lower() for k in trigger.split(",") if k.strip()]
+        if any(kw in text for kw in keywords):
+            result.append(skill)
+    return result