feat: 코드 리뷰 및 요약 기능 개선 (코멘트 형식 및 출력 구조 변경)

Author: kim-the9

src/bot.ts

@@ -409,8 +409,16 @@ export const robot = (app: Probot) => {
       const isFileCountWithinLimit = changedFiles.length <= MAX_FILE_COUNT;
 
       const ress = [];
-      let overallReview: { summary: string } | null = null;
-      // 인라인 코멘트가 위치 불일치(예: 422)로 실패할 경우, 본문 코멘트로 대체하기 위해 누적하는 버퍼
+      type SummaryResult = {
+        changeType: string;
+        title: string;
+        summary: string;
+        walkthrough: Array<{ file: string; changes: string; intent: string }>;
+        affectedAreas: string[];
+        risks: Array<{ level: string; description: string }>;
+        testingNotes: string | null;
+      };
+      let overallReview: SummaryResult | null = null;
       let inlineFallback: string[] = [];
 
       if (isFileCountWithinLimit) {
@@ -434,16 +442,12 @@ export const robot = (app: Probot) => {
         }
 
         const prTitle = pull_request.title || "(no title)";
-        const summary = overallReview?.summary
-          ? `\n## 변경 요약\n${overallReview.summary}`
-          : "";
         const prMeta = [
           `## PR 제목\n${prTitle}`,
           `\n## 커밋 메시지\n${truncateForPrompt(
             aggregatedCommitMessages,
             allocateBudget(MAX_GLOBAL_CONTEXT_CHARS, 0.3)
           )}`,
-          summary,
         ].join("\n");
 
         let prFilePatchByPath = new Map<string, string>();
@@ -531,33 +535,41 @@ export const robot = (app: Probot) => {
             }
 
             if (!res.lgtm || (res.lgtm && REVIEW_ON_LGTM)) {
+              const formatCommentBody = (c: typeof res.comments[0]) => {
+                const severityEmoji = c.severity === "critical" ? "🔴" : "🟠";
+                return `${severityEmoji} **[${c.category}]** ${c.body}`;
+              };
+
               if (!commentablePaths.has(file.filename)) {
                 log.info(
                   `PR 파일에 patch가 없어 ${file.filename}에 대한 코멘트 생략`
                 );
-                const fallbackBody = res.comments.map((c) => c.body).join("\n");
+                const fallbackBody = res.comments.map(formatCommentBody).join("\n");
                 inlineFallback.push(`\n### ${file.filename}\n${fallbackBody}`);
                 continue;
               }
 
               const prWidePatch = prFilePatchByPath.get(file.filename) || patch;
               if (!prWidePatch || !prWidePatch.includes("@@")) {
-                const fallbackBody = res.comments.map((c) => c.body).join("\n");
+                const fallbackBody = res.comments.map(formatCommentBody).join("\n");
                 inlineFallback.push(`\n### ${file.filename}\n${fallbackBody}`);
                 continue;
               }
 
               for (const comment of res.comments) {
                 const position = comment.line;
+                const severityEmoji = comment.severity === "critical" ? "🔴" : "🟠";
+                const formattedBody = `${severityEmoji} **[${comment.category}]** ${comment.body}`;
+
                 if (!Number.isSafeInteger(position) || position <= 0) {
                   inlineFallback.push(
-                    `\n### ${file.filename}\n${comment.body}`
+                    `\n### ${file.filename}\n${formattedBody}`
                   );
                   continue;
                 }
                 ress.push({
                   path: file.filename,
-                  body: comment.body,
+                  body: formattedBody,
                   position,
                 });
               }
@@ -578,10 +590,63 @@ export const robot = (app: Probot) => {
         }
       }
 
+      const formatSummaryBody = (review: SummaryResult): string => {
+        const changeTypeEmoji: Record<string, string> = {
+          feature: "✨",
+          bugfix: "🐛",
+          refactor: "♻️",
+          docs: "📝",
+          test: "🧪",
+          chore: "🔧",
+        };
+        const riskEmoji: Record<string, string> = {
+          high: "🔴",
+          medium: "🟠",
+          low: "🟡",
+        };
+
+        const parts: string[] = [];
+        parts.push(`## ${changeTypeEmoji[review.changeType] || "📋"} ${review.title}`);
+        parts.push("");
+        parts.push(review.summary);
+
+        if (review.walkthrough.length > 0) {
+          parts.push("");
+          parts.push("### 📂 변경 파일");
+          parts.push("| 파일 | 변경 내용 | 의도 |");
+          parts.push("|------|----------|------|");
+          for (const w of review.walkthrough) {
+            parts.push(`| \`${w.file}\` | ${w.changes} | ${w.intent} |`);
+          }
+        }
+
+        if (review.affectedAreas.length > 0) {
+          parts.push("");
+          parts.push(`### 🎯 영향 범위`);
+          parts.push(review.affectedAreas.map((a) => `- ${a}`).join("\n"));
+        }
+
+        if (review.risks.length > 0) {
+          parts.push("");
+          parts.push("### ⚠️ 리스크");
+          for (const r of review.risks) {
+            parts.push(`- ${riskEmoji[r.level] || "⚪"} **${r.level.toUpperCase()}**: ${r.description}`);
+          }
+        }
+
+        if (review.testingNotes) {
+          parts.push("");
+          parts.push("### 🧪 테스트 참고사항");
+          parts.push(review.testingNotes);
+        }
+
+        return parts.join("\n");
+      };
+
       try {
         let body = "LGTM 👍";
         if (overallReview && overallReview.summary) {
-          body = `<!-- chatgpt-summary:v1 -->\n${overallReview.summary}`;
+          body = `<!-- chatgpt-summary:v1 -->\n${formatSummaryBody(overallReview)}`;
         } else if (ress.length) {
           body = "Code review by ChatGPT";
         }
@@ -615,7 +680,7 @@ export const robot = (app: Probot) => {
           try {
             let body = "LGTM 👍";
             if (overallReview && overallReview.summary) {
-              body = `<!-- chatgpt-summary:v1 -->\n${overallReview.summary}`;
+              body = `<!-- chatgpt-summary:v1 -->\n${formatSummaryBody(overallReview)}`;
             }
 
             if (