From 36dc96fcb506e44c45b7c6719b9d7e9c227daca0 Mon Sep 17 00:00:00 2001
From: bowenliang123 <liang.bowen.123@qq.com>
Date: Wed, 30 Sep 2026 00:21:58 +0800
Subject: [PATCH] docs: update release notes and template for clarity and
 structure

---
 .github/release_template.md | 17 +++++++++++++----
 AGENTS.md                   |  1 +
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/.github/release_template.md b/.github/release_template.md
index 799349e..fff5a6f 100644
--- a/.github/release_template.md
+++ b/.github/release_template.md
@@ -14,10 +14,19 @@ dsh plugin --profile web update dsh-context@latest
 
 ## What's New
 
-The single most important user-facing change, as a narrative. Drop this section when there is no headline change.
-- **<Headline change N>** — <what it is, why it matters, 2–4 sentences.>
-  - <Key property 1>
-  - <Key property 2>
+(The important user-facing changes)
+
+### Features
+
+- ** <Headline change N>**
+  - <Key briefing 1>
+  - <Key briefing 2>
+
+### Fixes
+- ...
+
+### Changes
+- ...
 
 ## Commits
 
diff --git a/AGENTS.md b/AGENTS.md
index a67d09f..64fc9fb 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -103,6 +103,7 @@ A DeepSeek Harness plugin for context insight, actions, and management.
 
 ## Releasing
 - Version X.Y.Z, 大版本.次版本.小版本。
+- Review all the commits/changes since last tagged release.
 - Releases are cut by tagging: `git tag vX.Y.Z && gh release create vX.Y.Z`.
 - A [GitHub Actions workflow](.github/workflows/release.yml) then builds, tests, and publishes the package to npm automatically by github workflow. Agent don't have to do or check it manually.
 - Write the release notes from the [release template](.github/release_template.md)