python

Plugin python from marketplace team-harness in siontext/Harness-Marketplace. Commands read from the repo's manifest — 25 days ago.

Skills (9)

• agent-architecture

  Python AI 에이전트 아키텍처 규칙 — 의존 방향(main → agent → tools → platform), 연결 창구(Protocol) 구조와 로컬/운영 구현 선택(PLATFORM), LLM과 코드의 역할 나누기, 가드레일 위치, 객체지향·DDD를 Python으로 지키는 법. 에이전트 코드를 구현하거나 리뷰할 때 참조.

• eval

  실제 LLM으로 평가 질문(evals/questions.jsonl)을 돌린다 — 연결 확인(LLM·도구 호출 지원 여부) → 비용 확인 → 로컬 서버의 /chat으로 질문 실행 → 결과 저장. 채점 방식은 정하지 않고 사용자와 함께 정한다. API 비용이 들어서 사용자가 /python:eval을 직접 칠 때만 실행한다.

• export

  반출용 압축 파일을 만든다 — 테스트·커버리지 80%·Ruff·Pyrefly·키 섞임 검사를 모두 통과해야 압축하고, .git·.env·.venv·캐시·커버리지·평가 결과는 뺀다. 사용자가 /python:export를 직접 칠 때만 실행한다.

• fastapi-conventions

  에이전트를 앱·다른 서버가 부를 수 있게 여는 FastAPI 창구 규칙 — main.py 시작·종료 조립(lifespan), /chat·/health, pydantic 요청·응답, SSE 스트리밍(기본)과 한 번에 응답(대안), 스트리밍 중 출력 가드레일, 오류 응답 통일, 시간 제한. main.py나 API 코드를 작성하거나 리뷰할 때 참조.

• langgraph-conventions

  LangChain 1.x / LangGraph 1.x로 에이전트를 만드는 규칙 — create_agent와 StateGraph 고르기(LLM 도구 호출 미지원 시 포함), @tool 도구 작성, 구조화 출력, 가드레일·대화 기억 연결, 스트리밍, MCP 도구, 사람 확인(HITL), 쓰지 않는 예전 API. 에이전트 흐름·도구 코드를 작성하거나 리뷰할 때 참조.

• new

  정해진 뼈대로 새 Python AI 에이전트 프로젝트를 만든다 — 폴더·main.py·연결 창구·테스트 견본, uv로 Python 3.11.15 가상환경, 패키지 설치, 로컬 git 시작. 사용자가 /python:new를 직접 칠 때만 실행한다.

• python-project

  Python AI 에이전트 프로젝트 구성 — 고정 폴더 구성, pyproject.toml(실행·개발 패키지 분리, Ruff·Pyrefly·pytest 설정), uv로 Python 3.11 가상환경과 버전 고정 설치, .env 관리, 반출 제외 목록, 로컬 전용 git. 프로젝트를 만들거나 설정·의존성·폴더를 바꿀 때 참조.

• python-style

  Python 코드 스타일 가이드 — 이름 규칙(생성 함수 이름 포함), import, 함수, 타입 표시, 데이터 모델(pydantic·TypedDict·frozen dataclass), 예외, 비동기, 로그, 한국어 Google 독스트링(도구 함수는 LLM용 설명). Python 코드를 작성하거나 리뷰할 때 참조.

• python-testing

  Python AI 에이전트 테스트 가이드 — pytest·anyio, 4층 전략(단위 / 가짜 LLM 흐름 / 연결 확인 / 평가), 가짜(목) 규칙, GenericFakeChatModel, Given-When-Then, 상태·행위검증, 필수 실패 경로, 엔드포인트·SSE 테스트, 커버리지 80%와 필수 테스트 목록, evals/ 질문 형식. 테스트를 작성하거나 리뷰할 때 참조.

Subagents (2)

• python-dev

  설계 문서를 기반으로 Python AI 에이전트(LangGraph·FastAPI) 코드와 테스트를 구현하는 개발자

• python-reviewer

  설계 문서를 기반으로 Python AI 에이전트 코드를 검증하고 불일치 시 직접 수정한 뒤, 통과하면 로컬에만 커밋하는 리뷰어

Hooks (1)

• PreToolUse

  python3 "${CLAUDE_PLUGIN_ROOT}/hooks/push-guard.py"