af5fbfabec
- Context_Engineering.md: 에이전트 컨텍스트 엔지니어링 개념 정리 문서 추가 - Context_Engineering_Research.ipynb: 연구 노트북 업데이트 - deepagents_sourcecode/: docstring과 주석을 한국어로 번역
72 lines
2.8 KiB
Python
72 lines
2.8 KiB
Python
"""CLI 커맨드용 스킬 로더(파일시스템 기반)입니다.
|
|
|
|
This module provides filesystem-based skill loading for CLI operations (list, create, info).
|
|
It wraps the prebuilt middleware functionality from deepagents.middleware.skills and adapts
|
|
it for direct filesystem access needed by CLI commands.
|
|
|
|
For middleware usage within agents, use deepagents.middleware.skills.SkillsMiddleware directly.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from typing import TYPE_CHECKING
|
|
|
|
from deepagents.backends.filesystem import FilesystemBackend
|
|
from deepagents.middleware.skills import SkillMetadata
|
|
from deepagents.middleware.skills import _list_skills as list_skills_from_backend
|
|
|
|
if TYPE_CHECKING:
|
|
from pathlib import Path
|
|
|
|
|
|
class ExtendedSkillMetadata(SkillMetadata):
|
|
"""Extended skill metadata for CLI display, adds source tracking."""
|
|
|
|
source: str
|
|
|
|
|
|
# Re-export for CLI commands
|
|
__all__ = ["SkillMetadata", "list_skills"]
|
|
|
|
|
|
def list_skills(
|
|
*, user_skills_dir: Path | None = None, project_skills_dir: Path | None = None
|
|
) -> list[ExtendedSkillMetadata]:
|
|
"""List skills from user and/or project directories.
|
|
|
|
This is a CLI-specific wrapper around the prebuilt middleware's skill loading
|
|
functionality. It uses FilesystemBackend to load skills from local directories.
|
|
|
|
When both directories are provided, project skills with the same name as
|
|
user skills will override them (project skills take precedence).
|
|
|
|
Args:
|
|
user_skills_dir: Path to the user-level skills directory.
|
|
project_skills_dir: Path to the project-level skills directory.
|
|
|
|
Returns:
|
|
Merged list of skill metadata from both sources, with project skills
|
|
taking precedence over user skills when names conflict.
|
|
"""
|
|
all_skills: dict[str, ExtendedSkillMetadata] = {}
|
|
|
|
# Load user skills first (foundation)
|
|
if user_skills_dir and user_skills_dir.exists():
|
|
user_backend = FilesystemBackend(root_dir=str(user_skills_dir))
|
|
user_skills = list_skills_from_backend(backend=user_backend, source_path=".")
|
|
for skill in user_skills:
|
|
# Add source field for CLI display
|
|
extended_skill: ExtendedSkillMetadata = {**skill, "source": "user"}
|
|
all_skills[skill["name"]] = extended_skill
|
|
|
|
# Load project skills second (override/augment)
|
|
if project_skills_dir and project_skills_dir.exists():
|
|
project_backend = FilesystemBackend(root_dir=str(project_skills_dir))
|
|
project_skills = list_skills_from_backend(backend=project_backend, source_path=".")
|
|
for skill in project_skills:
|
|
# Add source field for CLI display
|
|
extended_skill: ExtendedSkillMetadata = {**skill, "source": "project"}
|
|
all_skills[skill["name"]] = extended_skill
|
|
|
|
return list(all_skills.values())
|