feat: 글 상단에 AI 요약 표시 기능 추가

posts 콘텐츠 스키마에 aiSummary optional 필드를 추가하고, 값이 있으면
글 헤더와 본문 사이에 요약 박스를 렌더링한다. 정적 사이트라 빌드/배포 시점의
실시간 API 호출이 불가능해 글 작성 시점에 요약을 직접 채워 넣는 방식으로 구현.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

Author: Dev-HyunSang

CLAUDE.md

@@ -0,0 +1,16 @@
+# dev-hyunsang.github.io
+
+Astro 기반 정적 블로그 (GitHub Pages 배포, 서버/어댑터 없음).
+
+## 새 포스트 작성 시
+
+`src/content/posts/**/index.md`에 새 글을 쓰거나 기존 글의 본문을 크게 수정하면,
+frontmatter에 `aiSummary` 필드를 2~3문장으로 채워 넣는다. 글 상단에 자동으로 렌더링된다
+(`src/components/AISummary.astro`, `src/layouts/SingleLayout.astro`).
+
+- 정적 사이트라 빌드/배포 시점에 실시간 API 호출이 불가능하므로, 글 작성 시점에 직접 생성해 저장하는 방식이다.
+- 예시:
+  ```yaml
+  aiSummary: "PyCon Korea 2026 미디어팀 리드로 활동한 경험을 돌아보며, 커뮤니케이션과 팀워크에 대한 고민을 정리한 회고."
+  ```
+- 필드가 비어 있으면 요약 박스는 표시되지 않는다(optional).

src/components/AISummary.astro

@@ -0,0 +1,15 @@
+---
+interface Props {
+  summary: string;
+}
+
+const { summary } = Astro.props;
+---
+
+<div class="ai-summary">
+    <div class="ai-summary-label">
+        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9.937 15.5A2 2 0 0 0 8.5 14.063l-6.135-1.582a.5.5 0 0 1 0-.962L8.5 9.936A2 2 0 0 0 9.937 8.5l1.582-6.135a.5.5 0 0 1 .963 0L14.063 8.5A2 2 0 0 0 15.5 9.937l6.135 1.582a.5.5 0 0 1 0 .963L15.5 14.063a2 2 0 0 0-1.437 1.437l-1.582 6.135a.5.5 0 0 1-.963 0z"/></svg>
+        <span>AI 요약</span>
+    </div>
+    <p class="ai-summary-text">{summary}</p>
+</div>

src/content.config.ts

@@ -13,6 +13,7 @@ const posts = defineCollection({
     showDate: z.boolean().optional(),
     showAuthor: z.boolean().optional(),
     toc: z.boolean().optional(),
+    aiSummary: z.string().optional(),
   }),
 });
 

src/content/posts/PyCon-KR-2026/index.md

@@ -5,6 +5,7 @@ date: 2026-08-17
 draft: false
 categories: ["개발자 커뮤니티 활동", "회고"]
 tags: ["PyCon Korea", "PyCon Korea 2026"]
+aiSummary: "저자가 파이콘준비위원회 신설 미디어팀 리드로서 PyCon Korea 2026을 준비하며 겪은 장비·송출·촬영 운영 경험과, 그 과정에서 성장한 커뮤니케이션 역량을 돌아보는 회고."
 ---
 
 안녕하세요. 박현상입니다.  

src/layouts/SingleLayout.astro

@@ -2,6 +2,7 @@
 import type { MarkdownHeading } from 'astro';
 import BaseLayout from './BaseLayout.astro';
 import TableOfContents from '../components/TableOfContents.astro';
+import AISummary from '../components/AISummary.astro';
 import { site } from '../site.config';
 import { formatDateKo, isoDate } from '../lib/date';
 import { urlize } from '../lib/slug';
@@ -16,6 +17,7 @@ interface Props {
   showAuthor?: boolean;
   toc?: boolean;
   headings?: MarkdownHeading[];
+  aiSummary?: string;
 }
 
 const {
@@ -28,6 +30,7 @@ const {
   showAuthor = true,
   toc = true,
   headings = [],
+  aiSummary,
 } = Astro.props;
 
 const showToc = toc && headings.some((h) => h.depth >= 2 && h.depth <= 3);
@@ -59,6 +62,8 @@ const showToc = toc && headings.some((h) => h.depth >= 2 && h.depth <= 3);
                 </div>
             </div>
 
+            {aiSummary && <AISummary summary={aiSummary} />}
+
             <div class="post-body">
                 <slot />
             </div>

src/pages/posts/[...slug].astro

@@ -24,6 +24,7 @@ const { Content, headings } = await render(post);
     showAuthor={post.data.showAuthor}
     toc={post.data.toc}
     headings={headings}
+    aiSummary={post.data.aiSummary}
 >
     <Content />
 </SingleLayout>

src/styles/global.css

@@ -330,6 +330,35 @@ main {
     background: var(--border-subtle);
 }
 
+/* AI Summary */
+.ai-summary {
+    background-color: var(--bg-card);
+    border: 1px solid var(--border);
+    border-left: 4px solid var(--accent);
+    border-radius: 4px;
+    padding: 16px 20px;
+    margin-bottom: 30px;
+}
+
+.ai-summary-label {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+    color: var(--accent);
+    font-size: 0.8rem;
+    font-weight: 700;
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    margin-bottom: 8px;
+}
+
+.ai-summary-text {
+    color: var(--text-secondary);
+    font-size: 0.95rem;
+    line-height: 1.7;
+    margin: 0;
+}
+
 /* Post Body */
 .post-body {
     font-size: 1.1rem;