현지화된 읽기 가이드
writing-skills목적, 사용법 및 출처
새로운 스킬을 생성하거나, 기존 스킬을 편집하거나, 배포 전에 스킬이 제대로 작동하는지 확인할 때 사용하십시오.
출처 검색됨:
- 소스 저장소
- obra/superpowers
- SKILL.md
skills/writing-skills/SKILL.md- 저장소 Star
- 309,479
- 저장소 최근 업데이트
- 2026-10-30
- 능력 분류
- 에이전트 워크플로
- 최근 수집 시간
라이선스: MIT
워크플로 발췌본은 이해를 돕기 위한 자료이며, Codez에서 제공하는 실행 가능한 명령어가 아닙니다. 이 페이지를 생성하는 데 타사 Skill은 사용되지 않았습니다.
아래의 목적 및 워크플로 관련 내용은 읽기 쉽도록 정리 및 번역된 상위 자료입니다. 이는 별도로 분류된 Codez 편집 분석과는 별개입니다.
이 스킬의 기능
새로운 스킬을 생성하거나, 기존 스킬을 편집하거나, 배포 전에 스킬이 제대로 작동하는지 확인할 때 사용하십시오.
업스트림 워크플로우 작동 방식
발견 워크플로
미래의 에이전트가 당신의 스킬을 찾는 방법: 문제 발생("테스트가 불안정해요") 스킬 검색(설명 검색, 카테고리 탐색) 스킬 발견(설명 일치)
상류 통로 · L388 ↗개요
글쓰기 능력은 테스트 주도 개발(TDD)을 프로세스 문서화에 적용한 것입니다. 개인 기술은 런타임의 기술 디렉터리에 있습니다.~/.claude/skills/클로드 코드에 관하여) — 참조codex-tools.md또는gemini-tools.md해당 런타임에서의 경로에 대해서는 Codex, Copilot CLI, Gemini CLI 모두 이를 인식합니다.~/.agents/skills/크로스 런타임 별칭으로 사용합니다. 테스트 케이스(하위 에이전트를 사용한 압력 시나리오)를 작성하고, 실패 여부를 관찰하여 기준 동작을 파악하고, 스킬(문서)을 작성하고, 테스트 통과 여부를 확인하여 에이전트의 동작이 제대로 작동하는지 확인한 후, 리팩토링(허점 보완)을 진행합니다. 핵심 원칙은 다음과 같습니다. 스킬 없이 에이전트가 실패하는 모습을 확인하지 않으면 스킬이 올바른 것을 학습시키는지 알 수 없습니다.
스킬을 언제 생성해야 할까요?
이 기법이 직관적으로 와닿지 않았을 수도 있지만, 여러 프로젝트에서 다시 참고하게 될 것이고, 이 패턴은 특정 프로젝트에 국한되지 않고 광범위하게 적용될 수 있으므로 다른 사람들에게도 도움이 될 것입니다.
상류 통로 · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if needed요구 사항 및 설정
제한 사항 및 품질 검사
이 파일에서 별도의 제한 조건 구문이 선택되지 않았습니다. 이는 해당 스킬이 모든 입력 또는 환경에서 안전하다는 것을 의미하지 않습니다. 전체 소스 코드를 검토하고 결과를 직접 확인하십시오.
안전한 시험 사용부터 시작하세요
- 지원되는 호스트와 저장소 설치 지침을 확인하세요. 스킬 디렉토리와 해당 디렉토리에서 참조하는 스크립트, 자산 및 문서를 함께 보관하세요.SKILL.md단독으로는 종속성을 생략할 수 있습니다.
- 에이전트에 실제 입력값, 원하는 출력값 및 승인 기준을 제공하십시오. 호출 구문 및 사용 가능한 도구는 호스트에 따라 다르므로 이 사이트는 범용 설치 명령을 제공하지 않습니다.
- 원본 워크플로를 임시 프로젝트 또는 복사본에서 테스트해 보세요. 파일, 원격 서비스 또는 유료 리소스를 변경하는 작업은 허용하기 전에 검토하십시오.
- 출력 결과를 원본 품질 검사 및 자체 요구 사항에 맞춰 검증하십시오. 트리거가 성공적으로 작동했거나 저장소의 별점 수가 높다고 해서 반드시 올바른 결과가 나오는 것은 아닙니다.
원문에서 더 자세한 내용을 읽어보세요.
- 개요
- 스킬이란 무엇인가요?
- 스킬 개발을 위한 TDD 매핑
- 스킬을 언제 생성해야 할까요?
- 기술
- 무늬
- 참조
- 디렉토리 구조
- 글쓰기SKILL.md
- 순서도
- 코드 예제
- 독립적인 기술
- 재사용 가능한 도구를 활용하는 기술
- 참고 자료가 많은 스킬
- 철칙 (TDD와 동일)
- 모든 기술 유형 테스트
- 규율 집행 기술 (rules/requirements)
- 기술 (방법 안내)
- 패턴 기술 (정신 모델)
- 참고 기술 (documentation/APIs)
- 테스트를 건너뛰는 일반적인 이유
- 실패 원인에 맞는 양식을 찾으세요
- 합리화에 대한 방어책
- 스킬을 위한 적록분산분석
- 빨간색: 실패하는 테스트 기록(기준선)
- 녹색: 최소한의 기술로 글쓰기
- 리팩토링: 허점을 메우다
- 전체 시나리오 실행 전 마이크로 테스트 문구 검토
- ❌ 서술 예시
- ❌ 다국어 희석
관련 기술
번역 및 범위
이 독서 안내서는 고정된 상류 지역에서 발췌한 구절들을 소개합니다.SKILL.md본 번역은 보조 번역이며, 완전한 설명서 또는 호환성 테스트를 보장하는 것은 아닙니다. 사용 전에 원본 및 참조 파일을 반드시 읽어 주십시오.
이 소개글은 아래 고정된 버전을 참조하며, 현재 저장소 활동 및 수집 시간은 별도로 표시됩니다.
- 고정된 소스
- 원문을 읽어보세요 ↗
- 출처 검색됨
- 소스 커밋
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- 출처 SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe