현지화된 읽기 가이드
writing-plans목적, 사용법 및 출처
여러 단계를 거치는 작업에 대한 사양이나 요구 사항이 있을 때, 코드를 작성하기 전에 이 단계를 수행하십시오.
출처 검색됨:
- 소스 저장소
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- 저장소 Star
- 309,479
- 저장소 최근 업데이트
- 2026-10-30
- 능력 분류
- 에이전트 워크플로
- 최근 수집 시간
라이선스: MIT
워크플로 발췌본은 이해를 돕기 위한 자료이며, Codez에서 제공하는 실행 가능한 명령어가 아닙니다. 이 페이지를 생성하는 데 타사 Skill은 사용되지 않았습니다.
아래의 목적 및 워크플로 관련 내용은 읽기 쉽도록 정리 및 번역된 상위 자료입니다. 이는 별도로 분류된 Codez 편집 분석과는 별개입니다.
이 스킬의 기능
여러 단계를 거치는 작업에 대한 사양이나 요구 사항이 있을 때, 코드를 작성하기 전에 이 단계를 수행하십시오.
업스트림 워크플로우 작동 방식
개요
이 코드베이스나 사양서를 본 적 없는 엔지니어를 위해 구현 계획을 작성하세요. 엔지니어는 정확한 인터페이스와 테스트를 알게 되면 프로젝트 언어에 맞는 관용적인 코드를 작성하고, 계획에 미비점이 있는 경우 합리적인 선택을 할 것이라고 가정합니다. 엔지니어가 알 수 없는 것은 여러분이 결정한 내용입니다. 즉, 어떤 파일을 사용할지, 어떤 이름과 시그니처를 사용할지, 사양서의 어떤 값을 사용할지, 어떤 테스트가 각 작업을 검증할지 등을 알 수 없습니다. 이러한 사항들을 문서화하세요. 전체 계획을 작은 단위로 나누어 엔지니어에게 제공하세요. DRY(Don't Repeat Yourself), YAGNI(You A Gandhi Game, GitHub Initiative), TDD(테스트 주도 개발), 잦은 커밋을 권장합니다. 시작할 때 "저는 writing-plans 스킬을 사용하여 구현 계획을 작성하고 있습니다."라고 알려주세요. (참고: 격리된 작업 트리에서 작업하는 경우, 해당 스킬은 write-plans를 통해 생성되었어야 합니다.)superpowers:using-git-worktrees실행 시점의 숙련도. 계획을 저장하려면 다음을 참조하세요.docs/superpowers/plans/YYYY-MM-DD-.md
단계 세분화
각 단계는 검증 가능한 결과를 가진 하나의 행동입니다. "실패하는 테스트 작성" - 단계, "실패 여부를 확인하기 위해 실행" - 단계, "테스트를 통과시키기 위한 최소한의 코드 구현" - 단계
상류 통로 · L43 ↗단계별 구성 요소
구현자가 해당 단계에서 정확히 하나의 합리적인 내용을 작성할 수 있을 때 단계가 완료된 것으로 간주합니다. 이것이 전체 요구 사항입니다. 즉, 모호하지 않아야 하며, 완전할 필요는 없습니다. 각 단계는 모호함을 없애는 데 필요한 요소만 포함하고 그 이상은 포함하지 않습니다. 테스트 단계: 테스트 이름과 어설션을 코드로 작성하고, 명세에 명시된 정확한 값을 포함합니다. 코드 단계: 정확한 시그니처(이름, 매개변수, 반환 유형), 코드가 저장될 파일, 그리고 명세에서 지정한 특정 값을 포함합니다. 구현자는 본문을 작성합니다. 본문은 시그니처와 테스트에서 결정되지 않은 알고리즘이나 명세에서 수정된 정확한 복사본에 대해서만 존재합니다. 검증 단계: 실행할 명령과 명령이 통과했음을 나타내는 출력 결과를 포함합니다.
상류 통로 · L140 ↗요구 사항 및 설정
이 파일에서 간략한 요구사항 구절이 선택되지 않았습니다. 이는 해당 스킬에 종속성이 없다는 의미는 아닙니다. 저장소 설정 지침 및 참조 파일을 확인하십시오.
제한 사항 및 품질 검사
이 파일에서 별도의 제한 조건 구문이 선택되지 않았습니다. 이는 해당 스킬이 모든 입력 또는 환경에서 안전하다는 것을 의미하지 않습니다. 전체 소스 코드를 검토하고 결과를 직접 확인하십시오.
안전한 시험 사용부터 시작하세요
- 지원되는 호스트와 저장소 설치 지침을 확인하세요. 스킬 디렉토리와 해당 디렉토리에서 참조하는 스크립트, 자산 및 문서를 함께 보관하세요.SKILL.md단독으로는 종속성을 생략할 수 있습니다.
- 에이전트에 실제 입력값, 원하는 출력값 및 승인 기준을 제공하십시오. 호출 구문 및 사용 가능한 도구는 호스트에 따라 다르므로 이 사이트는 범용 설치 명령을 제공하지 않습니다.
- 원본 워크플로를 임시 프로젝트 또는 복사본에서 테스트해 보세요. 파일, 원격 서비스 또는 유료 리소스를 변경하는 작업은 허용하기 전에 검토하십시오.
- 출력 결과를 원본 품질 검사 및 자체 요구 사항에 맞춰 검증하십시오. 트리거가 성공적으로 작동했거나 저장소의 별점 수가 높다고 해서 반드시 올바른 결과가 나오는 것은 아닙니다.
원문에서 더 자세한 내용을 읽어보세요.
관련 기술
번역 및 범위
이 독서 안내서는 고정된 상류 지역에서 발췌한 구절들을 소개합니다.SKILL.md본 번역은 보조 번역이며, 완전한 설명서 또는 호환성 테스트를 보장하는 것은 아닙니다. 사용 전에 원본 및 참조 파일을 반드시 읽어 주십시오.
이 소개글은 아래 고정된 버전을 참조하며, 현재 저장소 활동 및 수집 시간은 별도로 표시됩니다.
- 고정된 소스
- 원문을 읽어보세요 ↗
- 출처 검색됨
- 소스 커밋
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- 출처 SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a