Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
104 changes: 104 additions & 0 deletions .agents/skills/deepchat-release/SKILL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
name: deepchat-release
description: Prepare and publish DeepChat releases in this repository. Use when Codex needs to bump the app version, update CHANGELOG.md, keep release notes bilingual from v1.0.1 onward with English bullets first and Chinese bullets second, run release checks, create or update versioned release branches such as release/v1.0.1, continue a half-finished release, fast-forward main with the documented release flow, create or push version tags, or clean up release branches after publishing.
---

# DeepChat Release

## Overview

Follow the repository-specific DeepChat release process. Prepare release metadata on `dev`, keep `CHANGELOG.md` concise, and publish through the documented fast-forward flow instead of merge commits on `main`.

## Start With Repo State

Inspect git state before changing anything:

- Check the current branch and working tree.
- Check whether `release/<version>` exists locally or on `origin`.
- Check whether `v<version>` exists locally or on `origin`.

If a local or remote tag already exists on the wrong commit, stop and ask before replacing it.

## Choose The Release Mode

Pick the mode that matches the user's request and current git state:

1. `prepare metadata`
Update `package.json`, `CHANGELOG.md`, and the release notes commit on `dev`.
2. `cut release branch`
Create `release/<version>` from the release-ready commit on `dev` and push it.
3. `update existing release branch`
Use this when the release branch already exists but metadata changed afterward. Commit on `dev`, move `release/<version>` to the new `dev` commit, and force-push only the disposable release branch.
4. `publish`
Use this only after the release PR is approved. Fast-forward `main`, create the version tag on the same commit, push the tag, and then delete the temporary release branch.

Use [references/release-checklist.md](references/release-checklist.md) for exact commands.

## Update Release Metadata

When preparing a release on `dev`:

- Update `package.json` to the target version.
- Add a new `CHANGELOG.md` section at the top.
- Summarize only user-visible or release-relevant changes since the previous tag.
- Prefer deriving the notes from recent commits or the diff since the previous release tag.

For `v1.0.1` and later, format changelog entries in this order:

```md
## vX.Y.Z (YYYY-MM-DD)
- English bullet
- English bullet
- 中文条目
- 中文条目
```

Use the current local date in `YYYY-MM-DD` form. Preserve older changelog sections unless the user explicitly asks to rewrite them.

## Run Release Checks

After editing release metadata, run these repo-required commands:

- `pnpm run format`
- `pnpm run i18n`
- `pnpm run lint`

Prefer running `pnpm run typecheck` before cutting the release branch. Run tests when the user asks, when the release touches behavior beyond metadata, or when risk is unclear. Report pre-existing failures separately from the release metadata work.

## Follow Release Branch Policy

- Keep `dev` as the integration branch.
- Treat `release/<version>` as disposable and identical to a commit already on `dev`.
- Never use the GitHub merge button for releases to `main`.
- Never click "Update branch" on the release PR.
- Use `pnpm run release:ff -- release/<version> --tag v<version>` to publish after approval.

Read [../../../docs/release-flow.md](../../../docs/release-flow.md) when you need the full repository policy or if the checklist and repo docs ever diverge.

## Common Recovery Case

When the user says something like "the release branch already exists but the tag is not created yet" or "I fixed the changelog after cutting the release branch":

1. Commit the metadata fix on `dev`.
2. Push `dev`.
3. Move `release/<version>` to `HEAD`.
4. Force-push `release/<version>` with `--force-with-lease`.
5. Continue with the existing or updated PR to `main`.
6. After approval, publish and create the tag.

## Response Rules

- Act on the repo when the user wants the release advanced; do not stop at generic advice.
- Tell the user exactly which step of the release flow they are currently in.
- Use concrete versions and dates such as `v1.0.1` and `2026-04-02`.
- Keep commands copy-pastable and repo-specific.
- If checks fail, separate blocking failures from unrelated existing warnings.

## Examples

Activate this skill for requests like:

