PPT 생성 고도화 3차를 반영하고 deck planning·quality gate를 추가

- DeckPlanningService와 DeckQualityReviewService를 추가해 deck brief 정규화, consulting storyline 보강, 누락된 Executive Summary/Recommendation/Roadmap/Appendix 자동 보강, deck-level 품질 점수와 경고 계산을 지원합니다. - PptxSkill에 audience/objective/decision_ask/storyline 파라미터를 추가하고, issue_tree/before_after/decision_matrix/risk_heatmap/benefit_waterfall/operating_model/appendix_evidence 레이아웃을 네이티브 슬라이드 타입으로 정규화한 뒤 planning summary와 quality summary를 함께 반환하도록 보강했습니다. - pptx-creator 및 strategy-deck/board-update/pmo-steering/sales-review-deck/operating-model-deck 번들 스킬을 추가·정리하고, DeckPlanningServiceTests/DeckQualityReviewServiceTests/PptxSkillAutoRepairTests로 회귀 검증을 보강했습니다. - README.md와 docs/DEVELOPMENT.md에 2026-04-14 21:50, 22:00 (KST) 기준 변경 이력과 검증 결과를 반영했습니다. - 검증: dotnet build src/AxCopilot/AxCopilot.csproj -c Release -v minimal -p:OutputPath=bin\verify_ppt_phase3\ -p:IntermediateOutputPath=obj\verify_ppt_phase3\ (경고 0 / 오류 0) - 검증: dotnet test src/AxCopilot.Tests/AxCopilot.Tests.csproj -c Release -v minimal --filter 'DeckPlanningServiceTests|DeckQualityReviewServiceTests|PptxSkillAutoRepairTests|PptxSkillConsultingDeckTests' -p:OutputPath=bin\verify_ppt_phase3_tests\ -p:IntermediateOutputPath=obj\verify_ppt_phase3_tests\ (통과 5)
2026-04-14 22:01:41 +09:00
parent 6c7fba9dff
commit 8571a83ed0
14 changed files with 1450 additions and 85 deletions
--- a/src/AxCopilot/skills/pptx-creator.skill.md
+++ b/src/AxCopilot/skills/pptx-creator.skill.md
@@ -1,10 +1,10 @@
 ---
 name: pptx-creator
-label: PPT 프레젠테이션 생성
-description: AX 기본 PPT 엔진으로 고급 제안서, 보고서, 발표 자료를 생성합니다. 작업 폴더의 양식 파일과 프로젝트 자료를 함께 활용합니다.
+label: PPT deck creator
+description: Create consulting-style PowerPoint decks with AX native PPT generation.
 icon: \uE7BE
-when_to_use: 제안서 deck, 경영보고, 임원 보고자료, 프로젝트 현황 발표, 교육용 슬라이드, 회의 발표 자료를 새로 만들어야 하거나 기존 양식 PPT를 활용해야 할 때
-argument-hint: <주제 또는 문서 목적>
+when_to_use: Use for executive decks, board updates, PMO steering materials, operating model proposals, KPI review decks, or any request that needs a polished PPTX deliverable.
+argument-hint: <topic or deck objective>
 allowed-tools:
  - folder_map
  - document_plan
@@ -14,96 +14,68 @@ allowed-tools:
 tabs: cowork
 ---

-사용자의 요구에 맞는 PowerPoint 프레젠테이션을 AX 기본 `pptx_create` 도구로 생성하세요.
+Use `pptx_create` as the default path. Do not start with ad-hoc slide arrays unless the user already gave a very detailed deck structure.

-## 기본 원칙
- 기본 경로는 항상 `pptx_create`입니다. Python 스크립트 생성은 예외 상황에서만 고려하세요.
- 슬라이드마다 메시지는 하나만 두고, 제목은 설명형 문장이 아니라 결론형 headline으로 작성하세요.
- bullet은 슬라이드당 3~5개 이내의 짧고 강한 문장으로 유지하세요. 공간을 채우기 위한 장문 bullet은 금지합니다.
- 숫자, 비교, 일정, 권고안은 각각 맞는 레이아웃으로 분리하세요.
+## Default workflow
+1. Review the workspace for existing presentation files, reports, or templates.
+2. Use `document_plan` with `document_type: presentation` to define the storyline first.
+3. Build a deck brief with `audience`, `objective`, `decision_ask`, and optional `storyline`.
+4. Generate the deck with `pptx_create`.
+5. Return the file path together with the storyline and quality summary.

-## 권장 작업 순서
-1. `folder_map`으로 작업 폴더를 확인하고 기존 `.pptx`, 보고서, 분석 문서, 회의록이 있는지 찾으세요.
-2. 참고할 양식 PPT가 있으면 파일명을 기억하고, 필요 시 `document_read`로 슬라이드 구조를 파악하세요.
-3. 먼저 `document_plan`을 `document_type: presentation`으로 호출해서 스토리라인을 정리하세요.
-4. 그 결과를 바탕으로 `pptx_create`용 슬라이드 배열을 설계하세요.
-5. 생성 후 결과 파일 경로와 핵심 구성(슬라이드 수, 사용 템플릿/테마, 주요 레이아웃)을 간단히 안내하세요.
+## Quality rules
+- Keep one message per slide.
+- Prefer 3-5 concise bullets, not long paragraphs.
+- Use a message headline, not a vague topic label.
+- Include `Executive Summary`, `Recommendation`, and `Roadmap` in most business decks.
+- Add `Appendix` or `Evidence` when the deck is 6 slides or longer.
+- Use comparison, chart, KPI, or evidence slides when data exists.

