变更日志

karanmrn2026-10-26查看 562复制 318

为刚刚完成的工作在 CHANGELOG.md 中添加面向用户的条目。在收尾功能/修复时，或被要求记录变更时使用。可独立调用，或从 `done` 技能中调用。

📘如何使用这个技能

1
复制技能内容·点击上方「Copy SKILL.md」复制全部内容，或 Download 下载到本地
2
打开你的 AI 客户端·支持 Claude Code、Trae、Cursor、ChatGPT、DeepSeek、Kimi 等任意 AI 助手
3
粘贴为系统提示/知识文件·Claude Code：放入 .claude/skills/ 目录；普通对话：作为首条消息发送并说「请严格按这份技能文档执行」
4
直接提出你的需求·AI 会按技能定义的工作流、格式和约束来处理，无需再解释背景

💡 提示：技能生效后，每次对话只需一句需求，AI 会按 SKILL.md 的流程执行。

SKILL.md2253 chars

---
name: changelog
description: Add a user-facing entry to CHANGELOG.md for work that just landed. Use when wrapping up a feature/fix, or when asked to record what changed. Called standalone or from the `done` skill.
---

# Changelog

Record what shipped as it lands. Do not scrape commits at release time, write
the entry now while the change is fresh.

## How

1. Open root `CHANGELOG.md`.
2. Add one bullet under `## [Unreleased]`, in the right subhead:
   - `Added` — new features the user can see/use.
   - `Changed` — behavior changes to existing features.
   - `Fixed` — bug fixes.
3. Write it for a user reading release notes, not as a commit message:
   - One line, present tense.
   - Describe the effect, not the implementation or file paths.
   - Skip internal-only churn (refactors, deps, CI, tests) unless it changes
     what the user experiences.
4. Link the PR for every entry (not the issue).
5. Credit the contributor. Every entry from someone other than `bholmesdev`
   gets a thank you, including when you are that contributor writing your own
   entry.

   Find the handle:
   - PR already open: `gh pr view --json author --jq .author.login`.
   - No PR yet: `gh api user --jq .login`, the account that will open it.

   Then, unless the handle is `bholmesdev`, put one of these before the link:
   - `Thanks [@handle](https://github.com/handle)!` for their own work.
   - `Thanks [@handle](https://github.com/handle) for the suggestion!` when
     `bholmesdev` landed someone else's issue.

Create a subhead only if it has at least one entry. Leave the empty scaffold
subheads as-is for the next entry.

## Example

```markdown
## [Unreleased]

### Added
- First-run onboarding with an HTML Apps callout. [#123](https://github.com/bholmesdev/hubble.md/pull/123)
- View and run HTML apps inside the editor. Thanks [@contributor](https://github.com/contributor)! [#124](https://github.com/bholmesdev/hubble.md/pull/124)

### Fixed
- Slash menu no longer hides behind the toolbar. Thanks [@contributor](https://github.com/contributor) for the suggestion! [#126](https://github.com/bholmesdev/hubble.md/pull/126)
```

Entries stay under `Unreleased` until `/release` promotes them to a version
heading. See `.agents/skills/release`.

来源：skillsdirectory

变更日志

📘如何使用这个技能

评论0