@qualisoft/ai-skills 1.1.0 → 1.4.0

package/skills/project-init/templates/script/_purpose.md

@@ -0,0 +1,29 @@
+## 목적을 맨 앞에 — 이게 가장 중요합니다
+
+받는 사람은 이 파일을 **처음 봅니다.** 제목만 보고는 무슨 문서인지, 무엇을
+확인해야 하는지 모릅니다. 그래서 본문에 들어가기 전에 **목적 블록**을 넣습니다.
+
+### 목적 블록에 담을 것
+
+1. **이 문서가 답하는 질문** — 한 문장. 전문용어 없이.
+   > "이번 사업에서 무엇을 어디까지 만들고, 언제 무엇을 납품하는가"
+
+2. **핵심 수치 3~4개** — 원본에서 **세어서** 뽑습니다. 지어내지 않습니다.
+   표의 행 수, 완료·진행·미착수 건수, 시작·종료일, 마일스톤 수 같은 것.
+   숫자를 크게, 이름표를 작게 두어 한눈에 들어오게 합니다.
+
+3. **받는 분이 할 일** — 한 줄.
+   > "굵게 표시된 5개 항목을 확인해 주시면 다음 단계로 넘어갑니다"
+
+### 그 다음 순서
+
+목적 블록 → **가장 중요한 표 하나** → 나머지 상세.
+
+원본의 섹션 순서를 그대로 따르지 마세요. 원본은 우리가 쓰기 좋은 순서이고,
+산출물은 **받는 사람이 읽기 좋은 순서**여야 합니다. 결론과 전체 그림이 앞에
+오고, 근거와 세부가 뒤에 옵니다.
+
+### 한 화면에 하나만
+
+한 시트·한 쪽·한 슬라이드는 **한 가지만** 말합니다. 표 두 개를 나란히 놓아
+무엇을 봐야 할지 헷갈리게 하지 마세요.

package/skills/project-init/templates/script/_scope.md

@@ -0,0 +1,35 @@
+## 무엇을 담고 무엇을 뺄 것인가
+
+이 산출물은 **고객사에 송부됩니다.** 원본 문서는 우리 작업용이라 고객이 볼 필요가
+없는 것이 섞여 있습니다. 아래를 반드시 걸러내세요.
+
+### 빼야 하는 것
+
+| 대상 | 이유 |
+| --- | --- |
+| 프론트매터 전체 (`id`, `status`, `template`, `updated` 등) | 내부 관리용 |
+| **담당자 이메일·계정** | 개인정보. 이름과 역할만 남깁니다 |
+| `## 미결정` 섹션 | 우리 내부의 열린 항목 |
+| `## 변경 이력` 섹션 | 내부 작업 이력 |
+| `[[문서-id]]` 링크 표기 | 링크는 벗기고 문서 이름만 남깁니다 |
+| 추적 ID (`R-01`, `B-01`, `D-001`) | 표의 한 칸을 차지할 뿐 고객에게 뜻이 없습니다. **단, 표 안에서 항목을 가리키는 열이면 남깁니다** |
+| 원본 파일명·경로 | 내부 구조 노출 |
+| 작성 지침 인용문 | `>` 로 시작하고 "~한다", "~적는다" 로 끝나는 템플릿 안내문. 우리에게 주는 지시이지 내용이 아닙니다 |
+| 빈 표·빈 섹션 | 내용이 없으면 그 섹션 자체를 빼세요 |
+
+### `TODO(...)` 처리 — 지우지 말고 드러내세요
+
+본문에서는 `협의 중` 으로 바꿔 씁니다. **없는 척하지 않습니다.**
+그리고 **마지막에 `고객 확인 필요 항목` 을 따로 만들어** 무엇이 미정인지 모아
+보여주세요. 항목이 없으면 이 부분은 넣지 않습니다.
+
+### 지어내지 마세요
+
+빠진 칸을 메우려고 숫자·일정·담당자·수치를 만들지 않습니다.
+비어 있으면 `협의 중` 이고, 그게 정직한 상태입니다.
+
+### 다 만든 뒤 보고할 것
+
+- 뺀 항목: 무엇을 몇 개 걸러냈는지
+- `협의 중` 으로 표시한 개수
+- 원본의 절 제목 개수와 산출물에 들어간 개수

package/skills/project-init/templates/script/_style.md

