상담원 기술: Claude를 위한 모듈식 기술 생성
Le 에이전트 기술 이는 확장을 위한 가장 강력한 메커니즘 중 하나를 나타냅니다. 클로드 코드의 기술. 그것은 약 역량 모듈 그들이 추가하는 것 전문 지식과 사전 정의된 워크플로우를 에이전트에 제공하여 에이전트가 실행할 수 있도록 합니다. 단순한 코드 생성을 훨씬 뛰어넘는 복잡한 작업.
이 시리즈의 열세 번째 기사에서 우리는 기술의 아키텍처를 탐구할 것입니다. 커뮤니티의 실제 사례가 포함된 10가지 주요 카테고리를 살펴보고, 특정 작업 흐름에 맞는 맞춤형 기술을 제공합니다. 기술은 클로드 코드를 변화시킵니다 일반 비서에서 전문 전문가들로 구성된 팀 사용 가능 터미널에서.
무엇을 배울 것인가
- 상담원 기술의 아키텍처와 구조를 이해합니다.
- 사용 가능한 상위 10개 기술 카테고리 살펴보기
- 커뮤니티에서 기술 설치 및 구성
- 단계별로 맞춤형 기술을 만들어보세요
- 일상적인 개발 워크플로우에 기술을 통합하세요
- 효과적인 기술 설계를 위한 모범 사례 적용
- 여러 기술 간의 종속성과 충돌을 관리합니다.
- 팀을 위해 재사용 가능한 기술 라이브러리 구축
전체 시리즈 개요
| # | Articolo | 집중하다 |
|---|---|---|
| 1 | 기술 파트너로서의 클로드 | 설정 및 첫 번째 단계 |
| 2 | 프로젝트 컨텍스트 및 설정 | CLAUDE.md 및 구성 |
| 3 | 개념 및 요구사항 | MVP 및 사용자 페르소나 |
| 4 | 백엔드 및 프런트엔드 아키텍처 | 스프링 부트와 Angular |
| 5 | 코드의 구조 | 조직 및 협약 |
| 6 | 고급 엔지니어링 프롬프트 | 고급 기술 |
| 7 | 테스트 및 품질 | 전략 및 테스트 생성 |
| 8 | 전문 문서 | 읽어보기, API, ADR |
| 9 | 배포 및 DevOps | 도커, CI/CD, 모니터링 |
| 10 | 진화와 유지 | 리팩토링 및 확장성 |
| 11 | 실제 프로젝트 통합 | 클로드 코드 제작 중 |
| 12 | 클로드 코드 CLI | 명령 및 구성 |
| 13 | 상담원 기술(현재 위치) | 모듈식 기능 |
| 14 | 전문 하위 에이전트 | 특정 역할을 맡은 상담원 |
| 15 | 후크 및 자동화 | 이벤트 중심 워크플로 |
| 16 | 랄프 위검 방법 | 테스트 중심 개발 |
| 17 | BMAD 방법 | 체계적인 프로젝트 관리 |
| 18 | 다중 에이전트 오케스트레이션 | 에이전트 파이프라인 |
| 19 | 협업 작업 | 팀 및 페어 프로그래밍 AI |
| 20 | 보안 및 모범 사례 | 강화 및 규정 준수 |
| 21 | 모니터링 및 관찰 가능성 | 측정항목 및 디버깅 |
1. 상담원 기술 아키텍처
에이전트 스킬은 마크다운 파일 디렉토리에 위치
.claude/skills/ 프로젝트의. 각 파일은 특정 기술을 설명합니다.
대화의 맥락에서 필요할 때 Claude가 호출할 수 있는 것입니다.
다음 기사에서 살펴보게 될 하위 에이전트와 달리 스킬은
자율적 실체이지만 지식의 확장 능력을 풍부하게 해주는
주 대리인의.
디렉토리 구조
.claude/
skills/
document-generator.md # Skill per generazione documenti
api-tester.md # Skill per testing API
database-migration.md # Skill per migrazioni DB
code-review-checklist.md # Skill per code review
performance-analyzer.md # Skill per analisi performance
security-audit.md # Skill per audit di sicurezza
csv-data-analyzer.md # Skill per analisi dati CSV
deployment-validator.md # Skill per validazione deploy
agents/ # Subagenti (articolo 14)
commands/ # Custom slash commands
settings.json # Configurazione progetto
settings.local.json # Configurazione locale
스킬 분석
각 기술 파일은 Claude가 자동으로 해석하는 사전 정의된 구조를 따릅니다. 구조에는 스킬 이름, 기능 설명, 작동 지침 및 사용 제한.
# Nome della Skill
## Descrizione
Breve descrizione di cosa fa questa skill e quando viene attivata.
## capacità
- capacità 1: cosa sa fare
- capacità 2: cosa sa fare
- capacità N: cosa sa fare
## Istruzioni
Istruzioni dettagliate su come eseguire il task:
1. Passo 1
2. Passo 2
3. Passo N
## Vincoli
- Non fare X
- Preferire Y rispetto a Z
- Formato output atteso
## Esempi
### Esempio 1: [Titolo]
Input: ...
Output: ...
### Esempio 2: [Titolo]
Input: ...
Output: ...
클로드가 기술을 선택하는 방법
Claude는 사용자 프롬프트와 대화 맥락을 분석하여
어떤 기술이 적합한지 결정합니다. 선택이 자동으로 수행됩니다.
요청과 설명 간의 의미론적 대응을 기반으로 합니다.
사용 가능한 스킬 중 기술을 명시적으로 호출할 필요는 없습니다.
귀하의 전문 분야에 해당하는 요청을 하십시오.
특정 기술을 호출하려면 다음 명령을 사용할 수 있습니다.
/skill nome-skill.
스킬의 수명주기
수명주기 단계
| 단계 | 설명 | 액션 클로드 |
|---|---|---|
| 발견 | 클로드 스캔 .claude/skills/ 시작 시 |
사용 가능한 모든 기술의 메타데이터 로드 |
| 어울리는 | 사용자 프롬프트의 의미 분석 | 요청과 관련된 기술 식별 |
| 로드 중 | 선택한 스킬 로딩 완료 | 지침, 제약 조건 및 예시를 읽습니다. |
| 실행 | 스킬 지시 적용 | 지침에 따라 작업을 수행합니다. |
| 확인 | 제약 조건과 비교하여 결과 확인 | 출력이 정의된 기준을 충족하는지 확인 |
2. 10가지 스킬 카테고리
커뮤니티는 10가지 주요 범주로 구성된 수백 가지 기술을 개발했습니다. 각 카테고리는 특정 도메인을 다루며 즉시 사용할 수 있는 기술을 제공합니다. 귀하의 프로젝트에 즉시 채택될 수 있습니다.
카테고리 1: 문서 기술
문서 기술을 통해 Claude는 문서를 생성, 편집 및 변환할 수 있습니다. 전문적인 형식으로. 이 기술은 Claude를 발전기로 만듭니다. 배포 준비가 완료된 출력을 생성하는 구조화된 콘텐츠입니다.
문서 주요 스킬
| 기술 | 체재 | 용량 |
|---|---|---|
| docx 생성기 | 마이크로소프트 워드(.docx) | 스타일, 표, 이미지 및 자동 색인을 사용하여 Word 문서 생성 |
| PDF 작성자 | 사용자 정의 레이아웃, 머리글/바닥글 및 워터마크를 사용하여 전문적인 PDF를 만듭니다. | |
| pptx 빌더 | 파워포인트(.pptx) | 마스터 슬라이드, 그래프 및 애니메이션을 사용하여 프레젠테이션 생성 |
| xlsx 분석기 | 엑셀(.xlsx) | 수식, 피벗 테이블, 차트가 포함된 스프레드시트 만들기 |
| Revealjs-발표자 | HTML(Reveal.js) | 전환 및 라이브 코드를 사용하여 대화형 웹 프레젠테이션 생성 |
# Document Generator (DOCX)
## Descrizione
Genera documenti Microsoft Word professionali a partire da contenuti
strutturati. Supporta stili personalizzati, tabelle, immagini inline,
intestazioni/pie' di pagina e indice automatico.
## capacità
- Creare documenti .docx da zero con template professionale
- Applicare stili di formattazione coerenti
- Inserire tabelle con dati strutturati
- Generare indice automatico dai titoli
- Inserire header e footer con numerazione pagine
- Supportare contenuto multilingue
## Istruzioni
1. Analizzare la struttura del contenuto richiesto
2. Creare lo script Node.js usando la libreria `docx`
3. Definire gli stili del documento (heading, body, table)
4. Costruire la struttura del documento sezione per sezione
5. Eseguire lo script per generare il file .docx
6. Verificare che il file sia stato creato correttamente
## Dipendenze
- npm: docx (per generazione .docx)
- npm: @types/docx (per TypeScript)
## Vincoli
- Usare sempre stili coerenti nel documento
- Includere numerazione pagine nel footer
- Formato data: DD/MM/YYYY per documenti italiani
- Dimensione massima consigliata: 50 pagine
카테고리 2: 개발 및 코드 도구
개발 기술은 고급 패턴으로 클로드의 코딩 능력을 확장하고, 특정 프레임워크와 구조화된 작업 방법론. 이러한 기술은 제품 코드의 일관성과 품질을 유지하는 데 특히 유용합니다.
발달을 위한 핵심 기술
| 기술 | 기술 | 용량 |
|---|---|---|
| 웹 아티팩트 빌더 | HTML/CSS/JS | 인라인 HTML, CSS 및 JavaScript를 사용하여 독립형 웹 구성 요소 생성 |
| tdd-워크플로 | 다국어 | 테스트 기반 개발 추진: 먼저 테스트를 작성한 후 배포 |
| 자식 작업 나무 | 힘내 | 여러 브랜치에서 병렬 개발을 위해 Git 작업 트리를 관리합니다. |
| aws-cdk-빌더 | AWS CDK | 클라우드 인프라에 대한 모범 사례를 사용하여 CDK 스택 생성 |
| API 디자인 우선 | 오픈API | OpenAPI 사양을 시작으로 API 설계, 서버 및 클라이언트 생성 |
| 각도 구성 요소 생성 | 모난 | 신호, 테스트 및 스토리북을 사용하여 독립형 Angular 구성요소 생성 |
# TDD Workflow
## Descrizione
Guida lo sviluppo seguendo rigorosamente il ciclo Red-Green-Refactor
del Test-Driven Development. Ogni feature viene implementata partendo
dai test che descrivono il comportamento atteso.
## capacità
- Scrivere test che definiscono il comportamento desiderato (Red)
- Implementare il minimo codice per far passare i test (Green)
- Refactoring del codice mantenendo tutti i test verdi (Refactor)
- Gestire test unitari, di integrazione e e2e
- Applicare test doubles (mock, stub, spy) dove necessario
## Istruzioni
### Fase Red
1. Analizzare il requisito e scomporlo in comportamenti testabili
2. Scrivere un test che descrive il comportamento atteso
3. Eseguire il test e verificare che FALLISCA
4. Se il test passa gia: il test non testa nulla di nuovo
### Fase Green
5. Scrivere il MINIMO codice necessario per far passare il test
6. Non ottimizzare, non aggiungere feature extra
7. Eseguire tutti i test e verificare che PASSINO tutti
### Fase Refactor
8. Rifattorizzare il codice eliminando duplicazione
9. Migliorare naming e struttura
10. Eseguire tutti i test dopo ogni modifica
11. I test devono rimanere VERDI dopo il refactoring
## Vincoli
- MAI scrivere codice di produzione senza un test che lo richiede
- Un test alla volta, una feature alla volta
- I test devono essere indipendenti tra loro
- Naming dei test: should_[comportamento]_when_[condizione]
카테고리 3: 데이터 및 분석
데이터 분석 기술은 Claude를 탐색 가능한 데이터 분석가로 변화시킵니다. 데이터 세트, 복잡한 쿼리 생성, 시각화 생성 및 식별 데이터의 이상.
데이터 및 분석을 위한 핵심 기술
| 기술 | 도메인 | 용량 |
|---|---|---|
| 근본 원인 추적 | 디버깅 | 인과관계 다이어그램을 통해 복잡한 버그의 체계적인 근본 원인 분석 |
| CSV 데이터 요약기 | CSV 데이터세트 | 탐색적 분석, 기술통계, 상관관계 및 이상치 |
| postgresql-쿼리-빌더 | 포스트그레SQL | 인덱스, CTE, 창 기능 및 계획 설명을 사용하여 최적화된 쿼리 생성 |
| 로그 분석기 | 애플리케이션 로그 | 패턴 인식 및 이벤트 타임라인을 통한 로그 구문 분석 및 분석 |
| 측정항목 대시보드 | 모니터링 | 비즈니스 요구 사항에서 Grafana/Prometheus 구성 생성 |
# CSV Data Summarizer
## Descrizione
Analizza file CSV per produrre report statistici completi con
visualizzazioni, correlazioni e identificazione di anomalie.
## capacità
- Caricare e parsare file CSV di qualsiasi dimensione
- Calcolare statistiche descrittive (media, mediana, moda, deviazione standard)
- Identificare valori mancanti, duplicati e outlier
- Generare correlazioni tra variabili numeriche
- Produrre visualizzazioni con grafici ASCII o script Python/matplotlib
- Creare report strutturati in formato Markdown
## Istruzioni
1. Leggere il file CSV e identificare le colonne
2. Classificare le colonne: numeriche, categoriche, date, testo
3. Per ogni colonna numerica:
- Calcolare min, max, media, mediana, std dev
- Identificare outlier (IQR method)
- Verificare distribuzione
4. Per ogni colonna categorica:
- Contare valori unici e frequenze
- Identificare valori dominanti
5. Calcolare matrice di correlazione per colonne numeriche
6. Identificare pattern temporali (se presenti date)
7. Generare report con tutte le scoperte
## Formato Output
```markdown
# Report Analisi: [nome_file]
## Panoramica Dataset
- Righe: N, Colonne: M
- Valori mancanti: X%
## Statistiche per Colonna
[tabella per ogni colonna]
## Correlazioni Significative
[matrice e insights]
## Anomalie Rilevate
[lista anomalie con spiegazione]
```
카테고리 4: 과학 및 연구
과학적 기술은 생물정보학, 재료 시뮬레이션 및 연구 데이터 분석. 그들은 다음을 위해 설계되었습니다. 과학적 데이터를 다루는 연구원 및 기술팀.
과학 분야의 기술
| 기술 | 도메인 | 용량 |
|---|---|---|
| 생물정보학 파이프라인 | 생물정보학 | DNA/RNA 서열 분석, 정렬, 유전자 주석 |
| ml-실험 추적기 | 기계 학습 | 측정항목, 하이퍼파라미터, 비교를 통해 ML 실험 추적 |
| 재료 시뮬레이션 | 재료과학 | 계산 모델을 사용한 재료 특성 시뮬레이션 |
| 통계분석 | 통계 | 통계 테스트, 회귀, 분산 분석 및 신뢰 구간 |
카테고리 5: 글쓰기 및 연구
글쓰기 및 연구 기술은 기술 콘텐츠 제작에 도움이 됩니다. 웹 소스에서 정보 추출부터 글쓰기까지 고품질 인용 및 참고문헌이 포함된 전체 기사.
작문 및 연구 기술
| 기술 | 기능 | 용량 |
|---|---|---|
| 기사 추출기 | 컨텐츠 추출 | 웹 URL, PDF 및 문서에서 콘텐츠 추출 및 구조화 |
| 콘텐츠 연구 작가 | 연구와 글쓰기 | 주제에 대한 심층적인 연구와 독창적인 콘텐츠 제작 |
| 기술 블로그 작가 | 기술 블로그 | 코드, 다이어그램 및 명확한 설명이 포함된 기술 기사 작성 |
| 변경 로그 생성기 | 릴리스 노트 | 자동 분류를 통해 Git 커밋에서 변경 로그 생성 |
# Changelog Generator
## Descrizione
Genera changelog professionali a partire dalla storia dei commit Git.
Categorizza automaticamente le modifiche seguendo Conventional Commits.
## capacità
- Analizzare commit tra due tag/versioni
- Categorizzare: feat, fix, docs, refactor, perf, test, chore
- Generare formato Keep a Changelog
- Linkare commit e issue/PR correlati
- Rilevare breaking changes
- Supportare versionamento semantico (SemVer)
## Istruzioni
1. Identificare l'intervallo di commit (ultimo tag -> HEAD)
2. Parsare ogni messaggio di commit per tipo e scope
3. Raggruppare per categoria
4. Ordinare per importanza (breaking > feat > fix > others)
5. Generare il documento CHANGELOG.md
6. Suggerire la nuova versione SemVer
## Formato Output
```markdown
# Changelog
## [1.2.0] - 2026-02-14
### Breaking Changes
- **auth:** Rimossa compatibilità con token v1
### Features
- **user:** Aggiunto form di modifica profilo (#123)
- **notif:** Sistema notifiche push (#145)
### Bug Fixes
- **cart:** Corretto calcolo totale con sconti (#167)
### Performance
- **api:** Cache su endpoint /products (-40% latenza)
```
카테고리 6: 학습 및 지식
학습 기술을 통해 Claude를 지식 관리 시스템으로 전환 정보를 구조화된 방식으로 구성하고, 연결하고, 제시할 수 있으며, 증분.
학습 및 지식을 위한 기술
| 기술 | 기능 | 용량 |
|---|---|---|
| 태피스트리 | 지식 그래프 | 양방향 링크와 탐색을 통해 상호 연결된 문서 네트워크 생성 |
| 선박 학습 다음 | 반복 학습 | 출시-학습-개선 주기: 릴리스, 피드백 분석, 개선 |
| 컨셉 매퍼 | 컨셉 맵 | 텍스트 및 기술 문서에서 개념 맵 생성 |
| 학습 경로 구축자 | 교육 과정 | 리소스와 마일스톤으로 맞춤형 학습 경로 만들기 |
카테고리 7: 미디어 및 콘텐츠
멀티미디어 기술을 통해 Claude는 비디오 및 오디오 콘텐츠 작업을 할 수 있습니다. 디지털 출판 형식을 통해 텍스트 이상의 기능을 확장합니다.
미디어 및 콘텐츠 기술
| 기술 | 체재 | 용량 |
|---|---|---|
| YouTube 대본 | 유튜브 | YouTube 동영상에서 대본을 추출하고 요약 및 구조화된 메모를 생성합니다. |
| 비디오 다운로더 | 동영상 | 품질 선택을 통해 지원되는 플랫폼에서 비디오를 다운로드하세요 |
| epub 변환기 | EPUB | Markdown 또는 HTML 콘텐츠를 e-reader용 EPUB 형식으로 변환 |
| 팟캐스트 노트 | 오디오 | 타임스탬프가 표시된 팟캐스트 녹취록에서 구조화된 노트 생성 |
| 다이어그램 생성기 | 인어/식물UML | 자연어 설명에서 기술 다이어그램 생성 |
# Diagram Generator
## Descrizione
Genera diagrammi tecnici in formato Mermaid o PlantUML
a partire da descrizioni in linguaggio naturale o analisi del codice.
## capacità
- Diagrammi di sequenza da flussi di codice
- Diagrammi di classe da modelli di dominio
- Diagrammi ER da schema database
- Diagrammi di stato da macchine a stati
- Diagrammi di flusso da logica di business
- Diagrammi di architettura C4
## Istruzioni
1. Analizzare la richiesta o il codice sorgente
2. Identificare il tipo di diagramma più appropriato
3. Estrarre entità, relazioni e flussi
4. Generare il codice Mermaid/PlantUML
5. Salvare in un file .md o .puml
6. Se possibile, generare un preview ASCII
## Formato Mermaid
```mermaid
sequenceDiagram
participant U as User
participant A as API
participant DB as Database
U->>A: POST /login
A->>DB: SELECT user
DB-->>A: User data
A-->>U: JWT Token
```
## Vincoli
- Preferire Mermaid per semplicità
- Usare PlantUML per diagrammi complessi
- Includere sempre legenda se il diagramma ha più di 5 entità
- Massimo 20 entità per diagramma (dividere se necessario)
카테고리 8: 건강 및 생명과학
생명 과학 기술은 의료 전문가 및 연구자를 지원합니다. 의료 데이터 분석, 임상 보고서 읽기 및 연구 생물 의학. 이러한 기술은 항상 대체 기술이 아니라는 경고와 함께 작동합니다. 전문적인 의학적 의견.
생명 과학 기술
| 기술 | 도메인 | 용량 |
|---|---|---|
| 클로드-알리-헬스 | 의료 보고서 | 의료 보고서를 분석하고 비정상적인 값을 강조하며 후속 조치를 제안합니다. |
| 임상시험 분석기 | 임상시험 | 구조화된 합성을 이용한 임상시험의 프로토콜 및 결과 분석 |
| 제약 상호작용 검사기 | 약리학 | 공개 데이터베이스를 기반으로 약물 상호작용 확인 |
중요한 면책 조항
의료 기술은 지원 도구이며 그들은 교체하지 않습니다 어떤 식으로든 의료 전문가의 조언에 따라. 생성된 모든 분석 임상 결정을 내리기 전에 자격을 갖춘 직원의 확인을 받아야 합니다. 클로드코드는 인증받은 의료기기가 아닙니다.
카테고리 9: 협업 및 PM
협업 및 프로젝트 관리 기술은 Claude를 도구로 보완합니다. Linear, Jira 및 회의 분석 시스템과 같은 작업 관리 시스템. 이를 통해 작업, 스프린트 및 보고 관리를 자동화할 수 있습니다.
협업 및 PM을 위한 기술
| 기술 | 기구 | 용량 |
|---|---|---|
| 선형 적분 | 선의 | API를 통해 Linear에서 이슈, 주기, 프로젝트 생성 및 관리 |
| Jira 워크플로 | 지라 | Jira에서 작업 동기화, 상태 업데이트 및 스프린트 보고서 생성 |
| 회의 분석 | 회의록 | 회의록 분석, 실행 항목 추출, 책임 할당 |
| 스프린트 플래너 | 기민한 | 속도, 용량 및 백로그 우선순위를 기반으로 스프린트 계획 |
| 스탠드업 리포터 | 일일 스탠드업 | 지난 24시간 동안 완료된 커밋, PR 및 작업에 대한 스탠드업 보고서 생성 |
# Meeting Analytics
## Descrizione
Analizza note di riunione per estrarre decisioni, action item,
rischi e metriche di partecipazione. Genera report strutturati
e traccia il follow-up delle azioni nel tempo.
## capacità
- Parsare note di riunione in formato libero
- Estrarre decisioni prese e rationale
- Identificare action item con responsabile e deadline
- Rilevare rischi e impedimenti menzionati
- Calcolare metriche di partecipazione
- Generare email di follow-up con riassunto
- Tracciare azioni aperte tra riunioni successive
## Formato Output
```markdown
# Meeting Report - [Data]
## Partecipanti
[Lista con ruolo]
## Decisioni
1. [Decisione] - Motivazione: [perchè]
2. ...
## Action Items
| # | Azione | Responsabile | Deadline | Stato |
|---|--------|-------------|----------|-------|
| 1 | ... | @nome | GG/MM | Open |
## Rischi Identificati
- [Rischio] - Impatto: [alto/medio/basso]
## Prossima Riunione
- Data: [suggerita]
- Agenda: [punti proposti]
```
카테고리 10: 보안 및 웹 테스트
보안 기술은 Claude에게 침투 테스트 기술을 제공합니다. 취약성 평가 및 보안 감사. 이러한 기술은 인정된 표준을 따릅니다. OWASP와 같은 규정 준수 요구 사항을 준수하는 보고서를 생성합니다.
보안 및 테스트 기술
| 기술 | 기준 | 용량 |
|---|---|---|
| owasp-체크리스트 | OWASP 상위 10위 | 웹 애플리케이션의 OWASP 상위 10개 취약점에 대한 체계적 검증 |
| 퍼푸퍼저 | 웹 퍼징 | 엔드포인트 및 매개변수 검색을 위해 FFUF를 사용하여 퍼징 세션 구성 및 실행 |
| 보안 환경 관리자 | 비밀 관리 | 환경 변수, 비밀 순환 및 볼트 통합의 안전한 관리 |
| 종속성 감사자 | CVE 데이터베이스 | CVE 식별 및 수정 권장 사항을 포함한 포괄적인 종속성 감사 |
| API 보안 테스터 | OWASP API 보안 | REST API 및 GraphQL에 대한 특정 보안 테스트 |
# OWASP Security Checklist
## Descrizione
Verifica sistematica della sicurezza dell'applicazione web
contro le OWASP Top 10 vulnerabilità. Produce un report
di audit con severity, evidenze e raccomandazioni.
## Checklist OWASP Top 10
1. A01 - Broken Access Control
2. A02 - Cryptographic Failures
3. A03 - Injection (SQL, NoSQL, OS, LDAP)
4. A04 - Insecure Design
5. A05 - Security Misconfiguration
6. A06 - Vulnerable and Outdated Components
7. A07 - Identification and Authentication Failures
8. A08 - Software and Data Integrity Failures
9. A09 - Security Logging and Monitoring Failures
10. A10 - Server-Side Request Forgery (SSRF)
## Istruzioni per Ogni Voce
1. Identificare i file e gli endpoint rilevanti
2. Analizzare il codice per pattern vulnerabili
3. Classificare la severity: Critical/High/Medium/Low/Info
4. Documentare l'evidenza con riferimento al codice
5. Proporre la remediation con codice di esempio
6. Stimare l'effort di correzione
## Formato Report
| # | Vulnerabilità | Severity | File | Stato |
|---|--------------|----------|------|-------|
| A01 | Access Control | ... | ... | ... |
3. 단계별로 맞춤형 스킬 만들기
맞춤형 기술을 만드는 것이 Claude Code를 필요에 맞게 조정하는 가장 좋은 방법입니다. 귀하의 프로젝트와 팀에 따라 다릅니다. 전체 과정을 보자 디자인부터 테스트까지.
1단계: 필요성 파악
스킬을 만들기 전, 반복적인 패턴 파악은 필수 표준화할 수 있는 워크플로에서 최고의 기술은 업무에서 나온다 자주 실행되고, 명확한 규칙이 있으며, 결과를 생성합니다. 예측 가능.
좋은 기술의 기준
- 반복성: 작업이 일주일에 여러 번 실행됩니다.
- 명확한 규칙: 정의되고 예측 가능한 단계가 있습니다.
- 구조화된 출력: 결과는 일관된 형식을 갖습니다.
- 정의된 도메인: 이 기술은 특정하고 제한된 영역을 다루고 있습니다.
- 추가된 가치: 자동화로 상당한 시간 절약
2단계: 기술 설계
# Angular Standalone Component Generator
## Descrizione
Genera componenti Angular standalone seguendo le convenzioni
del progetto. Crea il file component.ts, il template HTML,
il foglio di stile CSS e il file di test .spec.ts.
## capacità
- Generare componenti standalone con signal per state management
- Creare template con design system del progetto
- Generare stili seguendo le convenzioni CSS/SCSS del progetto
- Scrivere test unitari con TestBed e ComponentFixture
- Applicare OnPush change detection
- Integrare con il router se richiesto
## Convenzioni del Progetto
- File naming: kebab-case (user-profile.component.ts)
- Selector prefix: app- (app-user-profile)
- State management: Angular Signals (non RxJS per stato locale)
- Change detection: OnPush
- Stili: CSS scoped al componente
- Test: Jasmine + TestBed
## Template Componente
```typescript
import { Component, signal, input, output } from '@angular/core';
@Component({
standalone: true,
selector: 'app-[nome]',
templateUrl: './[nome].component.html',
styleUrls: ['./[nome].component.css'],
changeDetection: ChangeDetectionStrategy.OnPush,
imports: []
})
export class [Nome]Component {
// Input signals
// State signals
// Output events
// Methods
}
```
## Template Test
```typescript
describe('[Nome]Component', () => {
let component: [Nome]Component;
let fixture: ComponentFixture<[Nome]Component>;
beforeEach(async () => {
await TestBed.configureTestingModule({
imports: [[Nome]Component]
}).compileComponents();
fixture = TestBed.createComponent([Nome]Component);
component = fixture.componentInstance;
fixture.detectChanges();
});
it('should create', () => {
expect(component).toBeTruthy();
});
});
```
## Vincoli
- Usare SEMPRE standalone: true
- NON usare ngModule
- Preferire signal() a BehaviorSubject per stato locale
- Includere almeno 3 test nel file .spec.ts
- Documentare ogni input/output con commento JSDoc
3단계: 기술 테스트
스킬 파일을 생성한 후에는 다양한 프롬프트로 테스트하는 것이 필수적입니다. Claude가 이를 올바르게 호출하고 일관된 결과를 생성하는지 확인합니다.
# Test 1: Richiesta diretta
> Crea un componente UserProfile con campo nome ed email
# Verifica:
# - Ha creato user-profile.component.ts con standalone: true?
# - Ha usato signal() per lo stato?
# - Ha generato il file .spec.ts con almeno 3 test?
# Test 2: Richiesta con routing
> Genera un componente Dashboard che sia una route lazy-loaded
# Verifica:
# - Ha configurato il routing correttamente?
# - Ha applicato OnPush change detection?
# Test 3: Richiesta complessa
> Crea un componente ProductList con paginazione, filtri e ordinamento
# Verifica:
# - Ha gestito lo stato con signal?
# - Ha separato la logica in metodi chiari?
# - I test coprono i casi edge?
4단계: 반복 및 개선
최고의 기술은 시간이 지남에 따라 진화하는 기술입니다. 첫 번째 테스트 이후, 누락된 제약 조건을 추가하고 모호한 지침을 명확히 해야 하는 것이 일반적입니다. 특정 사례에 대한 예를 추가합니다.
개선 체크리스트
- 스킬 이름이 해당 기능을 명확하게 설명합니까?
- 지침이 충분히 상세합니까?
- 제약 조건이 발생하는 모든 극단적인 경우를 포괄합니까?
- 예제는 가장 일반적인 사용 사례를 나타냅니까?
- 출력 형식이 일관되고 유용합니까?
- 스킬이 오류를 올바르게 처리합니까?
- 새로운 팀 구성원을 위한 문서가 명확합니까?
4. 워크플로에 기술 통합
기술은 통합될 때 최대 잠재력에 도달합니다. 팀의 일일 개발 워크플로에 유기적으로 통합됩니다. 패턴은 다음과 같습니다. 더욱 효과적인 통합.
패턴 1: 스킬 체인
복잡한 작업을 위해 여러 기술을 순차적으로 결합합니다. 예를 들어 새 제품의 경우
사용할 수 있는 기능: api-design-first API를 정의한 다음
tdd-workflow 그럼 테스트를 위해 angular-component-gen
프론트엔드용.
# Passo 1: Progettazione API
> Progetta l'API per il modulo notifiche push
> Endpoint: GET /notifications, POST /notifications/subscribe,
> DELETE /notifications/{id}
# La skill api-design-first genera la specifica OpenAPI
# Passo 2: Test first
> Genera i test per il NotificationService seguendo TDD
> Basa i test sulla specifica API appena generata
# La skill tdd-workflow genera i test (fase Red)
# Passo 3: Implementazione
> Implementa il NotificationService per far passare i test
# La skill tdd-workflow guida l'implementazione (fase Green)
# Passo 4: Frontend
> Crea il componente NotificationPanel per visualizzare le notifiche
# La skill angular-component-gen crea il componente
# Passo 5: Documentazione
> Genera la documentazione per il modulo notifiche
# La skill changelog-generator o docx-generator documenta tutto
패턴 2: 스킬 게이트(품질 게이트로서의 스킬)
중요한 작업 전에 기술을 품질 체크포인트로 사용하십시오. 예를 들어,
실행하다 owasp-checklist 각 메인으로 병합하기 전에 o
dependency-auditor 각 릴리스 전에.
패턴 3: 기술 라이브러리(팀 기술 라이브러리)
프로젝트 저장소에서 기술을 공유하면 모든 구성원이 허용됩니다.
팀이 그로부터 이익을 얻을 수 있습니다. 디렉토리 .claude/skills/ 헌신하다
저장소에서는 하나가 됩니다. 공유 기술 라이브러리 팀의.
.claude/
skills/
# Skill di sviluppo
dev/
angular-component-gen.md
spring-service-gen.md
api-design-first.md
tdd-workflow.md
# Skill di qualità
quality/
code-review-checklist.md
owasp-checklist.md
dependency-auditor.md
performance-analyzer.md
# Skill di documentazione
docs/
docx-generator.md
changelog-generator.md
adr-writer.md
# Skill di analisi
analysis/
csv-data-summarizer.md
log-analyzer.md
root-cause-tracing.md
# Skill di project management
pm/
meeting-analytics.md
sprint-planner.md
standup-reporter.md
5. 스킬 설계 모범 사례
수십 가지 기술을 사용한 후에는 수행하는 작업에 대한 명확한 패턴이 나타납니다. 효과적인 기술. 다음은 커뮤니티에서 통합한 모범 사례입니다.
기술 모범 사례
| 원칙 | 설명 | Esempio |
|---|---|---|
| 단일 책임 | 각 스킬은 한 가지 일만 수행하며 잘 수행됩니다. | "테스트 생성"과 "테스트 실행"을 분리하세요. |
| 명시적인 지침 | 명확하고 모호하지 않은 지침 | "테스트 프레임워크 사용"이 아닌 "테스트에 Jasmine 사용" |
| 구체적인 예 | 입력 및 예상 출력이 포함된 최소 2~3개의 예 | 의사 코드가 아닌 완전한 코드 템플릿 |
| 제약 조건 지우기 | 하지 말아야 할 일에 대한 명시적인 제약 | "ngModule을 사용하지 마세요. 독립형만 사용하세요: true" |
| 출력 형식 | 정의되고 일관된 출력 형식 | 템플릿 마크다운, 파일 구조, 이름 지정 |
| 오류 처리 | 엣지 케이스 및 오류 관리 | "파일이 이미 존재하는 경우 덮어쓰기 전에 확인을 요청하세요." |
| 종속성 선언 | 외부 종속성 선언 | "필요: npm docx, @types/docx" |
| 버전 관리 | 파일에 스킬 버전 포함 | "버전: 1.2.0 - 마지막 업데이트: 2026-02-14" |
피해야 할 안티패턴
스킬 생성의 일반적인 실수
- 너무 일반적인 기술: "코드 생성"이 너무 모호합니다. 언어, 프레임워크, 규칙을 지정하세요.
- 모호한 지침: "좋은 코드 작성"은 아무 의미가 없습니다. 구체적인 품질 지표를 정의하세요.
- 예시 부족: 구체적인 예가 없으면 Claude는 지시 사항을 예측할 수 없게 해석합니다.
- 모순되는 제약: "TypeScript strict 사용"과 "유형 주석 사용 안 함"이 서로 모순됩니다.
- 모놀리식 기술: 모든 작업(생성, 테스트, 문서화, 배포)을 수행하고 관리하기 어려운 기술
- 출력 형식 없음: 정의된 형식이 없으면 각 실행마다 다른 결과가 생성됩니다.
- 종속성을 무시합니다. 스킬에 npm 패키지가 필요한 경우 명시적으로 명시하세요.
6. 고급 스킬 관리
스킬 구성
기술을 함께 구성하여 복잡한 워크플로를 만들 수 있습니다. 비결은 각 기술을 호환 가능한 입력 및 출력으로 설계하는 것입니다. 하나의 출력이 다음 출력의 입력을 제공할 수 있습니다.
# Full Feature Pipeline
## Descrizione
Orchestrazione completa per la creazione di una nuova feature,
dalla specifica API al deploy. Combina le skill: api-design-first,
tdd-workflow, angular-component-gen, e changelog-generator.
## Pipeline
### Fase 1: Design (api-design-first)
- Input: Requisiti della feature in linguaggio naturale
- Output: Specifica OpenAPI completa
- Gate: Approvazione della specifica da parte dell'utente
### Fase 2: Backend (tdd-workflow)
- Input: Specifica OpenAPI dalla Fase 1
- Output: Service + Controller + Test con copertura 80%+
- Gate: Tutti i test passano
### Fase 3: Frontend (angular-component-gen)
- Input: API endpoints dalla Fase 1 + modelli dati
- Output: Componenti Angular standalone con test
- Gate: Build senza errori + test passano
### Fase 4: Documentazione (changelog-generator)
- Input: Tutti i file creati/modificati nelle fasi precedenti
- Output: Entry changelog + aggiornamento README
- Gate: Review della documentazione
## Vincoli
- Ogni fase richiede approvazione prima di procedere
- Se una fase fallisce, tornare alla fase precedente
- Mantenere git commit separati per ogni fase
스킬 버전 관리
기술은 프로젝트와 함께 발전합니다. 헤더를 포함하는 것이 좋습니다 각 스킬의 버전을 기록하고 변경 사항에 대한 변경 로그를 유지하세요.
# Angular Component Generator
> Versione: 2.1.0 | Ultimo aggiornamento: 2026-02-14
> Changelog:
> - 2.1.0: Aggiunto supporto per lazy-loaded routes
> - 2.0.0: Migrazione da ngModule a standalone
> - 1.3.0: Aggiunto template per form reattivi
> - 1.2.0: Aggiunto OnPush change detection
> - 1.1.0: Aggiunto supporto signal()
> - 1.0.0: Rilascio iniziale
## Descrizione
...
자동 기술 테스트
시간이 지나도 기술이 계속 올바르게 작동하도록 하려면 출력을 확인하는 자동화된 테스트 스크립트를 생성할 수 있습니다. 미리 정의된 기대에 비해 기술이 향상되었습니다.
#!/bin/bash
# Test automatico delle skill di Claude Code
echo "=== Testing Agent Skills ==="
# Test 1: Angular Component Generator
echo "Testing: Angular Component Generator..."
OUTPUT=$(claude --print "Crea un componente TestWidget con un input 'title' di tipo string" \
--output-format json --max-iterations 5 2>&1)
if echo "$OUTPUT" | grep -q "standalone: true"; then
echo " PASS: standalone component generated"
else
echo " FAIL: standalone not found in output"
fi
if echo "$OUTPUT" | grep -q "signal\|input()"; then
echo " PASS: signal/input used"
else
echo " FAIL: signal/input not found"
fi
# Test 2: TDD Workflow
echo "Testing: TDD Workflow..."
OUTPUT=$(claude --print "Scrivi i test per una funzione calculateDiscount(price, percentage)" \
--output-format json --max-iterations 5 2>&1)
if echo "$OUTPUT" | grep -q "describe\|it("; then
echo " PASS: test structure generated"
else
echo " FAIL: test structure not found"
fi
echo "=== Test Complete ==="
결론
에이전트 스킬은 Claude Code를 일반 보조원에서 전문 기술의 생태계 프로젝트에 맞는 것 그리고 팀에게. 10가지 기술 범주 - 문서 생성부터 보안, 데이터 분석부터 프로젝트 관리까지 전체를 포괄합니다. 소프트웨어 개발 요구의 스펙트럼.
핵심 사항
- 스킬은 Markdown 파일입니다.
.claude/skills/: 팀 내에서 간단하게 생성, 버전화 및 공유할 수 있습니다. - 10가지 범주가 모든 요구 사항을 충족합니다. 문서, 개발, 데이터, 연구, 글쓰기, 학습, 미디어, 건강, PM, 보안
- 단일 책임을 지닌 디자인: 각 스킬은 한 가지 일만 수행하며 잘 수행됩니다.
- 구체적인 예가 기본입니다. Claude는 템플릿과 예상 결과를 통해 기술을 더 잘 해석합니다.
- 복잡한 작업 흐름을 위한 구성: 스킬 체인, 스킬 게이트 및 전체 기능 파이프라인
- 지속적인 반복: 최고의 기술은 프로젝트와 팀 피드백을 통해 발전합니다.
- 저장소에서 공유: 헌신적인 기술은 팀 지식의 도서관이 됩니다
에서 다음 기사 우리는 전문 하위 에이전트: 내에서 독립적으로 작동하는 특정 역할을 가진 자율 에이전트 클로드 코드로. 언어 전문가, DevOps 전문가를 만드는 방법을 살펴보겠습니다. 수석 에이전트와 시너지 효과를 발휘하는 보안 감사자.







