명령어
이 문서는 OpenSpec의 슬래시 명령어에 대한 참조 자료입니다. 이 명령어들은 AI 코딩 어시스턴트의 채팅 인터페이스(예: Claude Code, Cursor, Devin Desktop)에서 호출됩니다.
워크플로우 패턴과 각 명령어의 사용 시기에 대해서는 워크플로우를 참조하십시오. CLI 명령어에 대해서는 CLI를 참조하십시오.
이 문서에서는 /opsx:<command>를 표준 이름으로 사용합니다. 일부 도구에서는 이를 다르게 표기합니다 — Cursor와 GitHub Copilot은 /opsx-propose로 등록하고, Codex는 $openspec-propose를 사용합니다 — 따라서 사용 중인 도구에 맞는 방법은 호출 방법을 확인하십시오. OpenSpec이 생성하는 파일들은 이미 올바른 형식을 사용합니다.
빠른 참조
기본 빠른 경로 (core 프로필)
| 명령어 | 목적 |
|---|---|
/opsx:propose | 변경 사항을 생성하고 계획 산출물을 한 단계로 생성 |
/opsx:explore | 변경 사항에 확정하기 전에 아이디어를 검토 |
/opsx:apply | 변경 사항의 작업을 구현 |
/opsx:update | 변경 사항의 계획 산출물을 수정하고 일관성 유지 |
/opsx:sync | 델타 스펙을 메인 스펙에 병합 |
/opsx:archive | 완료된 변경 사항을 아카이브 |
확장 워크플로우 명령어 (사용자 정의 워크플로우 선택)
| 명령어 | 목적 |
|---|---|
/opsx:new | 새로운 변경 사항 구조 시작 |
/opsx:continue | 의존성에 기반하여 다음 산출물 생성 |
/opsx:ff | 패스트 포워드: 모든 계획 산출물을 한 번에 생성 |
/opsx:verify | 구현이 산출물과 일치하는지 검증 |
/opsx:bulk-archive | 여러 변경 사항을 한 번에 아카이브 |
/opsx:onboard | 전체 워크플로우에 대한 안내 튜토리얼 |
기본 글로벌 프로필은 core입니다. 확장 워크플로우 명령어를 활성화하려면 openspec config profile을 실행하여 워크플로우를 선택한 후 프로젝트에서 openspec update를 실행하십시오.
명령어 참조
/opsx:propose
새로운 변경사항을 생성하고 계획 산출물을 한 단계에서 생성합니다. 이는 core 프로필의 기본 시작 명령어입니다.
구문:
/opsx:propose [change-name-or-description]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name-or-description | 아니요 | Kebab-case 이름 또는 일반 언어로 작성한 변경사항 설명 |
동작 내용:
openspec/changes/<change-name>/생성- 구현 전에 필요한 산출물 생성 (
spec-driven의 경우: proposal, specs, design, tasks) - 변경사항이
/opsx:apply에 준비되면 중단
예시:
You: /opsx:propose add-dark-mode
AI: Created openspec/changes/add-dark-mode/
✓ proposal.md
✓ specs/ui/spec.md
✓ design.md
✓ tasks.md
Ready for implementation. Run /opsx:apply.팁:
- 가장 빠른 끝에서 끝까지 경로를 위해 사용하세요
- 단계별 산출물 제어가 필요하면 확장 워크플로 활성화 후
/opsx:new+/opsx:continue를 사용하세요
/opsx:explore
불확실할 때 여기서 시작하세요. Explore는 무위험 사고 파트너입니다: 코드베이스를 읽고, 옵션을 비교하고, 변경사항이 존재하기 전에 모호한 아이디어를 구체적인 계획으로 다듬습니다. 기본 프로필에 포함됩니다. 전체 사례와 추가 예시는 Explore First 가이드를 참조하세요.
변경사항을 확정하기 전에 아이디어를 검토하고, 문제를 조사하고, 요구사항을 명확히 합니다.
구문:
/opsx:explore [topic]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
topic | 아니요 | 탐색하거나 조사하려는 주제 |
동작 내용:
- 구조 없이 탐색적 대화 시작
- 코드베이스를 조사하여 질문에 답변
- 옵션과 접근 방식 비교
- 사고를 명확히 하기 위한 시각적 다이어그램 생성
- 인사이트가 구체화되면
/opsx:propose(기본) 또는/opsx:new(확장 워크플로)로 전환 가능
예시:
You: /opsx:explore
AI: What would you like to explore?
You: How should we handle authentication for the mobile app?
AI: Let me investigate your current auth setup...
[Analyzes codebase]
I see you're using session-based auth for the web app.
For mobile, we have three main options:
1. JWT tokens (stateless, works offline)
2. OAuth2 (if you need third-party login)
3. Extend current sessions (simpler, but requires connectivity)
Your API already has CORS configured. Which direction interests you?
You: Let's go with JWT. Can we start a change for that?
AI: Ready when you are. Run /opsx:propose add-jwt-auth to begin.팁:
- 요구사항이 불분명하거나 조사가 필요할 때 사용하세요
- 탐색 중에는 산출물이 생성되지 않습니다
- 결정 전에 여러 접근 방식을 비교하는 데 적합합니다
- 파일을 읽고 코드베이스를 검색할 수 있습니다
/opsx:new
새로운 변경사항 스캐폴드를 시작합니다. 변경사항 폴더를 생성하고 /opsx:continue 또는 /opsx:ff로 산출물을 생성할 때까지 대기합니다.
이 명령어는 확장 워크플로 세트의 일부입니다(기본 core 프로필에 포함되지 않음).
구문:
/opsx:new [change-name] [--schema <schema-name>]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 변경사항 폴더 이름(제공하지 않으면 프롬프트 표시) |
--schema | 아니요 | 사용할 워크플로 스키마(기본값: config 또는 spec-driven에서 가져옴) |
동작 내용:
openspec/changes/<change-name>/디렉터리 생성- 변경사항 폴더에
.openspec.yaml메타데이터 파일 생성 - 생성 준비가 된 첫 번째 산출물 템플릿 표시
- 제공되지 않으면 변경사항 이름과 스키마에 대해 프롬프트 표시
생성되는 내용:
openspec/changes/<change-name>/
└── .openspec.yaml # Change metadata (schema, created date)예시:
You: /opsx:new add-dark-mode
AI: Created openspec/changes/add-dark-mode/
Schema: spec-driven
Ready to create: proposal
Use /opsx:continue to create it, or /opsx:ff to create all artifacts.팁:
- 설명적인 이름을 사용하세요:
add-feature,fix-bug,refactor-module update,changes,wip와 같은 일반적인 이름은 피하세요- 스키마는 프로젝트 설정(
openspec/config.yaml)에서도 설정할 수 있습니다
/opsx:continue
의존성 체인에서 다음 산출물을 생성합니다. 점진적 진행을 위해 한 번에 하나씩 산출물을 생성합니다.
구문:
/opsx:continue [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 계속할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
- 산출물 의존성 그래프 조회
- 준비된 산출물과 차단된 산출물 표시
- 준비된 첫 번째 산출물 생성
- 컨텍스트를 위해 의존성 파일 읽기
- 생성 후 사용 가능해지는 항목 표시
예시:
You: /opsx:continue
AI: Change: add-dark-mode
Artifact status:
✓ proposal (done)
◆ specs (ready)
◆ design (ready)
○ tasks (blocked - needs: specs, design)
Creating specs...
[Reads proposal.md, creates specs based on requirements]
✓ Created openspec/changes/add-dark-mode/specs/ui/spec.md
Now available: design
Run /opsx:continue to create the next artifact.팁:
- 진행 전에 각 산출물을 검토하고 싶을 때 사용하세요
- 제어가 필요한 복잡한 변경사항에 적합합니다
- 여러 산출물이 동시에 준비될 수 있습니다
- 계속하기 전에 생성된 산출물을 수정할 수 있습니다
/opsx:ff
산출물 생성을 패스트포워드합니다. 모든 계획 산출물을 한 번에 생성합니다.
구문:
/opsx:ff [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 패스트포워드할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
- 의존성 순서대로 모든 산출물 생성
- 할 일 목록을 통해 진행 상황 추적
- 모든
apply-required산출물이 완료되면 중단 - 다음 산출물을 생성하기 전에 각 의존성 읽기
예시:
You: /opsx:ff add-dark-mode
AI: Fast-forwarding add-dark-mode...
✓ Creating proposal.md
✓ Creating specs/ui/spec.md
✓ Creating design.md
✓ Creating tasks.md
All planning artifacts complete!
Ready for implementation. Run /opsx:apply to begin.팁:
- 무엇을 만들지 명확히 파악했을 때 사용하세요
- 단순한 변경사항에
/opsx:continue보다 빠릅니다 - 이후에도 산출물을 수정할 수 있습니다 -小到中형 기능에 적합합니다
/opsx:apply
변경사항의 작업을 구현합니다. 작업 목록을 처리하면서 코드를 작성하고 항목을 체크합니다.
구문:
/opsx:apply [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 구현할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
tasks.md를 읽고 미완료 작업 식별- 작업을 하나씩 처리
- 필요에 따라 코드 작성, 파일 생성, 테스트 실행
- 체크박스
[x]로 작업 완료 표시
예시:
You: /opsx:apply
AI: Implementing add-dark-mode...
Reading tasks.md:
- [ ] 1.1 Create ThemeContext
- [ ] 1.2 Add CSS custom properties
- [ ] 1.3 Implement localStorage persistence
Working on 1.1: Create ThemeContext...
[Creates src/context/ThemeContext.tsx]
✓ 1.1 Complete
Working on 1.2: Add CSS custom properties...
[Updates src/styles/globals.css]
✓ 1.2 Complete
...팁:
- 중단된 경우 중단된 위치에서 재개할 수 있습니다
- 변경사항 이름을 지정하여 병렬 변경사항에 사용하세요
- 완료 상태는
tasks.md체크박스에 추적됩니다
/opsx:update
변경사항의 기존 계획 산출물을 수정하고 상호 일관성을 유지합니다. 계획 산출물만 처리하며 코드는 절대 수정하지 않습니다.
구문:
/opsx:update [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 업데이트할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
openspec status --change <name> --json을 통해 변경사항의 산출물 읽기- 요청한 수정 사항을 적용하거나, 특정 수정 사항을 지정하지 않으면 산출물에서 모순을 검토
- 다른 기존 산출물을 양방향으로 조정(디자인 수정이 proposal로 역파급될 수 있음)
- 작성 전에 산출물 하나씩 사용자와 모든 수정 사항을 확인
- 다음 단계 권장으로 종료:
/opsx:continue(산출물 누락),/opsx:apply(수정된 계획을 코드로 반영), 또는/opsx:archive(모두 완료)
예시:
You: /opsx:update add-dark-mode - we're storing the theme in a cookie now, not localStorage
AI: Reading add-dark-mode artifacts...
The design references localStorage in two places; tasks 1.3 covers
localStorage persistence; the proposal doesn't mention storage.
Proposed revisions:
1. design.md - swap localStorage decision for cookie storage
2. tasks.md - reword task 1.3 to cookie persistence
Apply revision 1? (design.md)팁:
- 누락된 산출물을 생성하지 않습니다 - 그것은
/opsx:continue의 역할입니다 - 변경사항이 이미 구현된 경우, 코드가 수정된 계획과 일치하도록
/opsx:apply를 후속 실행하세요 - 수정 사항이 변경사항의 의도를 변경하는 경우, 대신 새로운 변경사항으로 새로 시작하세요 (업데이트 시점 vs. 새로 시작 시점 참조)
/opsx:verify
구현이 변경사항 산출물과 일치하는지 검증합니다. 완전성, 정확성, 일관성을 확인합니다.
구문:
/opsx:verify [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 검증할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
- 구현 품질의 세 가지 차원 확인
- 구현 증거를 위해 코드베이스 검색
- CRITICAL, WARNING, SUGGESTION으로 분류된 문제 보고
- 아카이브를 차단하지 않지만 문제를 표면화합니다
검증 차원:
| 차원 | 검증 내용 |
|---|---|
| 완전성 | 모든 작업 완료, 모든 요구사항 구현, 시나리오 커버 |
| 정확성 | 구현이 스펙 의도와 일치, 엣지 케이스 처리 |
| 일관성 | 디자인 결정이 코드에 반영, 패턴 일관성 |
예시:
You: /opsx:verify
AI: Verifying add-dark-mode...
COMPLETENESS
✓ All 8 tasks in tasks.md are checked
✓ All requirements in specs have corresponding code
⚠ Scenario "System preference detection" has no test coverage
CORRECTNESS
✓ Implementation matches spec intent
✓ Edge cases from scenarios are handled
✓ Error states match spec definitions
COHERENCE
✓ Design decisions reflected in code structure
✓ Naming conventions consistent with design.md
⚠ Design mentions "CSS variables" but implementation uses Tailwind classes
SUMMARY
─────────────────────────────
Critical issues: 0
Warnings: 2
Ready to archive: Yes (with warnings)
Recommendations:
1. Add test for system preference detection
2. Update design.md to reflect Tailwind usage, or refactor to use CSS variables팁:
- 아카이브 전에 실행하여 불일치를 조기에 발견하세요
- 경고는 아카이브를 차단하지 않지만 잠재적 문제를 나타냅니다
- 커밋 전에 AI의 작업을 검토하는 데 적합합니다
- 산출물과 구현 사이의 드리프트를 드러낼 수 있습니다
/opsx:sync
선택 명령어. 변경사항의 델타 스펙을 메인 스펙에 병합합니다. 아카이브 시 필요하면 동기화를 프롬프트하므로 일반적으로 수동 실행이 필요하지 않습니다.
구문:
/opsx:sync [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 동기화할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
- 변경사항 폴더에서 델타 스펙 읽기
- ADDED/MODIFIED/REMOVED/RENAMED 섹션 파싱
- 변경사항을 메인
openspec/specs/디렉터리에 병합 - 델타에 언급되지 않은 기존 콘텐츠 보존
- 변경사항을 아카이브하지 않음(활성 상태로 유지)
예시:
You: /opsx:sync
AI: Syncing add-dark-mode delta specs...
Reading: openspec/changes/add-dark-mode/specs/ui/spec.md
Target: openspec/specs/ui/spec.md
Changes to apply:
✓ ADDED: Theme Selection requirement (2 scenarios)
✓ ADDED: Accessibility requirement (1 scenario)
Merging...
✓ openspec/specs/ui/spec.md updated
Change remains active. Run /opsx:archive when ready to complete.수동 사용 시점:
| 시나리오 | 동기화 사용? |
|---|---|
| 장기 변경사항, 아카이브 전에 메인에 스펙을 넣고 싶을 때 | 예 |
| 여러 병렬 변경사항이 업데이트된 기본 스펙이 필요할 때 | 예 |
| 병합을 별도로 미리 보기/검토하고 싶을 때 | 예 |
| 빠른 변경사항, 바로 아카이브로 진행할 때 | 아니요(아카이브가 처리) |
팁:
- 동기화는 지능적이며 단순 복사-붙여넣기가 아닙니다
- 기존 요구사항에 시나리오를 중복 없이 추가할 수 있습니다
- 동기화 후에도 변경사항은 활성 상태로 유지됩니다(아카이브되지 않음)
- 대부분의 사용자는 이 명령어를 직접 호출할 필요가 없습니다—필요하면 아카이브가 프롬프트합니다
/opsx:archive
완료된 변경사항을 아카이브합니다. 변경사항을 최종화하고 아카이브 폴더로 이동합니다.
구문:
/opsx:archive [change-name]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-name | 아니요 | 아카이브할 변경사항(제공하지 않으면 컨텍스트에서 추론) |
동작 내용:
- 산출물 완료 상태 확인
- 작업 완료 확인(미완료 시 경고)
- 아직 동기화되지 않은 경우 델타 스펙 동기화 제안
- 변경사항 폴더를
openspec/changes/archive/YYYY-MM-DD-<name>/로 이동 - 감사 추적을 위해 모든 산출물 보존
예시:
You: /opsx:archive
AI: Archiving add-dark-mode...
Artifact status:
✓ proposal.md exists
✓ specs/ exists
✓ design.md exists
✓ tasks.md exists (8/8 tasks complete)
Delta specs: Not yet synced
→ Sync now? (recommended)
You: Yes
AI: ✓ Synced specs to openspec/specs/ui/spec.md
✓ Moved to openspec/changes/archive/2025-01-24-add-dark-mode/
Change archived successfully.팁:
- 미완료 작업이 있어도 아카이브를 차단하지 않지만 경고합니다
- 델타 스펙은 아카이브 중 또는 이전에 동기화할 수 있습니다
- 아카이브된 변경사항은 역사 기록으로 보존됩니다
- 문제를 발견하려면 먼저
/opsx:verify를 사용하세요
/opsx:bulk-archive
여러 완료된 변경사항을 한 번에 아카이브합니다. 변경사항 간의 스펙 충돌을 처리합니다.
구문:
/opsx:bulk-archive [change-names...]인수:
| 인수 | 필수 | 설명 |
|---|---|---|
change-names | 아니요 | 아카이브할 특정 변경사항(제공하지 않으면 선택 프롬프트 표시) |
동작 내용:
- 모든 완료된 변경사항 목록 표시
- 아카이브 전에 각 변경사항 검증
- 변경사항 간 스펙 충돌 감지
- 실제로 구현된 내용을 확인하여 충돌 해결
- 시간 순서대로 아카이브
예시:
You: /opsx:bulk-archive
AI: Found 3 completed changes:
- add-dark-mode (8/8 tasks complete)
- fix-login-bug (3/3 tasks complete)
- update-footer (2/2 tasks complete)
Checking for spec conflicts...
⚠ add-dark-mode and update-footer both touch specs/ui/
Inspecting codebase to resolve...
Both changes are implemented. Will merge in chronological order:
1. add-dark-mode (created Jan 20)
2. update-footer (created Jan 22)
Archive all 3 changes?
You: Yes
AI: ✓ Archived add-dark-mode
✓ Archived fix-login-bug
✓ Archived update-footer
Specs merged: add-dark-mode → update-footer팁:
- 병렬 작업 스트림에 적합합니다
- 충돌 해결은 에이전틱 방식입니다(코드베이스 확인)
- 변경사항은 생성 순서대로 아카이브됩니다
- 스펙 콘텐츠를 덮어쓰기 전에 프롬프트합니다
/opsx:onboard
완전한 OpenSpec 워크플로를 안내하는 온보딩입니다. 실제 코드베이스를 사용하는 인터랙티브 튜토리얼입니다.
구문:
/opsx:onboard동작 내용:
- 내레이션과 함께 완전한 워크플로 사이클 안내
- 실제 개선 기회를 위해 코드베이스 스캔
- 실제 산출물을 가진 실제 변경사항 생성
- 실제 작업 구현(작고 안전한 변경사항)
- 완료된 변경사항 아카이브
- 각 단계를 진행하면서 설명
단계:
- 환영 및 코드베이스 분석
- 개선 기회 탐색
- 변경사항 생성 (
/opsx:new) - 제안서 작성
- 스펙 생성
- 디자인 작성
- 작업 생성
- 작업 구현 (
/opsx:apply) - 구현 검증
- 변경사항 아카이브
- 요약 및 다음 단계
예시:
You: /opsx:onboard
AI: Welcome to OpenSpec!
I'll walk you through the complete workflow using your actual codebase.
We'll find something small to improve, create a proper change for it,
implement it, and archive it.
Let me scan your codebase for opportunities...
[Analyzes codebase]
I found a few things we could work on:
1. Add input validation to the contact form
2. Improve error messages in the auth flow
3. Add loading states to async buttons
Which interests you? (or suggest something else)팁:
- 워크플로를 배우는 신규 사용자에게 가장 적합합니다
- 장난감 예시가 아닌 실제 코드를 사용합니다
- 유지하거나 폐기할 수 있는 실제 변경사항을 생성합니다
- 완료에 15~30분이 소요됩니다
AI 도구별 명령 구문
AI 도구마다 명령 구문이 약간씩 다릅니다. 사용 중인 도구에 맞는 형식을 사용하세요:
| 도구의 명령 파일 | 구문 예시 | 도구 예시 |
|---|---|---|
.../commands/opsx/<id>.* | /opsx:propose, /opsx:apply | Claude Code, Gemini CLI, Crush |
.../opsx-<id>.* | /opsx-propose, /opsx-apply | Cursor, Devin Desktop, Copilot (IDE), Trae, Oh My Pi |
| 없음 — 스킬만 사용 | /openspec-propose, /openspec-apply-change | CodeArts, ForgeCode, Hermes, MiniMax Code, Mistral Vibe, Zed Agent, 공유 .agents |
| 없음 — Kimi Code | /skill:openspec-propose | Kimi Code |
| 없음 — Codex CLI | $openspec-propose | Codex |
Devin Desktop vs Devin Local:
.devin/workflows/opsx-*.md파일은 Devin Desktop에/opsx-propose를 제공합니다. Devin Local에는 워크플로가 없습니다 — OpenSpec이.devin/skills/에 작성하는 스킬(예:/openspec-propose)을 사용하세요. 이는 두 에이전트 모두에서 작동합니다.
의도는 모든 도구에서 동일하지만, 명령이 표시되는 방식은 통합 방식에 따라 다를 수 있습니다. 호출 방법은 지원되는 모든 도구를 나열합니다. 이 표는 각 형식의 예시만 보여줍니다.
참고: GitHub Copilot 명령(
.github/prompts/*.prompt.md)은 IDE 확장(VS Code, JetBrains, Visual Studio)에서만 사용할 수 있습니다. GitHub Copilot CLI는 현재 사용자 정의 프롬프트 파일을 지원하지 않습니다 — 자세한 내용과 해결 방법은 지원 도구를 참조하세요.
레거시 명령
이 명령들은 이전의 "한 번에 모두 처리" 워크플로를 사용합니다. 여전히 작동하지만 OPSX 명령이 권장됩니다.
| 명령 | 기능 |
|---|---|
/openspec:proposal | 모든 산출물을 한 번에 생성 (제안, 스펙, 설계, 작업) |
/openspec:apply | 변경 사항 구현 |
/openspec:archive | 변경 사항 보관 |
레거시 명령을 사용해야 하는 경우:
- 기존 프로젝트가 이전 워크플로를 사용하는 경우
- 점진적 산출물 생성이 필요 없는 간단한 변경
- 전체 또는 전무(all-or-nothing) 방식을 선호하는 경우
OPSX로 마이그레이션: 레거시 변경 사항은 OPSX 명령으로 계속 진행할 수 있습니다. 산출물 구조는 호환됩니다.
문제 해결
"변경 사항을 찾을 수 없음"
명령이 작업할 변경 사항을 식별하지 못했습니다.
해결 방법:
- 변경 이름을 명시적으로 지정:
/opsx:apply add-dark-mode - 변경 폴더가 존재하는지 확인:
openspec list - 올바른 프로젝트 디렉터리에 있는지 확인
"준비된 산출물 없음"
모든 산출물이 완료되었거나 누락된 종속성으로 인해 차단되었습니다.
해결 방법:
openspec status --change <name>을 실행하여 차단 원인 확인- 필수 산출물이 존재하는지 확인
- 누락된 종속 산출물을 먼저 생성
"스키마를 찾을 수 없음"
지정된 스키마가 존재하지 않습니다.
해결 방법:
- 사용 가능한 스키마 나열:
openspec schemas - 스키마 이름의 철자 확인
- 사용자 정의 스키마인 경우 생성:
openspec schema init <name>
명령이 인식되지 않음
AI 도구가 OpenSpec 명령을 인식하지 못합니다.
해결 방법:
- OpenSpec이 초기화되었는지 확인:
openspec init - 스킬 재생성:
openspec update .claude/skills/디렉터리가 존재하는지 확인 (Claude Code의 경우)- AI 도구를 다시 시작하여 새 스킬을 로드
산출물이 제대로 생성되지 않음
AI가 불완전하거나 잘못된 산출물을 생성합니다.
해결 방법:
openspec/config.yaml에 프로젝트 컨텍스트 추가- 특정 지침을 위해 산출물별 규칙 추가
- 변경 설명에 더 많은 세부 정보 제공
- 더 많은 제어를 위해
/opsx:ff대신/opsx:continue사용