@@ -0,0 +1,47 @@
+## 산출물 공통 서식 규격
+
+**이 규격은 고정입니다.** 프로젝트 초기에 만들든 중간에 만들든, 누가 어떤 도구로
+만들든 **같은 값을 써서 같은 모양이 나와야 합니다.** 아래 값을 임의로 바꾸지 마세요.
+
+### 색
+
+| 쓰임 | 값 |
+| --- | --- |
+| 본문 글자 | `#1C1B19` |
+| 보조 글자 (메타·주석) | `#6B6862` |
+| 선·테두리 | `#E4E2DD` |
+| 강조 (제목 앞 막대, 링크) | `#2383E2` |
+| 표 짝수행·코드 배경 | `#FAFAF8` |
+| 표 머리행 배경 | `#1C1B19` (글자는 흰색) |
+
+**색은 이 여섯 개가 전부입니다.** 경고나 상태 표시가 꼭 필요하면 `#C0392B`(위험),
+`#0F7B6C`(완료) 두 개만 더 씁니다.
+
+### 글자
+
+- 한글 본문은 산세리프: `맑은 고딕` → `Apple SD Gothic Neo` → 시스템 기본 순서로 대체
+- 코드·경로·ID 는 고정폭
+- 크기 위계는 **네 단계만**: 제목 / 절 제목 / 소제목 / 본문
+- 본문 줄간격은 1.5~1.65. 빽빽하게 붙이지 않습니다
+
+### 표
+
+- 머리행은 먹 배경에 흰 글자, 굵게
+- 짝수 데이터행에 `#FAFAF8` 음영 (얼룩무늬)
+- 테두리는 가로선 위주로 얇게. 격자를 꽉 채우지 않습니다
+- 셀 안쪽 여백을 넉넉히 (상하 6pt 이상)
+- 머리행은 페이지·슬라이드가 넘어가도 반복
+
+### 여백
+
+- 바깥 여백을 넉넉히 둡니다. 가장자리까지 채우지 않습니다
+- 절과 절 사이는 본문 간격의 두 배 이상
+
+### 하지 말 것
+
+- 무지개색·그라디언트·네온
+- 그림자, 3D, 워드아트, 반사 효과
+- 장식용 아이콘·클립아트·이모지
+- 본문 기울임체 (한글에서 읽기 나쁩니다)
+- 가운데 정렬 본문 (제목만 필요하면 씁니다)
+- 원본에 없는 내용을 지어내기

package/skills/project-init/templates/script/csv.md

@@ -0,0 +1,36 @@
+# 산출물 생성 지시 — CSV
+
+`__PROJECT__` 프로젝트의 **`__DOC_TITLE__`** 을 CSV 로 만들어 주세요.
+
+CSV 는 **데이터를 넘기는 형식**입니다. 목적 설명이나 서식이 들어가지 않으므로,
+고객이 표를 바로 쓸 수 있게 만드는 것에 집중합니다.
+
+## 원본
+
+`__DOC_FILE__` — **이 파일을 먼저 읽고**, 그 내용만으로 만듭니다.
+
+## 결과물
+
+원본의 표를 하나씩 파일로 떨어뜨립니다. **파일명은 내용을 말하게** 지으세요 —
+`__DOC_STEM___구축범위.csv` 처럼. `표1.csv` 같은 이름은 쓰지 마세요.
+
+본문 설명은 CSV 로 만들지 않습니다. 설명이 필요하면 PDF·엑셀을 쓰세요.
+
+__SCOPE__
+
+## 인코딩 — 이것만은 반드시
+
+**UTF-8 with BOM(`utf-8-sig`) 으로 저장합니다.** BOM 이 없으면 엑셀에서 열 때
+한글이 깨집니다. CSV 산출물에서 가장 자주 나는 사고입니다.
+
+줄바꿈은 `\r\n`. 값에 쉼표·따옴표·줄바꿈이 있으면 큰따옴표로 감싸고 내부 따옴표는
+두 번 씁니다 (표준 CSV 규칙).
+
+## 표 형식
+
+- 머리행이 **비어 있거나 중복되면 이름을 붙여 고칩니다** (`항목`, `구분 2`)
+- 행 순서를 바꾸지 마세요. 원본 순서가 곧 의미입니다
+- 칸 수가 행마다 다르면 가장 넓은 행에 맞춰 빈 칸으로 채웁니다
+- 마크다운 기호(`**`, 백틱, `[[링크]]`)는 벗겨내고 글자만 남깁니다
+
+만든 뒤 파일 목록과 각 파일의 행 수를 알려주세요.

package/skills/project-init/templates/script/docx.md

