Communitygithub.com

spec-editor/spec-editor

요구사항 문서를 입력하면 AI 에이전트들이 토론하여 7개 언어의 @implements가 포함된 구조화된 명세서를 생성합니다.

spec-editor란 무엇인가요?

이 스킬은 소프트웨어 개발 초기 단계에서 흔히 발생하는 요구사항의 모호성을 해결하고, 명확하고 실행 가능한 명세서를 자동으로 생성하는 데 목적이 있습니다. 사용자가 요구사항 문서를 입력하면, 여러 AI 에이전트가 각각의 역할(예: 설계자, 비판자, 전문가)을 맡아 토론하고 협력하여 모호한 점을 명확히 합니다. 그 결과물은 구조화된 명세서 형태로, 주요 함수나 클래스에 '@implements' 태그를 명시하여 특정 구현을 지시할 수 있으며, Python, JavaScript, TypeScript, Rust, Go, Java, C++ 등 7개 언어로 변환할 수 있습니다. Claude, Cursor 등 다양한 AI 코딩 도구에서 활용 가능하며, 이를 통해 개발자는 요구사항 분석과 명세서 작성에 드는 시간을 대폭 줄이고, AI가 생성한 정확한 명세를 바탕으로 바로 코딩을 시작할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add spec-editor/spec-editor

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

spec-editor은(는) 무엇을 하나요?

요구사항 문서를 입력하면 → AI 에이전트들이 토론하여 → 7개 언어의 @implements가 포함된 구조화된 명세서를 생성합니다.

개요

spec-editor/spec-editor는 소프트웨어 개발 워크플로우에서 요구사항 분석과 명세서 작성 단계를 자동화합니다. 사용자는 자연어로 작성된 요구사항 문서를 제공하기만 하면, 시스템 내의 여러 AI 에이전트가 자동으로 토론을 시작합니다.

동작 방식

  1. 요구사항 입력: 사용자가 .md 또는 .txt 형식의 요구사항 문서를 제공합니다.
  2. AI 에이전트 토론: 다수의 AI 에이전트가 각각 다른 역할(예: 시스템 설계자, 코드 리뷰어, 도메인 전문가)을 맡아 입력된 요구사항을 분석하고, 모호한 부분을 질문하며 최종 합의를 도출합니다.
  3. 구조화된 명세서 생성: 토론 결과를 바탕으로 함수, 클래스, 인터페이스 단위로 명확히 정의된 구조화된 명세서가 생성됩니다.
  4. @implements 지시자: 명세서 내의 특정 항목에 @implements 태그를 추가하여, AI가 해당 구현을 특정 언어나 방식으로 작성하도록 지시할 수 있습니다.
  5. 7개 언어 지원: 최종 명세서는 다음 7개 언어 중 하나로 변환되어 제공됩니다: Python, JavaScript, TypeScript, Rust, Go, Java, C++

사용 예시

# 명령어 예시 (가정)
spec-editor --input requirements.md --language typescript --output spec.md

지원 도구

  • Claude Code
  • Cursor
  • Codex
  • 기타 AI 기반 개발 도구

참고

  • @implements 지시자는 생성된 명세서의 함수나 클래스 위에 주석 형태로 포함됩니다.
  • 토론 과정은 투명하게 기록되어 사용자가 확인할 수 있습니다.
  • 요구사항이 변경될 경우, AI 에이전트가 자동으로 명세서를 업데이트합니다.

관련 스킬