@simplysm/sd-claude 14.0.79 → 14.0.80

package/claude/skills/sd-skill/references/skill-authoring.md

@@ -1,70 +0,0 @@
-# 스킬 본문 작성
-
-## SKILL.md 템플릿
-
-```markdown
----
-name: skill-name
-description: 기능에 대한 간단한 설명. Use when [활용상황]
----
-
-# 스킬 이름
-
-## 워크플로
-
-[단계별 절차]
-```
-
-## description 작성
-
-description 은 에이전트의 라우팅 진입점이다. 에이전트가 description 을 읽고 사용자의 요청에 맞는 스킬을 골라 호출한다.
-
-**목표**: 에이전트가 다음 두 가지를 판단할 수 있을 만큼의 정보를 제공하라.
-
-1. 이 스킬의 목적은 무엇인가?
-2. 언제/왜 트리거 해야 하는가 (구체적인 맥락)
-
-다른 스킬들과 이 스킬을 구분할 단서를 에이전트에게 제공해야 한다.
-
-**형식**:
-
-- 최대 200자, 한 줄로 작성
-- 3인칭으로 작성
-- 첫 문장: 입력 → 산출물(또는 효과) 한 줄. 내부 처리 단계 금지.
-- 두 번째 문장: "Use when [활용상황]"
-
-**금지**: 내부 단계·알고리즘·사용 도구·로직 흐름은 description 에 쓰지 않는다 (그건 SKILL.md 본문 워크플로의 몫). description 은 외부에서 관찰 가능한 경계(입력·산출물·트리거 맥락)만 노출한다.
-
-## 스크립트를 추가해야 할 때
-
-다음의 경우에 유틸리티 스크립트를 추가하라:
-
-- 동작이 결정론(deterministic)적일 경우 (validation, formatting)
-- 코드 생성이 매번 동일할 경우
-- 에러를 명시적으로 처리해야 할 경우
-
-스크립트를 사용하면 언제나 토큰이 절약되고, 안정성이 개선된다.
-
-## 스크립트 작성 원칙
-
-- 스크립트는 Python(`.py`)으로 작성한다.
-- 스크립트 내부에서 에러를 처리하지 않는다. 에러는 즉시 throw 되어야 한다.
-
-## 파일을 분리해야 할 때
-
-다음의 경우에 별도 파일로 분리하라:
-
-- SKILL.md 분량이 에이전트가 한 자리에서 워크플로 흐름을 인식하기 어려울 만큼 디테일이 누적된 경우
-- 명백히 다른 도메인을 다루는 경우
-- 거의 사용되지 않는 고급 기능
-
-## SKILL.md 리뷰 체크리스트
-
-초안 작성 후 다음을 확인한다:
-
-- [ ] description 에 트리거가 포함되어 있는가? ("Use when ~")
-- [ ] description 에 내부 단계·알고리즘·도구가 들어가 있지 않은가?
-- [ ] SKILL.md 분량이 에이전트가 한 자리에서 워크플로를 인식할 수 있는가? (가이드: 100줄 이내)
-- [ ] 용어 사용이 일관적인가?
-- [ ] 구체적인 예시가 포함되어 있는가?
-- [ ] 참조 깊이가 한 단계인가? (SKILL.md → references/X.md 까지만 허용. references 파일 안에서 또 다른 파일을 참조하지 말 것)