byuckchon-frontend-cli 1.10.0 → 1.10.1

package/README.md

@@ -251,6 +251,8 @@ color는 `@theme`의 `--color-*`로, typography는 `@utility text-*`로, motion
 ```text
 .github/workflows/eslint-convention-review.yml   # 컨벤션 인라인 댓글
 .github/workflows/pr-check.yml                   # lint / typecheck / build 통과 여부 (bc init 전용)
+.github/workflows/pr-description.yml             # 커밋 내역을 PR 본문에 반영
+.github/pull_request_template.md
 tools/review.config.mjs
 ```
 
@@ -277,6 +279,24 @@ PR이 `dev` 브랜치를 대상으로 할 때, workflow가 기계적으로 판
 | Convention Review | 파일명, export 방식, boolean 변수명 등 | PR 인라인 `BLOCKING` 또는 `WARNING` 댓글 |
 | AI 리뷰 | 설계·예외 처리·비즈니스 판단 | 별도 AI 리뷰 workflow에서 구성 |
 
+### PR 본문 자동 작성
+
+`pr-description.yml` 이 PR 의 커밋을 타입별로 묶어 description 에 채워 넣습니다.
+
+```markdown
+### ✨ 기능
+- **settings** — tsconfig 프리셋 추가 (a1b2c3d)
+
+### 🐛 수정
+- letterSpacing % → em 변환 (b2c3d4e)
+```
+
+사람이 쓴 내용은 건드리지 않고 `<!-- byuckchon:commits:start -->` 마커 사이만 갱신하며,
+커밋을 추가로 푸시하면 목록도 따라 갱신됩니다. 머지 커밋은 제외하고, 컨벤션을 안 지킨
+커밋은 버리지 않고 "분류 없음"으로 모읍니다.
+
+생성되는 `.github/pull_request_template.md` 에 마커가 미리 들어 있습니다.
+
 같은 지적은 숨김 marker를 기준으로 중복 게시하지 않고, 메시지가 바뀌면 기존 댓글을 갱신합니다.
 모노레포에서는 workflow와 `tools/`가 루트에 한 번만 존재하며, PR에서 변경된 TypeScript 파일을
 대상으로 검사합니다.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "byuckchon-frontend-cli",