@@ -0,0 +1,35 @@
+# 산출물 생성 지시 — 워드 (DOCX)
+
+`__PROJECT__` 프로젝트의 **`__DOC_TITLE__`** 을 고객 송부용 워드로 만들어 주세요.
+
+## 원본
+
+`__DOC_FILE__` — **이 파일을 먼저 읽고**, 그 내용만으로 만듭니다.
+읽을 수 없으면 만들지 말고 파일을 달라고 요청하세요.
+
+## 결과물
+
+`__DOC_STEM__.docx` — A4 세로, 위아래 2.2cm, 좌우 2.4cm
+
+__SHAPE__
+
+__PURPOSE__
+
+__SCOPE__
+
+__STYLE__
+
+## 워드 구성
+
+1. **첫 쪽에 목적 블록.** 제목 22pt 굵게 → 답하는 질문 → 핵심 수치를 1행 표로
+   가로 나열(테두리 없이, 숫자 24pt 굵게 + 이름표 9pt) → 받는 분이 할 일.
+   그 뒤 쪽 나누기.
+2. **머리글 스타일(제목 1/2/3)을 실제로 적용**해서 탐색 창과 목차가 동작하게
+   합니다. 글자 크기만 키우지 마세요.
+3. 본문 10pt, 줄간격 1.5, 문단 뒤 6pt.
+4. 표는 `Table Grid` 기반에 공통 규격 음영. 머리행 반복 속성을 켜세요.
+5. 한글 서체를 **동아시아 글꼴 속성에도 함께 지정**합니다. 빠뜨리면 한글만 다른
+   서체로 보입니다.
+6. 목차는 넣지 않습니다. 필요하면 따로 요청합니다.
+
+만든 뒤 적용한 머리글 수준별 개수를 알려주세요.

package/skills/project-init/templates/script/excel.md

@@ -0,0 +1,62 @@
+# 산출물 생성 지시 — 엑셀 (XLSX)
+
+`__PROJECT__` 프로젝트의 **`__DOC_TITLE__`** 을 고객 송부용 엑셀로 만들어 주세요.
+
+## 원본
+
+`__DOC_FILE__` — **이 파일을 먼저 읽고**, 그 내용만으로 만듭니다.
+읽을 수 없으면 만들지 말고 파일을 달라고 요청하세요.
+
+## 결과물
+
+`__DOC_STEM__.xlsx`
+
+__SHAPE__
+
+__PURPOSE__
+
+__SCOPE__
+
+__STYLE__
+
+## 시트 구성
+
+1. **첫 시트 `요약`** — 목적 블록이 여기 들어갑니다.
+   - B2 에 문서 제목 20pt 굵게
+   - 그 아래 답하는 질문 한 줄 11pt
+   - 그 아래 핵심 수치를 **가로로 나열**: 각 칸에 숫자 24pt 굵게, 그 아래 이름표
+     9pt 보조색. 칸 사이는 빈 열로 띄웁니다
+   - 맨 아래 "받는 분이 할 일" 한 줄
+2. **그 다음 시트부터 본표** — 시트 이름은 내용을 말하게 짓습니다.
+   `표1` `표2` 같은 이름을 쓰지 마세요. `구축범위`, `마일스톤`, `요구사항` 처럼.
+3. 시트가 다섯 개를 넘으면 성격이 가까운 표를 합치세요.
+4. **모든 시트에서 눈금선을 끕니다.** 틀 고정은 머리행 아래(A2).
+5. 수식을 넣지 않습니다. 값만 씁니다.
+
+## 표를 만들 때 — 파일 손상을 막는 규칙
+
+엑셀 **표 기능**(정렬·필터가 붙는 그것)을 쓸 때, 아래를 어기면 엑셀이 파일을 열며
+**"파일에 오류가 있습니다 — 복구했습니다"** 를 띄웁니다. 마크다운 표를 그대로
+옮기면 자주 걸립니다.
+
+| 규칙 | 안 지키면 |
+| --- | --- |
+| 머리행 셀이 **비어 있으면 안 됩니다** | 복구 발생. `항목`, `구분`, `값` 처럼 채우세요 |
+| 머리행 이름이 **중복되면 안 됩니다** | 복구 발생. `구분`, `구분 2` 로 구분하세요 |
+| 데이터 행이 **한 줄도 없으면** 표 기능을 적용하지 마세요 | 복구 발생. 머리행만 있으면 일반 셀로 두세요 |
+| 표 이름(`displayName`)은 영문·숫자·밑줄만, 공백 없이, 파일 안에서 유일하게 | 복구 발생 |
+| 표 범위(`ref`)가 실제 채운 칸과 정확히 같아야 합니다 | 복구 발생 |
+
+원본 표의 머리행이 비어 있거나 겹치면 **고쳐서 넣으세요.** 그대로 옮기는 것보다
+읽을 수 있는 이름을 붙이는 편이 낫습니다.
+
+만든 뒤 **파일을 다시 열어 경고가 없는지 확인**하고 결과를 알려주세요.
+
+## 표 내용
+
+- 행 순서를 바꾸지 마세요. 원본 순서가 곧 의미입니다
+- 칸 수가 행마다 다르면 가장 넓은 행에 맞춰 빈 칸으로 채웁니다
+- 열 너비는 내용에 맞춰 12~52 사이
+- 짝수 행 얼룩무늬, 머리행 먹 배경 흰 글자
+- 상태·구분처럼 값이 몇 가지로 정해진 열은 **글자 그대로** 두세요.
+  색 알약이나 아이콘으로 바꾸지 마세요

