plugin-dev

1. 미션

이 메타 스킬은 AI 에코시스템의 완전한 기술 거버넌스를 보장합니다. 즉, 공유 스킬(.agents/skills/), 황금 규칙 및 영구 지침(.agents/rules/), 그리고 패키지 지식의 지속적인 축적([PkgName]_IA_CONTEXT.md)을 설계, 생성 및 지속적으로 정제합니다.

불가침 기본 원칙:

• SSOT(단일 진실 공급원): 모든 규칙, 사양 또는 지침은 권위 있는 단일 위치에 있어야 합니다. 여러 파일에 걸쳐 지침을 복제하는 것은 공식적으로 금지됩니다.
• DRY(반복 금지): 기존 지침을 다시 작성하거나 복제하지 마십시오. 모든 스킬 또는 문서는 단순한 참조 또는 링크를 통해 기존 규칙을 활용해야 합니다.
• Anthropic의 참조 패턴(feature-dev, claude-code-setup, pr-review-toolkit)을 체계적으로 적용하고, 규칙 간의 비모순성을 보장하며, 새로운 워크플로우를 문서화하고, YAML 형식의 사고 보고서로 피드백을 기록합니다.

2. 트리거 및 제한 사항

• 활성화 조건:
  • 대화 종료 / 세션 회고: /plugin-dev에 의해 호출되어 처리된 패키지의 [PkgName]_IA_CONTEXT.md 파일과 관련 스킬에 대한 개선 계획을 제안하고, 세션 중 발견한 내용, 함정 및 메커니즘을 기록합니다.
  • 새 스킬 생성 요청("자동화된 테스트를 관리하는 스킬을 만들어 줘", "설계-아키텍처 스킬 추가")
  • 경험 피드백에 따른 기존 스킬 정제 또는 수정("feature-dev 스킬을 수정하여 X를 금지")
  • 행동 규칙 생성, 업데이트 또는 감사("사용된 스킬을 표시하는 규칙 추가", "critical-rules.md의 마이그레이션 관련 중요 규칙 수정")
  • 새로운 워크플로우 문서화
  • 스킬 준수 감사, 지침 일관성 확인, 중복(DRY/SSOT) 제거 및 SemVer 제어
• 활성화하지 않을 조건:
  • 튜토리얼 작성 또는 단순화 ➔ tutorial-writer 사용
  • Jekyll 컴포넌트 또는 스타일 개발 ➔ dev-jekyll 사용
  • 공유 기술 기반(Core Theme) 동기화 ➔ sync-theme 사용
  • 에이전트 초기화 또는 프로젝트 진단 ➔ project-setup 사용

3. 입력 및 로드할 리소스

