spec-writer

Generate implementation-ready development specifications from game design documents and codebase scans.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/voidreader/band-of-mercenaries --skill spec-writer-voidreader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writer
Source: https://github.com/voidreader/band-of-mercenaries/tree/main/.agents/skills/spec-writer
Command: npx skills add https://github.com/voidreader/band-of-mercenaries --skill spec-writer-voidreader

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

이 Skill은 기획 문서를 읽고 코드베이스를 함께 탐색해, 구현팀이 바로 사용할 수 있는 개발 명세서로 정리하는 수고를 줄여줍니다.

Core Features & Use Cases

  • 기획 분석: 게임 기획서의 목적, 요구사항, 수치, UI 의도를 구조적으로 해석합니다.
  • 코드베이스 매핑: 관련 Provider, Widget, Hive 박스, Supabase 모델, 생성 필요 파일을 실제 코드 기준으로 식별합니다.
  • 명세서 생성: 구현 범위, 영향 파일, 기술 참고사항, 기획 확인 사항까지 포함한 실행 가능한 문서를 작성합니다.
  • Use Case: 새로운 퀘스트 시스템을 추가하려는 경우, 기획 문서를 입력하면 수정 범위와 데이터 변경 여부를 정리한 개발 명세서를 즉시 만들 수 있습니다.

Quick Start

기획 문서 경로를 전달하며 /spec-writer @Docs/20260323_신규퀘스트_기획.md 형태로 호출해 개발 명세서 생성을 요청하세요.

Frequently Asked Questions about spec-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert game design documents into implementation-ready development specifications?

Converting game design documents into development specifications requires analyzing design intent, mapping affected files like Hive boxes and Supabase models, and structuring implementation scope with open questions. This skill automates that entire pipeline from codebase scan to final spec.

What's the best way to identify affected files when planning a new Flutter game feature?

Identifying affected files when planning a Flutter game feature involves scanning the codebase to map related Providers, Widgets, and Hive boxes. This skill cross-references the design document against actual code to pinpoint every file needing modification.

Can I generate a development spec for Supabase data model adjustments from a game design document?

Generating a development spec for Supabase data model adjustments from a game design document is supported. The skill maps design requirements to actual Supabase models in your codebase and outputs the necessary data boundary changes within the final specification.

How does codebase analysis improve the quality of a software development specification?

Codebase analysis improves software development specifications by grounding design intent in actual code structure. The skill scans for system boundaries and affected files, ensuring the generated spec references real Providers, Widgets, and data layers rather than theoretical constructs.

Do I need to manually list open questions before generating an implementation-ready spec?

You do not need to manually list open questions before generating an implementation-ready spec. The skill automatically identifies unresolved design confirmations and technical ambiguities during analysis, including them as a dedicated section in the final output document.

What limitations should I expect when mapping game design requirements to a Flutter codebase?

Mapping game design requirements to a Flutter codebase is limited by the accuracy of the codebase scan and document clarity. The skill requires precise identification of system boundaries and affected files, so incomplete design documents may yield specs with unresolved open questions.