- "准备发布 1.0.2,更新版本号和 changelog"
- "继续发 1.0.1,release 分支已经有了,还没打 tag"
- "帮我按项目流程把 release/v1.0.3 发出去"
- "检查一下现在离发布 v1.0.4 还差什么"
4 changes: 4 additions & 0 deletions .agents/skills/deepchat-release/agents/openai.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
interface:
display_name: "DeepChat Release"
short_description: "Prepare and publish DeepChat releases"
default_prompt: "Use $deepchat-release to prepare, continue, or publish a DeepChat version release."
95 changes: 95 additions & 0 deletions .agents/skills/deepchat-release/references/release-checklist.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
# DeepChat Release Checklist

Use this file for the exact command sequence after you know the target version and the current git state.

## 1. Inspect state

```bash
git status --short
git branch --show-current
git branch --list "release/vX.Y.Z"
git branch -r --list "origin/release/vX.Y.Z"
git rev-parse --verify --quiet "refs/tags/vX.Y.Z"
git ls-remote --tags origin "refs/tags/vX.Y.Z"
```

If a tag already exists locally or remotely, verify it before continuing. Ask before replacing or deleting a tag.

## 2. Prepare metadata on `dev`

```bash
git switch dev
git pull --ff-only origin dev
```

Then update:

- `package.json`
- `CHANGELOG.md`

Recommended checks:

```bash
pnpm run format
pnpm run i18n
pnpm run lint
pnpm run typecheck
```

Commit and push:

```bash
git add package.json CHANGELOG.md
git commit -m "chore(release): prepare vX.Y.Z"
git push origin dev
```

## 3. Cut a new release branch

Use this when `release/vX.Y.Z` does not exist yet.

```bash
git switch -c release/vX.Y.Z
git push -u origin release/vX.Y.Z
```

Open a PR from `release/vX.Y.Z` to `main`.

## 4. Update an existing release branch

Use this when the release branch already exists and metadata changed afterward.

```bash
git switch dev
git branch -f release/vX.Y.Z HEAD
git push --force-with-lease origin release/vX.Y.Z
```

If a PR from `release/vX.Y.Z` to `main` already exists, let it update in place.

## 5. Publish after PR approval

```bash
pnpm run release:ff -- release/vX.Y.Z --tag vX.Y.Z
git tag vX.Y.Z release/vX.Y.Z
git push origin vX.Y.Z
```

## 6. Clean up the disposable release branch

```bash
git push origin --delete release/vX.Y.Z
git branch -d release/vX.Y.Z
```

## 7. Changelog format from `v1.0.1` onward

```md
## vX.Y.Z (YYYY-MM-DD)
- English bullet
- English bullet
- 中文条目
- 中文条目
```

Keep English bullets first, Chinese bullets second, and preserve older sections unless the user explicitly asks to rewrite history.
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,15 @@
# Changelog

## v1.0.2 (2026-04-08)
- Added provider model list filtering and sorting, and now remembers the sidebar session grouping mode
- Added ACP Agent uninstall support and refined provider prompt cache configuration
- Improved remote delivery ordering for Telegram and Feishu, and fixed db-backed model list sync stability
- Refined dashboard and settings responsiveness, and fixed auto compact settings persistence
- 新增 Provider 模型列表筛选排序能力,并记住侧边栏会话分组方式
- 新增 ACP Agent 卸载支持,并完善 Provider Prompt Cache 配置体验
- 优化 Telegram 与 Feishu 远程消息投递顺序,修复数据库驱动模型列表同步稳定性
- 改进仪表盘与设置页响应式布局,并修复自动压缩设置保存问题

## v1.0.1 (2026-04-02)
- Added in-chat search and Spotlight global search for faster access to messages and app entry points
- Improved the provider database refresh flow and added manual model config refresh
Expand Down
36 changes: 0 additions & 36 deletions archives/code/dead-code-batch-2/README.md

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

This file was deleted.

Loading
Loading