-  "version": "1.10.0",
+  "version": "1.10.1",
   "description": "Byuckchon Frontend Workbench — project starter + AI chat + codebase RAG + OpenAPI codegen",
   "type": "module",
   "engines": {

package/src/generators/scaffoldReviewAutomation.js

@@ -74,7 +74,7 @@ async function copyFileIfAllowed(source, target, overwrite) {
  * @param {'single' | 'monorepo'} args.projectType 생성할 프로젝트 유형
  * @param {boolean} [args.overwrite=true] 기존 파일을 템플릿으로 덮어쓸지
  * @param {string[]} [args.exclude=[]] 제외할 워크플로 이름 (확장자·유형 접미사 제외)
- * @returns {Promise<{ toolsDir: string, workflows: string[] }>}
+ * @returns {Promise<{ toolsDir: string, workflows: string[], pullRequestTemplate: boolean }>}
  */
 export async function scaffoldReviewAutomation({
   projectRoot,
@@ -111,5 +111,16 @@ export async function scaffoldReviewAutomation({
     if (copied) copiedWorkflows.push(target);
   }
 
-  return { toolsDir: toolsTargetDir, workflows: copiedWorkflows };
+  // PR 템플릿 — 커밋 내역이 채워질 마커를 품고 있다.
+  const pullRequestTemplate = await copyFileIfAllowed(
+    path.join(TEMPLATE_ROOT, 'github', 'pull_request_template.md'),
+    path.join(projectRoot, '.github', 'pull_request_template.md'),
+    overwrite,
+  );
+
+  return {
+    toolsDir: toolsTargetDir,
+    workflows: copiedWorkflows,
+    pullRequestTemplate,
+  };
 }

package/templates/review-automation/github/pull_request_template.md

@@ -0,0 +1,30 @@
+## 작업 내용
+
+<!-- 무엇을, 왜 바꿨는지 적어주세요. -->
+
+## 확인 사항
+
+<!-- 리뷰어가 중점적으로 봐야 할 부분이 있다면 적어주세요. -->
+
+## 테스트
+
+- [ ] 로컬에서 동작 확인
+- [ ] `lint` / `typecheck` / `build` 통과
+
+<!--
+  아래 마커 사이는 워크플로가 자동으로 채웁니다. 직접 수정하지 마세요.
+
+  - 커밋 내역: 커밋 메시지 첫 줄을 타입별로 묶습니다. (feat / fix / docs ...)
+  - 리뷰 포인트: 커밋 본문에 NOTE: 또는 TODO: 로 적은 줄을 모읍니다.
+
+      feat: 주문 목록 API 연동
+
+      NOTE: 응답 스키마가 미확정이라 any 가 남아 있습니다
+      TODO: 에러 처리 미구현
+
+  PR 제목은 브랜치명의 첫 토막이 대괄호로 붙습니다.
+      feature/update-mypage-style/hyuk + "마이페이지 디자인 적용"
+        → "[feature] 마이페이지 디자인 적용"
+-->
+<!-- byuckchon:commits:start -->
+<!-- byuckchon:commits:end -->

package/templates/review-automation/github/workflows/pr-description.yml

@@ -0,0 +1,58 @@
+# PR 본문에 커밋 내역을 자동으로 채워 넣습니다.
+#
+# 사람이 쓴 내용은 건드리지 않고, 아래 마커 사이만 갱신합니다.
+#   <!-- byuckchon:commits:start --> ~ <!-- byuckchon:commits:end -->
+# 마커가 없으면 본문 끝에 한 번 덧붙입니다. (PR 템플릿이 없어도 동작)
+#
+# 커밋 메시지를 `feat:` `fix:` 처럼 쓰면 타입별로 묶이고,
+# 컨벤션을 안 지킨 커밋은 "분류 없음"으로 모입니다.
+#
+# 커밋 본문에 NOTE: 또는 TODO: 로 적은 줄은 "리뷰 포인트"로 따로 모입니다.
+# AI 로 코드를 짤 때 "여긴 리뷰어가 봐야 한다"를 남겨두는 용도로 쓰세요.
+#
+# PR 제목에는 브랜치명의 첫 토막이 대괄호로 붙습니다.
+#   feature/update-mypage-style/hyuk + "마이페이지 디자인 적용"
+#     → "[feature] 마이페이지 디자인 적용"
+# 사람이 쓴 제목은 그대로 두고 앞에만 붙이며, 이미 대괄호가 있으면 건드리지 않습니다.
+#
+# 복사된 파일이므로 프로젝트 소유입니다. 대상 브랜치 등은 자유롭게 수정하세요.
+
+name: PR Description
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+    branches:
+      - dev
+
+concurrency:
+  group: pr-description-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  describe:
+    name: 커밋 내역 반영
+    # changeset 릴리즈 PR 처럼 봇이 연 PR 은 본문을 그대로 둔다.
+    if: ${{ !endsWith(github.event.pull_request.user.login, '[bot]') }}
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+
+      - name: PR 본문 갱신
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          REPO: ${{ github.repository }}
+          PR_NUMBER: ${{ github.event.pull_request.number }}
+        run: |
+          # 프로젝트가 고정한 settings 버전을 그대로 사용합니다.
+          # (전체 의존성 설치 없이 이 패키지만 받아 실행)
+          VERSION=$(node -p "const p=require('./package.json'); (p.devDependencies?.['@byuckchon-frontend/settings'] ?? p.dependencies?.['@byuckchon-frontend/settings'] ?? 'latest')")
+          npx --yes --package "@byuckchon-frontend/settings@${VERSION}" byuckchon-pr-description