• 우선순위 1: .agents/skills/plugin-dev/resources/anthropic-skill-patterns.md (Anthropic 공식 패턴 캡슐화)
• 우선순위 2: 규칙 파일:
  • .agents/rules/critical-rules.md (불변 중요 규칙)
  • .agents/rules/*.md (실행 및 스타일 지침)
• 우선순위 3: .agents/templates/generic-skill.md (10개 섹션 템플릿) 및 .agents/templates/workflow-blueprint.md (워크플로우 모델)
• 우선순위 4: 글로벌 허브의 catalog.yaml 레지스트리 및 CHANGELOG.md

4. 제약 조건 및 불가침 규칙

• SSOT(단일 진실 공급원) 및 DRY 핵심 원칙:
  • 모든 규칙, 지침 또는 사양은 단 한 곳에만 존재해야 합니다.
  • 행동 규칙은 .agents/rules/[name].md에 위치합니다. 스킬은 이러한 규칙의 텍스트를 절대 복제하지 말고 직접 참조해야 합니다.
• 패키지 컨텍스트 파일 표준 형식:
  • 모든 패키지 컨텍스트 파일은 반드시 modules/[PkgName]/[PkgName]_IA_CONTEXT.md (예: PkgRealisationTache_IA_CONTEXT.md)로 명명되어야 합니다.
• .agents/references/의 엄격한 최소주의(단일 스킬 캡슐화):
  • 횡단 디렉토리 .agents/references/는 최소한의 파일만 포함해야 하며, 최소 2개 스킬이 공유하는 규칙 및 표준만을 위해 독점적으로 예약되어야 합니다.
  • 단일 스킬만 사용하는 방법론적 파일, 가이드, 카탈로그 또는 템플릿은 반드시 <skill>/resources/로 이동 및 캡슐화되어야 합니다(Anthropic의 점진적 공개 원칙).
• inspiration 블록 필수: 생성되거나 수정되는 모든 스킬은 YAML 프론트매터에 inspiration: 메타데이터를 출처, 참조 플러그인 및 패턴과 함께 반드시 포함해야 합니다.
• 10개 섹션 엄격 준수: 10개 표준 섹션 중 하나라도 누락된 스킬은 게시될 수 없습니다.
• 규칙의 계층 및 비모순성:
  • 로컬 규칙(.agents/rules/)은 일반 권장 사항보다 우선하지만, 명시적 중재 없이 보안 중요 규칙(critical-rules.md)을 위반해서는 안 됩니다.
  • 각 규칙은 간결하고 명확하며 명시적 트리거(trigger: always_on 또는 조건부)를 포함해야 합니다.
• 자동화된 검증: 모든 스킬 수정은 node scripts/validate-skills.js로 검증되어야 합니다.
• YAML 사고 보고서: 에이전트 버그로 인한 모든 수정은 tests/feedbacks/INC-xxx.yaml에 보고서를 생성해야 합니다.

5. 단계별 절차 (설계 및 정제 워크플로우)

경로 A: 새 스킬 생성

1. 단계 1: 요구사항 분석 및 Anthropic 패턴 선택:
   • resources/anthropic-skill-patterns.md를 참조하여 가장 가까운 패턴(feature-dev, setup, review 등)을 선택합니다.
2. 단계 2: SKILL.md 작성:
   • 10개 섹션 템플릿을 채웁니다.
   • 설명을 3인칭으로 작성하고 활성화 및 제외 사례를 명확히 합니다.
   • YAML inspiration 블록을 채웁니다.
   • 스킬 고유의 리소스 파일을 해당 resources/ 하위 디렉토리에 캡슐화합니다.
3. 단계 3: 결정론적 제어:
   • node scripts/validate-skills.js를 실행합니다.
4. 단계 4: 카탈로그 등록:
   • catalog.yaml에 항목을 추가하고 CHANGELOG.md에 문서화합니다.

경로 B: 기존 스킬 정제

1. 단계 1: 진단 및 YAML 보고서:
   • 컨텍스트, 관찰된 동작 및 목표 수정 사항을 포함하여 tests/feedbacks/INC-[NUM].yaml을 생성합니다.
2. 단계 2: 정밀 수정:
   • 섹션 #4(제약 조건)에 규칙을 추가하거나 섹션 #8(체크리스트)에 이진 테스트를 추가합니다.
3. 단계 3: SemVer 증가:
   • 버전을 업데이트(예: 1.0.1)하고 CHANGELOG.md에 기록합니다.

경로 C: 규칙 생성 또는 수정

1. 단계 1: 규칙 수준 분류:
   • 전역 엔지니어링/보안 규칙 ➔ .agents/rules/critical-rules.md 또는 .agents/rules/general-principles.md에 추가
   • 프로젝트 에이전트 행동 규칙 ➔ .agents/rules/[rule-name].md에 추가
2. 단계 2: 간결하고 불가침한 작성:
   • 명확한 명령형으로 작성("에이전트는 반드시...", "엄격히 금지...")
   • 예상 형식의 직접적인 예시를 제시합니다.
   • SSOT 원칙 준수: 규칙이 이미 존재하는 경우 절대 복제하지 않습니다.
3. 단계 3: 동기화 및 알림:
   • 허브 또는 로컬 프로젝트에 변경 사항을 반영하고 CHANGELOG.md에 진화 내용을 기록합니다.

경로 D: 대화 종료 시 지속적 지식 축적 (/plugin-dev)

1. 단계 1: 회고 및 발견 사항 식별:
   • 최근 세션에서 처리된 패키지를 식별합니다.
   • 에이전트가 조사하거나 추론해야 했던 특정 메커니즘을 추출합니다:
     • 관련 테이블, 모델, 관계 및 비즈니스 훅
     • ViewStateService 또는 테이블 필터의 특이 사항
     • 새로 도입된 시간 서비스, 작업 또는 옵저버
     • 해결된 함정 또는 엣지 케이스(예: 상위 필터 누락으로 인한 잘못된 계산)
2. 단계 2: 문서 격차 평가:
   • 이러한 발견 사항을 modules/[PkgName]/[PkgName]_IA_CONTEXT.md의 기존 내용과 비교합니다.
   • 추가 지침이 필요한 스킬(feature-dev) 또는 규칙이 있는지 확인합니다.
3. 단계 3: 개선 계획 제안:
   • 설계자에게 제안된 추가 사항을 상세히 설명하는 명확하고 구조화된 계획을 제출합니다:
     • [PkgName]_IA_CONTEXT.md의 경우(새 서비스, 주요 필터, 함정 및 권장 사항 섹션)
     • 해당하는 경우 스킬에 대해서도
4. 단계 4: 검증 후 실행:
   • 검증 후 즉시 [PkgName]_IA_CONTEXT.md 파일을 강화하여 향후 모든 유지 관리 세션이 이 축적된 지식을 즉시 활용할 수 있도록 합니다.

6. 모호성 처리 및 결정

• 리소스 위치 중재(스킬 vs 에이전트):
  • 리소스가 특정 스킬에 의해서만 독점적으로 사용되는 경우(예: 편집자의 편집 템플릿, 자체 기술 카탈로그) ➔ 필수 위치: <skill>/resources/[file].md (스킬 섹션 3에서 필요 시 로드)
  • 리소스가 2개 이상의 스킬에서 공유하는 횡단 엔지니어링 표준을 정의하는 경우 ➔ 위치: .agents/references/conventions/ 또는 .agents/references/architecture/
• 스킬 vs 규칙 중재:
  • 지침이 영구적인 제약 또는 횡단 안전장치인 경우(예: 스킬 표시, 응답 스타일, 마이그레이션 금지) ➔ 규칙 생성(.agents/rules/)
  • 지침이 요청 시 트리거, 입력, 단계별 로직 및 결과물을 포함하는 도구화된 시퀀스를 설명하는 경우 ➔ 스킬 생성(SKILL.md)
• 요청된 규칙이 Solicode LMS 전용인 경우: 글로벌 허브 표준을 수정하지 말고 .agents/rules/ 및 .agents/references/conventions/project-conventions.md에 기록합니다.

7. 출력 형식 및 결과물

• 완전한 SKILL.md 파일 또는 규칙 파일(.agents/rules/*.md)
• catalog.yaml 및 CHANGELOG.md 업데이트
• validate-skills.js 스크립트 실행 결과(오류 0)

8. 품질 관리 (이진 체크리스트)

• 스킬의 YAML 프론트매터에 완전한 inspiration 블록(출처, 플러그인, 패턴)이 포함되어 있습니까?
• 설명이 3인칭이며 활성화 및 비활성화 시점을 명확히 하고 있습니까?
• 10개의 표준 섹션이 모두 존재하고 내용이 채워져 있습니까?
• SSOT(단일 진실 공급원) 원칙과 DRY 규칙이 준수되고 있습니까(파일 간 중복 지침 없음)?
• .agents/references/ 디렉토리가 최소화되어 있으며 단일 스킬 리소스가 없습니까?
• 단일 스킬 리소스가 엄격하게 <skill>/resources/에 캡슐화되어 있습니까?
• 규칙인 경우, 간결하고 critical-rules와 모순되지 않으며 명확한 예시가 포함되어 있습니까?
• node scripts/validate-skills.js 스크립트가 성공적으로 통과합니까?

9. 빈번한 오류 처리

일반적인 오류	원인	즉시 해결 방법
특정 리소스를 에이전트 수준에 배치	캡슐화 세분성 부족	파일을 <skill>/resources/로 이동하고 내부 리소스로 참조
단순 수동 규칙에 대해 스킬 생성	규칙과 도구화된 흐름 혼동	지침을 .agents/rules/로 전환
inspiration 메타데이터 누락	부주의	프론트매터에 inspiration 블록을 체계적으로 추가
로컬 규칙이 허브 표준과 충돌	사전 감사 부족	규칙을 공식화하기 전에 .agents/rules/critical-rules.md 감사

10. 구체적인 예시 (Few-Shot)

호출 예시 A (스킬): "content-authoring에서 영감을 받은 tutorial-writer 스킬을 만들어 줘." 동작: 에이전트가 anthropic-skill-patterns.md를 로드하고, 구조화된 작성 패턴을 추출하고, inspiration: { plugin: "content-authoring" }와 함께 10개 섹션을 작성하고, 교수 템플릿을 tutorial-writer/resources/에 격리하고, 스킬을 catalog.yaml에 등록합니다.

호출 예시 B (규칙): "각 메시지 끝에 사용된 스킬을 표시하도록 하는 규칙을 추가해 줘." 동작: 에이전트가 plugin-dev의 경로 C를 적용하고, .agents/rules/affichage-skills.md를 작성하고, .agents/rules/critical-rules.md를 업데이트하고, 즉시 요구되는 형식을 적용합니다.