-## 컨설팅형 스토리라인 규칙
- 기본 구조는 가능하면 아래 순서를 따르세요.
- `Executive Summary`
- `Situation & Imperative`
- `Key Findings`
- `Options & Recommendation`
- `Implementation Roadmap`
- `Impact & Ask`
+## Useful layouts
+- `title`
+- `executive_summary`
+- `comparison`
+- `recommendation`
+- `roadmap`
+- `kpi_dashboard`
+- `chart`
+- `table`
+- `issue_tree`
+- `before_after`
+- `decision_matrix`
+- `risk_heatmap`
+- `benefit_waterfall`
+- `operating_model`
+- `appendix_evidence`

-## 레이아웃 선택 기준
- `executive_summary`: 경영진 요약, 한 줄 권고안, 핵심 takeaways, KPI 요약
- `recommendation`: 단일 권고안과 근거, 즉시 실행 항목
- `comparison`: 대안 비교, 옵션별 pros/risks, 추천안 강조
- `roadmap`: 단계별 일정, 소유자, 주요 산출물
- `kpi_dashboard`: 핵심 수치, 추세, 시사점
- `chart`: 정량 데이터 시각화
- `table`: 비교표, 상세 데이터표
- `section`: 장 구분
- `content`: 일반 설명 슬라이드
-
-## 양식 활용
- 작업 폴더에 기존 양식 PPT가 있으면 `template` 또는 `theme_file`로 우선 활용하세요.
- 양식 후보 예시:
-  - 파일명에 `양식`, `template`, `표준`, `기본`, `보고`, `proposal`, `deck` 포함
-  - 사용자가 특정 `.pptx` 파일명을 직접 언급
- 양식이 명확하지 않으면 기본 `template: basic100` 또는 문서 성격에 맞는 `corporate`, `professional`, `modern` 중 하나를 사용하세요.
-
-## 슬라이드 작성 규칙
- 제목은 `무엇을 다룰지`가 아니라 `무슨 결론인지`를 말해야 합니다.
- 각 슬라이드는 headline, supporting evidence, takeaway의 3요소를 갖추세요.
- 데이터가 없으면 억지 차트를 만들지 말고, 비교 카드나 권고안 슬라이드로 전환하세요.
- 표는 설명보다 비교에 유리할 때만 사용하세요.
- speaker notes가 유용하면 `notes`를 넣어 발표 포인트를 남기세요.
-
-## 예시 흐름
- `document_plan`으로 발표 구조 생성
- `pptx_create`에서 아래와 같은 레이아웃 조합 사용
-  - `title`
-  - `executive_summary`
-  - `comparison`
-  - `recommendation`
-  - `roadmap`
-  - `kpi_dashboard`
-  - `section`
-  - `content`
-
-## 예시 파라미터 스케치
+## Example
 ```json
 {
  "path": "strategy-deck.pptx",
  "template": "basic100",
+  "audience": "executive committee",
+  "objective": "customer growth strategy recommendation",
+  "decision_ask": "approve phase-1 CRM and retention program funding",
+  "storyline": [
+    "Executive Summary",
+    "Current State",
+    "Options",
+    "Recommendation",
+    "Roadmap",
+    "Impact & Ask"
+  ],
  "slides": [
-    {
-      "layout": "title",
-      "title": "2026 사업 전략 제안",
-      "subtitle": "성장 가속과 운영 효율 동시 달성"
-    },
    {
      "layout": "executive_summary",
      "title": "Executive Summary",
-      "headline": "핵심 투자 우선순위를 재배치하면 2개 분기 내 수익성을 개선할 수 있습니다.",
+      "headline": "Focus on retention and CRM automation to restore growth within two quarters.",
      "summary_points": [
-        "핵심 비용 3개 영역에서 구조적 비효율이 확인되었습니다.",
-        "고객 유지율 개선이 신규 확보보다 더 큰 수익 기회를 만듭니다.",
-        "선행 투자 없이 가능한 빠른 실행과제도 존재합니다."
+        "Three priority cohorts explain most of the growth gap.",
+        "Workflow automation reduces manual operating cost.",
+        "Phase-1 actions and medium-term changes are clearly separated."
      ],
-      "recommendation": "우선 CRM 고도화와 운영 자동화를 병행하고, 저효율 캠페인은 즉시 축소합니다.",
-      "kpis": [
-        { "label": "매출총이익", "value": "+4.2%p", "trend": "2Q forecast", "note": "product mix 개선" },
-        { "label": "CAC", "value": "-11%", "trend": "target", "note": "퍼널 최적화" },
-        { "label": "Retention", "value": "+6pt", "trend": "12M", "note": "핵심 세그먼트" }
-      ]
+      "recommendation": "Approve phase-1 CRM upgrade and retention program launch."
    }
  ]
 }
 ```
-
-한국어로 안내하고, 결과 파일은 작업 폴더에 저장하세요.