Skip to content

Commit 806037f

Browse files
committed
(.claude): ⚙️ changeset-generator 스킬에 commit hash prefix 대응 가이드 추가
pnpm changeset version이 changeset 본문을 '- <hash>: <content>' 형태로 감싸는 점을 고려하여 SKILL.md의 포맷 가이드를 업데이트한다. '### 헤딩', 빈 줄, 다단락 본문은 리스트 아이템을 깨뜨리므로 금지하고 한 줄 평문 불릿 형태로 작성하도록 명시한다.
1 parent 4d7a4b0 commit 806037f

File tree

1 file changed

+14
-20
lines changed
  • .claude/skills/changeset-generator

1 file changed

+14
-20
lines changed

.claude/skills/changeset-generator/SKILL.md

Lines changed: 14 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ This skill replaces `pnpm changeset add` by automatically analyzing git changes
2222
- Bug fixes, dependency bumps → `patch`
2323
- Docs/CI/refactor with no API impact → excluded by default
2424
3. **Asks how to group**: When multiple packages are changed, asks the user whether to bundle them into a single changeset or create separate changeset files per package
25-
4. **Writes user-friendly description**: Transforms commit messages into clear release notes with code examples for breaking changes or new APIs
25+
4. **Writes user-friendly description**: Transforms commit messages into a flat list of plain-sentence bullets (one per change) that render cleanly after the changelog's `- <commit-hash>:` prefix
2626
5. **Creates the changeset file(s)**: Writes to `.changeset/<slug>.md` and shows it for review before committing
2727

2828
## How to Use
@@ -35,34 +35,28 @@ Analyzes all commits since branching from `main` and generates the changeset fil
3535

3636
## Changeset File Format
3737

38+
**IMPORTANT:** `pnpm changeset version` wraps every changeset body line as `- <commit-hash>: <content>` in the generated `CHANGELOG.md`. This means markdown headings (`###`), blank lines, and multi-paragraph content inside a changeset body will render as a broken list item. Keep the body as a flat list of plain sentences — one bullet per change — and do NOT use headings or section labels.
39+
40+
Good format (renders cleanly under `- abc1234: ...`):
41+
3842
````md
3943
---
4044
"@scope/package-a": minor
4145
"@scope/package-b": patch
4246
---
4347

44-
### Breaking Changes
45-
46-
- Description with before/after code examples
47-
48-
```ts
49-
// Before
50-
import foo from "@scope/package-a/old-name";
51-
52-
// After
53-
import foo from "@scope/package-a/new-name";
54-
```
48+
- Rename `@scope/package-a/old-name` export to `@scope/package-a/new-name`. Update imports to use the new path.
49+
- Add new helper `formatFoo()` in `@scope/package-b` for formatting foo values.
50+
- Fix crash in `@scope/package-a` when config is undefined.
5551
````
5652

57-
### New Features
53+
Guidelines for each bullet:
5854

59-
- Description with usage example
60-
61-
### Bug Fixes
62-
63-
- Description
64-
65-
```
55+
- Write one self-contained sentence per change. If context is needed, add it inline — do not split across lines or paragraphs.
56+
- Lead with the action verb (Add / Fix / Rename / Remove / Update).
57+
- Mention affected exports, APIs, or files inline using backticks so the changelog is searchable.
58+
- For breaking changes, state the before → after inline (e.g., "Rename `X` to `Y`") rather than using a separate heading.
59+
- Do not use `###`, `**bold labels**`, blockquotes, or fenced code blocks inside the body — they will break the wrapped list item.
6660

6761
## Example
6862

0 commit comments

Comments
 (0)