메뉴
스펙 그래프 관리 시스템. flow spec-* 커맨드로 기능 스펙을 JSON으로 관리하고 의존성 그래프를 생성·분석한다. 스펙 생성, 검증, 영향 분석, 상태 전파, 코드 참조 검증이 필요할 때 사용. 스펙 관련 작업 전반에 사용.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | flow-spec-graph |
| description | 스펙 그래프 관리 시스템. flow spec-* 커맨드로 기능 스펙을 JSON으로 관리하고 의존성 그래프를 생성·분석한다. 스펙 생성, 검증, 영향 분석, 상태 전파, 코드 참조 검증이 필요할 때 사용. 스펙 관련 작업 전반에 사용. |
JSON 기반 기능 스펙 관리 및 의존성 그래프 분석 시스템.
# 초기화
./flow.ps1 spec-init
# 생성 (ID 자동 채번)
./flow.ps1 spec-create --title "새 기능" --parent F-001 --tags "core,cli"
# ID 지정 생성
./flow.ps1 spec-create --id F-040 --title "새 기능" --status draft
# 조회
./flow.ps1 spec-get F-010
# 목록 (필터)
./flow.ps1 spec-list --status working --tag core
# 삭제
./flow.ps1 spec-delete F-040
# review JSON 반영
./flow.ps1 spec-append-review F-040 --input-file ./.flow/review/F-040-review.json --reviewer runner-01
# 전체 검증
./flow.ps1 spec-validate
# 엄격 모드 (에러 시 exit 1)
./flow.ps1 spec-validate --strict
# 특정 스펙만
./flow.ps1 spec-validate --id F-010
# 코드 참조 검증
./flow.ps1 spec-check-refs
./flow.ps1 spec-check-refs --strict
# 그래프 정보 출력
./flow.ps1 spec-graph
# 트리 텍스트 출력
./flow.ps1 spec-graph --tree
# JSON 파일로 저장
./flow.ps1 spec-graph --output docs/specs/.spec-cache/graph.json
# 영향 분석
./flow.ps1 spec-impact F-010
# 상태 전파 (dry-run)
./flow.ps1 spec-propagate F-010 --status needs-review
# 상태 전파 (적용)
./flow.ps1 spec-propagate F-010 --status needs-review --apply
./flow.ps1 spec-backup
./flow.ps1 spec-restore 20260228-073219
{
"schemaVersion": 2,
"id": "F-010",
"nodeType": "feature", // feature | task
"title": "스펙 그래프 관리",
"description": "설명",
"status": "queued", // draft|queued|working|needs-review|verified|deprecated|done
"parent": "F-001", // 상위 스펙 ID (트리 구조)
"dependencies": ["F-010"], // 의존 스펙 (DAG 구조)
"conditions": [
{
"id": "F-010-C1",
"nodeType": "condition",
"description": "Given-When-Then 형식 수락 조건",
"status": "verified",
"codeRefs": ["tools/flow-core/Services/SpecStore.cs"],
"evidence": []
}
],
"codeRefs": ["tools/flow-core/Services/SpecStore.cs"],
"tags": ["spec", "graph"]
}
| nodeType | 설명 | 최종 상태 |
|---|---|---|
feature | 지속적으로 유지되는 기능 스펙. 수락 조건(conditions) 필요. | verified |
task | 일회성 처리 스펙. 보안 검토, 데이터 이전 등 한 번 수행하고 끝나는 작업. 수락 조건 불필요. | done |
condition | feature/task의 하위 수락 조건 노드. | verified |
# 보안 검토 task 생성
# task 타입 스펙 생성 예시
# F-099.json의 nodeType을 "task"로 설정
# 검토 완료 후 done으로 종료
docs/specs/docs/specs/{id}.jsondocs/specs/.backup/{timestamp}/docs/specs/.spec-cache/graph.jsonPlaywright CLI로 브라우저 스크린샷을 캡처한다. 로컬 HTML 파일이나 URL을 headless 브라우저에서 열고 PNG로 저장한다. UI 렌더링 검증, 시각적 회귀 테스트에 사용.
자연어 입력을 분석하여 스펙 JSON을 생성하는 스킬. 사용자가 자연어로 설명한 기능 요구사항을 파싱하여 spec-create 커맨드와 JSON 편집으로 완성된 스펙을 추가한다. 스펙 생성, 요구사항 구조화가 필요할 때 사용.
멀티 플랫폼 빌드 시스템. flow build 커맨드를 사용하여 프로젝트를 빌드, 린트, 테스트, 실행한다. unity, python, node, dotnet, flutter 플랫폼을 자동 감지하여 지원한다. 빌드, 린트, 테스트가 필요할 때 사용.
E2E 테스트 실행. flow test e2e 커맨드로 시나리오 기반 E2E 테스트를 실행한다. Flutter, Unity 등 플랫폼의 자동화된 E2E 테스트가 필요할 때 사용.
RAG(Retrieval-Augmented Generation) 데이터베이스 관리. flow db-add, db-query 커맨드로 문서를 저장하고 벡터 검색한다. 과거 작업 이력 조회, 문서 저장, 임베딩 기반 유사도 검색이 필요할 때 사용.
Download skills from GitHub URLs, direct .skill/.zip links, or local paths. Use when a user provides a GitHub URL to a skill folder (including /blob or /tree), a repo root URL, a raw.githubusercontent.com URL, or a local/remote .skill or .zip that should be fetched and saved locally.