feat: 完善全栈打包质量门禁

在业务开发前补齐 lint、format、verify 与生产运行时契约，确保开发联调和 executable 打包链路可重复验证。

openspec/specs/frontend-development-workflow/spec.md

@@ -26,6 +26,21 @@
 - **WHEN** 浏览器从 Vite 开发源请求非 API 前端路由
 - **THEN** Vite SHALL 将该请求作为前端应用流量处理，而不是转发到后端
 
+### Requirement: 开发期后端端口一致性
+项目 SHALL 保证文档化的全栈开发命令中，Vite proxy 目标端口与 Bun 后端监听端口来自同一配置来源。
+
+#### Scenario: 使用默认开发端口
+- **WHEN** 开发者未提供端口覆盖并运行文档化的全栈开发命令
+- **THEN** Bun 后端 SHALL 监听默认端口，且 Vite SHALL 将 `/api/*` 代理到同一端口
+
+#### Scenario: 使用 PORT 覆盖开发端口
+- **WHEN** 开发者通过 `PORT` 覆盖后端端口并运行文档化的全栈开发命令
+- **THEN** Bun 后端 SHALL 监听该端口，且 Vite SHALL 将 `/api/*` 代理到同一端口
+
+#### Scenario: 避免代理端口与后端端口分叉
+- **WHEN** 开发期脚本需要向 Vite 传递后端端口
+- **THEN** 该代理端口 MUST 从文档化的后端端口配置派生，而不是作为独立对外配置导致分叉
+
 ### Requirement: 前端使用相对 API 路径
 除非有文档化的部署配置覆盖该行为，前端代码 MUST 通过相对 `/api/*` URL 调用后端 API。
 
@@ -55,6 +70,13 @@
 - **WHEN** 开发者运行文档化的全栈开发命令
 - **THEN** 系统 SHALL 启动 Vite 前端开发服务器和 `/api/demo` 所需的 Bun 后端服务器
 
+### Requirement: 开发质量命令文档化
+项目 SHALL 在前端开发工作流文档中说明日常检查和完整验证命令。
+
+#### Scenario: 查阅开发命令
+- **WHEN** 开发者阅读 README 的开发或测试章节
+- **THEN** 文档 SHALL 说明 `check` 用于日常开发检查，`verify` 用于提交前或发布前完整验证
+
 ### Requirement: 共享 TypeScript 契约
 项目 SHALL 为前端和后端共同使用的请求与响应类型提供共享 TypeScript 边界。