From 8002131692e53e44b214fbd7d594b2e1a6a3e723 Mon Sep 17 00:00:00 2001
From: 7418 <7418@openclaw.ai>
Date: Mon, 9 Feb 2026 10:26:09 +0800
Subject: [PATCH] docs: add release notes format spec to CLAUDE.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 CLAUDE.md | 46 +++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index ba8e6cc..fc21958 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -11,7 +11,7 @@ CodePilot — Claude Code 的原生桌面 GUI 客户端，基于 Electron + Next
 1. `package.json` 中的 `"version"` 字段
 2. `package-lock.json` 中的对应版本（运行 `npm install` 会自动同步）
 3. 构建命令：`npm run electron:pack:mac`（macOS）/ `npm run electron:pack:win`（Windows）
-4. 上传产物到 GitHub Release 并编写 release notes
+4. 上传产物到 GitHub Release 并编写 release notes（格式见下方 Release Notes 规范）
 
 ## Development Rules
 
@@ -28,6 +28,50 @@ CodePilot — Claude Code 的原生桌面 GUI 客户端，基于 Electron + Next
 - 涉及 Claude Code SDK 需确认 SDK 实际支持的功能和调用方式
 - 对不确定的技术点先做 POC 验证，不要直接在主代码中试错
 
+## Release Notes 规范
+
+每次发布 GitHub Release 时，必须包含以下内容：
+
+**标题格式**: `CodePilot v{版本号}`
+
+**正文结构**:
+
+```markdown
+## New Features / Bug Fixes（按实际内容选择标题）
+
+- **功能/修复标题** — 简要描述改动内容和原因
+
+## Downloads
+
+- **CodePilot-{版本}-arm64.dmg** — macOS Apple Silicon (M1/M2/M3/M4)
+- **CodePilot-{版本}-x64.dmg** — macOS Intel
+
+## Installation
+
+1. 下载对应芯片架构的 DMG 文件
+2. 打开 DMG，将 CodePilot 拖入 Applications 文件夹
+3. 首次打开时如遇安全提示，前往 **系统设置 → 隐私与安全性** 点击"仍要打开"
+4. 在 Settings 页面配置 Anthropic API Key 或环境变量
+
+## Requirements
+
+- macOS 12.0+
+- Anthropic API Key 或已配置 `ANTHROPIC_API_KEY` 环境变量
+- 如需使用代码相关功能，建议安装 Claude Code CLI
+
+## Changelog (since v{上一版本})
+
+| Commit | Description |
+|--------|-------------|
+| `{hash}` | {commit message} |
+```
+
+**注意事项**:
+- 大版本（功能更新）用 `## New Features` + `## Bug Fixes` 分区
+- 小版本（纯修复）用 `## Bug Fix` 即可
+- Downloads、Installation、Requirements 每次都要写，方便新用户
+- Changelog 表格列出自上一版本以来的所有 commit
+
 ## Build Notes
 
 - macOS 构建产出 DMG（arm64 + x64），Windows 产出 NSIS 安装包或 zip