package/skills/project-init/templates/script/pdf.md

@@ -0,0 +1,42 @@
+# 산출물 생성 지시 — PDF
+
+`__PROJECT__` 프로젝트의 **`__DOC_TITLE__`** 을 고객 송부용 PDF로 만들어 주세요.
+
+## 원본
+
+`__DOC_FILE__` — **이 파일을 먼저 읽고**, 그 내용만으로 만듭니다.
+읽을 수 없으면 만들지 말고 파일을 달라고 요청하세요.
+
+## 결과물
+
+`__DOC_STEM__.pdf` — A4 세로, 바깥 여백 20mm
+
+__SHAPE__
+
+__PURPOSE__
+
+__SCOPE__
+
+__STYLE__
+
+## PDF 구성
+
+1. **1쪽은 목적 쪽입니다.** 제목, 답하는 질문, 핵심 수치, 받는 분이 할 일.
+   수치는 가로로 나란히 놓고 숫자 28pt 굵게, 이름표 9pt 보조색.
+   이 쪽에 본문을 섞지 마세요.
+2. **2쪽부터 본문.** 가장 중요한 표가 먼저 옵니다.
+3. 모든 쪽 상단에 머리말 — 왼쪽 문서 제목, 오른쪽 프로젝트명, 아래 얇은 구분선.
+   **문서 ID 를 머리말에 넣지 마세요** (내부 표기입니다).
+4. 모든 쪽 하단 가운데 `n / 전체` 쪽번호.
+5. 절 제목만 남고 내용이 다음 쪽으로 넘어가지 않게 합니다.
+6. 표가 한 쪽에 안 들어가면 **머리행을 반복하며** 나눕니다.
+7. 인용은 왼쪽에 강조색 세로 막대 + 보조 글자색. 단, `_scope.md` 에서 걸러내라고
+   한 작성 지침 인용문은 아예 빼세요.
+
+## 한글 폰트
+
+`reportlab` 을 쓴다면 내장 CID 폰트 `HYGothic-Medium` 을 등록해 쓰세요.
+폰트 파일을 따로 받지 않아도 되고 한글이 깨지지 않습니다.
+HTML→PDF 변환을 쓴다면 `맑은 고딕`·`Apple SD Gothic Neo` 대체 순서를 지정하세요.
+
+만든 뒤 **PDF 를 열어 한글이 깨지지 않았는지, 빈 쪽이 없는지** 확인하고 알려주세요.

package/skills/project-init/templates/script/pptx.md

@@ -0,0 +1,39 @@
+# 산출물 생성 지시 — 발표자료 (PPTX)
+
+`__PROJECT__` 프로젝트의 **`__DOC_TITLE__`** 을 고객 보고용 발표자료로 만들어 주세요.
+
+## 원본
+
+`__DOC_FILE__` — **이 파일을 먼저 읽고**, 그 내용만으로 만듭니다.
+읽을 수 없으면 만들지 말고 파일을 달라고 요청하세요.
+
+## 결과물
+
+`__DOC_STEM__.pptx` — 16:9 (13.333 × 7.5 inch)
+
+__SHAPE__
+
+__PURPOSE__
+
+__SCOPE__
+
+__STYLE__
+
+## 슬라이드 구성
+
+1. **1장 표지** — 왼쪽 끝에 강조색 세로 막대(폭 0.18in, 전체 높이).
+   제목 40pt 굵게, 아래 프로젝트명과 날짜 13pt 보조색.
+   **담당자 이메일·문서 ID·상태를 넣지 마세요.**
+2. **2장 한 장 요약** — 목적 블록입니다. 답하는 질문 한 줄 + 핵심 수치 가로 나열
+   (숫자 44pt 굵게, 이름표 11pt) + 받는 분이 할 일.
+   **이 한 장만 봐도 무슨 문서인지 알아야 합니다.**
+3. **3장부터 본문.** 가장 중요한 표·목록이 먼저.
+4. 한 슬라이드에 **불릿 6개, 표 12행**을 넘기지 않습니다. 넘치면 `(이어서)` 로
+   잇습니다. 글자를 줄여 억지로 맞추지 마세요.
+5. 본문 12pt 이상. **문장을 통째로 넣지 말고 구 단위로 끊습니다.**
+   단, 없는 말을 만들지는 마세요 — 자르기만 합니다.
+6. 애니메이션·화면전환·발표자 노트 없음.
+7. 마지막에 "감사합니다" 빈 장을 붙이지 마세요. 마지막 장은
+   `고객 확인 필요 항목` 이거나, 없으면 본문 마지막입니다.
+
+만든 뒤 슬라이드 수와, 글자가 도형 밖으로 넘친 곳이 없는지 확인해 알려주세요.