diff --git a/DEVELOPMENT.md b/DEVELOPMENT.md
index 13fbccd..46797e8 100644
--- a/DEVELOPMENT.md
+++ b/DEVELOPMENT.md
@@ -41,6 +41,7 @@ bun test                  # 运行单元/集成测试（排除 agent e2e 测试
 bun run test:e2e          # 运行 agent 端到端测试（Tier 1 + 2，< 5s）
 bun run test:e2e:llm      # 运行 LLM-as-Judge 测试（Tier 3，需设置环境变量）
 bun test tests/core/      # 运行指定目录测试
+bun run release           # 发布新版本（交互式递增版本号、测试门禁、git commit+tag、npm publish）
 bun src/cli.ts init opencode  # 测试 init 命令
 bun src/cli.ts plan <变更名> <文档名>  # 测试 plan 命令
 bun src/cli.ts status [变更名]        # 测试 status 命令
@@ -148,3 +149,14 @@ CLI 通过子命令提供帮助和版本信息，不使用 `--help`/`--version`
 - `bun test`（pre-commit 用）：Tier 1 + 2 **不参与**，仅跑单元/集成
 - `bun run test:e2e`：Tier 1 + 2（< 5s）
 - `bun run test:e2e:llm`：Tier 3（手动触发，需 `RUNE_E2E_LLM_API_KEY`）
+
+## 发布流程
+
+`bun run release` 交互式发布新版本到 npm：
+
+1. **版本递增**：选择 major/minor/patch，确认后写回 package.json
+2. **测试门禁**：执行 `bun test`，失败则终止
+3. **Git 操作**：确认后执行 `git add` + `commit` + `tag`（仅本地，不推送）
+4. **npm 发布**：`bun publish --dry-run` 预览，确认后 `bun publish --access public`
+
+发布前确保已通过 `npm login` 登录 npm，且 npm 账号有 `@lanyuanxiaoyao` scope 的发布权限。