From d139eb46904eae58d2195bc36c11fdda48a142cb Mon Sep 17 00:00:00 2001 From: JK Date: Wed, 17 Jun 2026 22:01:01 +0900 Subject: [PATCH] =?UTF-8?q?skill:=20skill=20loader=EA=B0=80=20metadata?= =?UTF-8?q?=EB=A5=BC=20=EC=9D=B8=EC=8B=9D=ED=95=98=EB=8F=84=EB=A1=9D=20?= =?UTF-8?q?=ED=95=A9=EB=8B=88=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Codex skill loader가 repository skill을 건너뛰지 않도록 각 SKILL.md에 표준 YAML frontmatter를 추가합니다. Constraint: Codex skill loader는 SKILL.md 맨 앞의 --- delimited YAML frontmatter를 요구합니다. Rejected: skill 본문 재작성 | loader 경고 해결에 필요한 범위를 넘습니다. Confidence: high Scope-risk: narrow Directive: 새 repository skill 문서는 name과 description frontmatter를 먼저 작성합니다. Tested: node one-off skill frontmatter check Tested: git diff --check Not-tested: Codex 앱 재시작 후 loader 경고 재현 확인은 수행하지 않았습니다. --- .agents/skills/code-review/SKILL.md | 5 +++++ .agents/skills/commit/SKILL.md | 5 +++++ .agents/skills/confluence-mdx-testcase/SKILL.md | 7 ++++++- .agents/skills/confluence-mdx/SKILL.md | 5 +++++ .agents/skills/confluence-pr-update/SKILL.md | 5 +++++ .agents/skills/mdx-skeleton-comparison/SKILL.md | 5 +++++ .agents/skills/openspec-authoring/SKILL.md | 5 +++++ .agents/skills/openspec-doc-maintenance/SKILL.md | 5 +++++ .agents/skills/openspec-task-execution/SKILL.md | 5 +++++ .agents/skills/proofread/SKILL.md | 5 +++++ .agents/skills/reverse-sync-debugging/SKILL.md | 5 +++++ .agents/skills/reverse-sync/SKILL.md | 5 +++++ .agents/skills/sync-confluence-url/SKILL.md | 5 +++++ .agents/skills/sync-ko-to-en-ja/SKILL.md | 5 +++++ .agents/skills/translation/SKILL.md | 5 +++++ .agents/skills/xhtml-beautify-diff/SKILL.md | 5 +++++ 16 files changed, 81 insertions(+), 1 deletion(-) diff --git a/.agents/skills/code-review/SKILL.md b/.agents/skills/code-review/SKILL.md index 6fdd12a4f..97f307949 100644 --- a/.agents/skills/code-review/SKILL.md +++ b/.agents/skills/code-review/SKILL.md @@ -1,3 +1,8 @@ +--- +name: code-review +description: "querypie-docs 변경 사항을 검토하고 위험, 누락된 검증, 개선점을 찾을 때 사용합니다." +--- + # 코드 리뷰 가이드라인 ## 개요 diff --git a/.agents/skills/commit/SKILL.md b/.agents/skills/commit/SKILL.md index acc8db808..666f525d0 100644 --- a/.agents/skills/commit/SKILL.md +++ b/.agents/skills/commit/SKILL.md @@ -1,3 +1,8 @@ +--- +name: commit +description: "querypie-docs 커밋 메시지와 PR 제목 및 본문을 저장소 규칙에 맞게 작성할 때 사용합니다." +--- + # Commit Log 작성 Skill querypie-docs 저장소의 commit 관습에 맞게 commit message를 작성합니다. diff --git a/.agents/skills/confluence-mdx-testcase/SKILL.md b/.agents/skills/confluence-mdx-testcase/SKILL.md index 4d51430f0..a69d88d2e 100644 --- a/.agents/skills/confluence-mdx-testcase/SKILL.md +++ b/.agents/skills/confluence-mdx-testcase/SKILL.md @@ -1,3 +1,8 @@ +--- +name: confluence-mdx-testcase +description: "Confluence XHTML 변환 로직의 재현 테스트케이스를 추가하거나 갱신할 때 사용합니다." +--- + # Confluence XHTML 변환 테스트케이스 추가 가이드 ## 개요 @@ -96,4 +101,4 @@ testcases// 1. **설명적인 이름 사용**: 합성 테스트케이스는 테스트 목적을 설명하는 이름 사용 2. **최소한의 XHTML**: 테스트하려는 기능만 포함하는 간결한 XHTML 작성 3. **출력 검토**: `expected.mdx`로 저장하기 전에 `output.mdx`를 반드시 검토 -4. **회귀 테스트**: 버그 수정 시 해당 케이스를 테스트케이스로 추가 \ No newline at end of file +4. **회귀 테스트**: 버그 수정 시 해당 케이스를 테스트케이스로 추가 diff --git a/.agents/skills/confluence-mdx/SKILL.md b/.agents/skills/confluence-mdx/SKILL.md index 90e8eca49..038e8f930 100644 --- a/.agents/skills/confluence-mdx/SKILL.md +++ b/.agents/skills/confluence-mdx/SKILL.md @@ -1,3 +1,8 @@ +--- +name: confluence-mdx +description: "Confluence 문서를 QueryPie MDX 콘텐츠로 변환하거나 변환 결과를 검증할 때 사용합니다." +--- + # Confluence에서 MDX로 변환 가이드라인 ## 개요 diff --git a/.agents/skills/confluence-pr-update/SKILL.md b/.agents/skills/confluence-pr-update/SKILL.md index af26f5397..095e914d8 100644 --- a/.agents/skills/confluence-pr-update/SKILL.md +++ b/.agents/skills/confluence-pr-update/SKILL.md @@ -1,3 +1,8 @@ +--- +name: confluence-pr-update +description: "Confluence 자동 동기화 PR을 점검하고 누락 이미지, 번역, skeleton 검증을 처리할 때 사용합니다." +--- + # Confluence MDX PR 수정 가이드라인 ## 개요 diff --git a/.agents/skills/mdx-skeleton-comparison/SKILL.md b/.agents/skills/mdx-skeleton-comparison/SKILL.md index 7c8a7c841..e6137d6f0 100644 --- a/.agents/skills/mdx-skeleton-comparison/SKILL.md +++ b/.agents/skills/mdx-skeleton-comparison/SKILL.md @@ -1,3 +1,8 @@ +--- +name: mdx-skeleton-comparison +description: "한국어, 영어, 일본어 MDX 문서의 구조 일관성을 skeleton 비교로 검증할 때 사용합니다." +--- + # MDX 스켈레톤 비교 가이드라인 ## 개요 diff --git a/.agents/skills/openspec-authoring/SKILL.md b/.agents/skills/openspec-authoring/SKILL.md index 6f6854d0f..5d95a2d15 100644 --- a/.agents/skills/openspec-authoring/SKILL.md +++ b/.agents/skills/openspec-authoring/SKILL.md @@ -1,3 +1,8 @@ +--- +name: openspec-authoring +description: "QueryPie 문서 저장소의 OpenSpec spec, proposal, design, tasks를 새로 작성하거나 크게 갱신할 때 사용합니다." +--- + # OpenSpec Authoring QueryPie 문서 저장소에서 OpenSpec spec, proposal, design, tasks를 새로 작성하거나 크게 갱신할 때 사용합니다. diff --git a/.agents/skills/openspec-doc-maintenance/SKILL.md b/.agents/skills/openspec-doc-maintenance/SKILL.md index ee8b81df9..d7fd791a8 100644 --- a/.agents/skills/openspec-doc-maintenance/SKILL.md +++ b/.agents/skills/openspec-doc-maintenance/SKILL.md @@ -1,3 +1,8 @@ +--- +name: openspec-doc-maintenance +description: "구현, 리뷰, 계획, 디버깅 중 OpenSpec drift, 모순, 누락된 contract를 유지보수할 때 사용합니다." +--- + # OpenSpec 문서 유지보수 QueryPie 문서 저장소에서 구현, 리뷰, 계획, 디버깅 중 OpenSpec 문서와 실제 계약 사이의 차이를 발견했을 때 사용합니다. diff --git a/.agents/skills/openspec-task-execution/SKILL.md b/.agents/skills/openspec-task-execution/SKILL.md index cb1de1b2d..2b3581003 100644 --- a/.agents/skills/openspec-task-execution/SKILL.md +++ b/.agents/skills/openspec-task-execution/SKILL.md @@ -1,3 +1,8 @@ +--- +name: openspec-task-execution +description: "OpenSpec tasks.md의 남은 구현, 검증 보강, PR-sized 후속 작업을 수행할 때 사용합니다." +--- + # OpenSpec Task Execution QueryPie 문서 저장소에서 OpenSpec changes/specs에 남은 `tasks.md` 항목, 후속 구현, verification 보강, PR-sized 작업 수행을 요청받았을 때 사용합니다. diff --git a/.agents/skills/proofread/SKILL.md b/.agents/skills/proofread/SKILL.md index a1993cb6e..9d61accb2 100644 --- a/.agents/skills/proofread/SKILL.md +++ b/.agents/skills/proofread/SKILL.md @@ -1,3 +1,8 @@ +--- +name: proofread +description: "QueryPie 문서 콘텐츠를 교정하고 API 명칭, 표현, Markdown 형식을 점검할 때 사용합니다." +--- + # 문서 교정/교열 Skill Markdown으로 작성된 컨텐츠 문서를 교정, 교열합니다. diff --git a/.agents/skills/reverse-sync-debugging/SKILL.md b/.agents/skills/reverse-sync-debugging/SKILL.md index 4ec56e2f0..e9ea80db9 100644 --- a/.agents/skills/reverse-sync-debugging/SKILL.md +++ b/.agents/skills/reverse-sync-debugging/SKILL.md @@ -1,3 +1,8 @@ +--- +name: reverse-sync-debugging +description: "reverse-sync verify 실패 원인을 분석하고 MDX-to-XHTML 역반영 문제를 디버깅할 때 사용합니다." +--- + # Reverse Sync 디버깅 가이드 ## 개요 diff --git a/.agents/skills/reverse-sync/SKILL.md b/.agents/skills/reverse-sync/SKILL.md index 77b8a3c51..9f4e3e85e 100644 --- a/.agents/skills/reverse-sync/SKILL.md +++ b/.agents/skills/reverse-sync/SKILL.md @@ -1,3 +1,8 @@ +--- +name: reverse-sync +description: "MDX 변경을 Confluence XHTML로 역반영하는 reverse-sync 작업을 수행하거나 검증할 때 사용합니다." +--- + # Reverse Sync 사용 가이드 ## 개요 diff --git a/.agents/skills/sync-confluence-url/SKILL.md b/.agents/skills/sync-confluence-url/SKILL.md index 1cc1747a9..b3f3a74df 100644 --- a/.agents/skills/sync-confluence-url/SKILL.md +++ b/.agents/skills/sync-confluence-url/SKILL.md @@ -1,3 +1,8 @@ +--- +name: sync-confluence-url +description: "한국어 MDX의 confluenceUrl frontmatter를 영어와 일본어 문서에 동기화할 때 사용합니다." +--- + # sync_confluence_url 사용 가이드 ## 개요 diff --git a/.agents/skills/sync-ko-to-en-ja/SKILL.md b/.agents/skills/sync-ko-to-en-ja/SKILL.md index 03f88e4e9..062b45750 100644 --- a/.agents/skills/sync-ko-to-en-ja/SKILL.md +++ b/.agents/skills/sync-ko-to-en-ja/SKILL.md @@ -1,3 +1,8 @@ +--- +name: sync-ko-to-en-ja +description: "한국어 MDX 변경사항을 대응하는 영어와 일본어 문서에 번역 및 동기화할 때 사용합니다." +--- + # 한국어 MDX 변경사항을 영어/일본어에 동기화 ## 개요 diff --git a/.agents/skills/translation/SKILL.md b/.agents/skills/translation/SKILL.md index 45b038d35..baa89267b 100644 --- a/.agents/skills/translation/SKILL.md +++ b/.agents/skills/translation/SKILL.md @@ -1,3 +1,8 @@ +--- +name: translation +description: "한국어 QueryPie 문서를 영어 또는 일본어로 번역하고 다국어 콘텐츠 규칙을 적용할 때 사용합니다." +--- + # 번역 가이드라인 ## 개요 diff --git a/.agents/skills/xhtml-beautify-diff/SKILL.md b/.agents/skills/xhtml-beautify-diff/SKILL.md index 6b3ceda60..5f7ee8192 100644 --- a/.agents/skills/xhtml-beautify-diff/SKILL.md +++ b/.agents/skills/xhtml-beautify-diff/SKILL.md @@ -1,3 +1,8 @@ +--- +name: xhtml-beautify-diff +description: "Confluence XHTML 파일의 의미적 차이를 beautify diff로 비교하고 reverse-sync 결과를 분석할 때 사용합니다." +--- + # XHTML Beautify-Diff Viewer 사용 가이드 ## 개요