coroboros/skillward

skillward은(는) 무엇을 하나요?

신뢰할 수 없는 에이전트 스킬을 검증합니다 — 하나의 폴더, 여러 스킬 디렉토리, 또는 원격 https Git URL을 대상으로 완전한 결정론적 스캐너 앙상블을 오프라인에서 실행하고 결과를 하나의 평결로 통합합니다. CLI는 탐지를 수행하며, 이 스킬은 지능적인 한 단계를 추가합니다: 보고서를 읽고 그 의미를 설명합니다.

설치

CLI가 엔진입니다. 한 번 설치하세요:

cargo binstall skillward     # 미리 빌드된 바이너리
brew install coroboros/tap/skillward
npx @coroboros/skillward     # Node 툴체인

그런 다음 스캐너 번들을 가져옵니다(일회성 작업, Docker 필요):

skillward install

skillward가 PATH에 없으면 중단하고 사용자에게 위 명령어 중 하나로 설치하라고 알리세요 — 즉석에서 스캔을 시도하지 마십시오. 수동 검사는 앙상블이 잡아내는 것을 놓치므로, 거짓 안전 신호를 보고할 수 있습니다.

사용법

전체 명세는 skillward --help를 실행하세요. 분류를 위한 JSON 보고서를 포함한 기본 스캔:

skillward <target> --format json -o report.json

<target>은 스킬 폴더, 여러 스킬 디렉토리, 또는 https:// Git 저장소 URL입니다. 종료 코드 20은 발견 항목이 --fail-on 임계값(기본값 high)에 도달했음을 의미합니다. 0은 깨끗하거나 임계값 미만을 의미합니다.

분석

스캔 후 report.json을 읽고 분류 결과를 생성합니다 — 발견 항목을 다시 인쇄하는 것이 아닙니다:

1. 평결을 먼저 제시하세요. PASS 또는 FAIL, 가장 심각한 수준, 그리고 발견 항목이 입증되었는지 여부(여러 도구가 일치하면 높은 신뢰도).
2. 상위 발견 항목의 실제 위험을 일반 언어로 설명하세요 — 공격자가 얻을 수 있는 이점, 특정 파일과 규칙을 인용하여(예: "호출할 때마다 AWS 자격증명을 유출 — setup.sh:7, skillspector 및 semgrep에 의해 플래그됨").
3. tool_errors를 언급하세요 — 실행되지 않은 스캐너는 불완전한 그림을 의미합니다. 모든 것이 깨끗하다고 암시하지 말고 그 사실을 알리세요.
4. 결정을 내리세요: 설치, 설치하지 않음, 또는 수정 후 재설치. 수정의 경우 정확한 변경 사항을 명시하세요.

짧고 결정 지향적으로 유지하세요. 발견 항목은 보고서에 있습니다. 판단이 작업입니다.