القائمة
构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Wails Binding 签名一致性。对比 Go 端导出函数 vs 前端 wailsjs。
问题排查记录搜索。按关键词查找 bug-chronicle.md 中的相关 bug。
注释质量检查。检测 AI 废话注释、空 JSDoc、TODO 无编号、调试日志等。
项目结构扫描与 AGENTS.md 更新。扫描 Go 包和前端组件结构，输出文档地图更新建议。
项目健康诊断。一键检查 Go 编译、前端构建、文件完整性、治理红线、配置一致性。
事件注册审计。扫描 EventsOn/bus.on 注册位置是否合规。
| name | build |
| description | 构建与调试流程。Go 后端编译、前端 Vite 构建、完整 Wails 构建、测试。 |
go build ./go/... 2>&1
(cd frontend && npx vite build 2>&1)
wails build -ldflags "-X ysm-model-manager/go/version.Version=vX.X.X"
wails dev
# Go 全部测试
go test ./go/... -count=1
# 指定包测试
go test ./go/paths/... -count=1 -v
pwsh ./build-release.ps1 vX.X.X
前置条件：
docs/release-notes/vX.X.X.md必须已存在。
| 错误 | 原因 | 解决 |
|---|---|---|
undefined: xxx | Go 新增文件未编译 | go build ./go/... 确认语法 |
Module not found | JS import 路径错误 | 检查路径大小写 |
wails: command not found | Wails CLI 未安装 | go install github.com/wailsapp/wails/v2/cmd/wails@latest |
| 构建后功能无变化 | 前端缓存 | Ctrl+Shift+R 硬刷新 |
| Go 改后前端调用无反应 | 未重启 | wails build + 重启应用 |
| 文件 | 职责 |
|---|---|
app.go | Wails Binding 入口 |
main.go | Go 入口 + 窗口参数 |
wails.json | Wails 配置 |
frontend/index.html | 前端入口 |
build-release.ps1 | 完整发版脚本 |