From e550b73d6dabb85e45f47db845466ea9f873b5b1 Mon Sep 17 00:00:00 2001
From: wangjia <809946525@qq.com>
Date: Sun, 7 Jun 2026 15:05:56 +0800
Subject: [PATCH] =?UTF-8?q?chore(commands):=20build/test/release=20?=
 =?UTF-8?q?=E6=B5=81=E7=A8=8B=E7=BB=9F=E4=B8=80=E7=94=A8=20claude-sonnet-4?=
 =?UTF-8?q?-6=20=E6=A8=A1=E5=9E=8B=EF=BC=8C=E6=96=B0=E5=A2=9E=20/build=20/?=
 =?UTF-8?q?test=20=E5=91=BD=E4=BB=A4?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- release.md 补 frontmatter（model: claude-sonnet-4-6）
- 新增 /build：go build/vet + flutter analyze 编译静态检查
- 新增 /test：go test + flutter test
- 三者均通过 frontmatter 指定 sonnet 4.6

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 .claude/commands/build.md   | 35 +++++++++++++++++++++++++++++++++++
 .claude/commands/release.md |  7 +++++++
 .claude/commands/test.md    | 36 ++++++++++++++++++++++++++++++++++++
 3 files changed, 78 insertions(+)
 create mode 100644 .claude/commands/build.md
 create mode 100644 .claude/commands/test.md

diff --git a/.claude/commands/build.md b/.claude/commands/build.md
new file mode 100644
index 0000000..10a80cc
--- /dev/null
+++ b/.claude/commands/build.md
@@ -0,0 +1,35 @@
+---
+description: 本地编译与静态检查（后端 go build/vet + 前端 flutter analyze）
+argument-hint: 可选 backend | client，留空则全部
+model: claude-sonnet-4-6
+allowed-tools: Bash
+---
+
+执行本地编译与静态检查，用于快速验证代码可编译、无警告。**不产出发布制品**（多平台打包由 CI 在发版时完成）。
+
+参数 `$ARGUMENTS`：
+- 留空：检查后端 + 前端
+- `backend`：仅检查后端
+- `client`：仅检查前端
+
+任意步骤失败立即停止并报告错误（贴出关键错误输出）。
+
+## 后端检查（参数为空或 backend 时执行）
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+cd backend && go build ./...   # 1. 编译通过
+cd backend && go vet ./...     # 2. 无编译警告
+```
+
+## 前端检查（参数为空或 client 时执行）
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+cd client && flutter analyze --no-fatal-infos --no-fatal-warnings   # error 才算失败，warning/info 允许
+```
+
+## 完成报告
+
+全部通过后，用一行 `result:` 汇总（如 `result: 后端 build+vet 通过、前端 analyze 无 error`）。
+任一失败则停止，指出失败的命令和原因。
diff --git a/.claude/commands/release.md b/.claude/commands/release.md
index 5336b40..8ccc3df 100644
--- a/.claude/commands/release.md
+++ b/.claude/commands/release.md
@@ -1,3 +1,10 @@
+---
+description: 执行本地发版流程（build → test → CHANGELOG → commit → tag → push）
+argument-hint: <version> 如 1.0.22
+model: claude-sonnet-4-6
+allowed-tools: Bash, Read, Edit, Write
+---
+
 执行本地发版流程，版本号为 $ARGUMENTS。
 
 按以下步骤顺序执行，任意步骤失败立即停止并报告错误。
diff --git a/.claude/commands/test.md b/.claude/commands/test.md
new file mode 100644
index 0000000..9ea5bf1
--- /dev/null
+++ b/.claude/commands/test.md
@@ -0,0 +1,36 @@
+---
+description: 运行本地测试（后端 go test + 前端 flutter test）
+argument-hint: 可选 backend | client，留空则全部
+model: claude-sonnet-4-6
+allowed-tools: Bash
+---
+
+运行本地自动化测试。任意用例失败立即停止并报告（贴出失败用例与关键输出）。
+
+参数 `$ARGUMENTS`：
+- 留空：后端 + 前端
+- `backend`：仅后端
+- `client`：仅前端
+
+## 后端测试（参数为空或 backend 时执行）
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+cd backend && go test ./...
+```
+
+不得有 FAIL。`[no test files]` 属正常（该包无测试）。
+
+## 前端测试（参数为空或 client 时执行）
+
+```bash
+export PATH="/opt/homebrew/bin:$PATH"
+cd client && flutter test
+```
+
+须 `All tests passed!`。
+
+## 完成报告
+
+全部通过后用一行 `result:` 汇总（如 `result: 后端 go test 全过、前端 121 测试全过`）。
+任一失败则停止，列出失败用例名与原因，不要自行修改业务代码（如需修复，告知用户或交给对应 coder）。