菜单
Add frontend-callable Go backend method (Wails binding round-trip). Use whenever frontend needs new data or action from backend — new App method, regenerate bindings, api.ts wrapper, test stub, mock updates. Also use when binding call mysteriously returns undefined.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
GitHub Actions CI pipeline conventions — job shape, caching, permissions, and action pinning. Use when asked to "set up CI", "add a GitHub Actions workflow", "fix the pipeline", or when creating/reviewing files under .github/workflows/ for Go or Node/TS projects.
Systematic root-cause debugging — reproduce, isolate, fix at the source, prove the fix. Use when the user reports a bug, an error, a crash, flaky behavior, "this doesn't work", "why is this failing", or pastes a stack trace or failing test output.
Production Go service conventions — project layout, config, slog logging, context propagation, graceful shutdown, error wrapping, plain-constructor DI, and table-driven tests. Use when building or reviewing a Go backend service or worker; triggers when the repo contains go.mod plus a long-running-process signal (HTTP/queue/DB usage, cmd/ layout), or when the user asks how to structure a Go service. For TUIs use go-tui; for desktop apps use wails3 — this skill's config/logging/error conventions still apply to their Go code.
Conventions for building Go terminal UIs with Bubble Tea v2, Bubbles v2, and Lip Gloss v2 (charm.land module path). Covers Elm-architecture discipline, tea.Cmd/tea.Msg side effects, sub-model composition, keymaps, styling, and testing. Use when writing or reviewing a Go TUI, terminal UI, or interactive CLI screen; when the user says "bubbletea", "bubbles", "lipgloss", "TUI", "terminal UI", or "charm"; or when go.mod imports charm.land/bubbletea, charm.land/bubbles, charm.land/lipgloss, or github.com/charmbracelet/bubbletea (v1 — flag for migration).
Behavior-preserving restructuring done safely — test net first, small verified steps, no mixed-in feature changes. Use when the user says "refactor", "clean up", "restructure", "extract", "rename", "split this file/function", "reduce duplication", or "make this testable".
Automated releases with conventional commits, release-please, and tag-triggered build workflows. Use when asked to "set up releases", "automate versioning", "add a changelog", "tag a release", "configure release-please", or "publish binaries on tag" — and when touching release-please-config.json, .release-please-manifest.json, .goreleaser.yml, or a CHANGELOG.md maintained by a bot.
| name | add-bound-method |
| description | Add frontend-callable Go backend method (Wails binding round-trip). Use whenever frontend needs new data or action from backend — new App method, regenerate bindings, api.ts wrapper, test stub, mock updates. Also use when binding call mysteriously returns undefined. |
Frontend never touch network/disk/CPU. New I/O = bound Go method. Round-trip = ONE change, 4 mandatory steps — skip any step = silent fail (no error, just undefined).
*App in internal/app/app*.go (pick file matching feature area: app_git.go, app_secrets.go, app_features.go, …). Return (T, error).task generate:bindings. Regens frontend/bindings/ (gitignored — never hand-edit).frontend/src/lib/api.ts — thin typed re-export. Components import from api.ts only, never from bindings/ direct.frontend/src/test-stubs/app.ts — one line: export const MyMethod = method("MyMethod");. Vitest + dev-mock alias bindings to this file; missing stub = call undefined at runtime, NO error.frontend/tests/e2e/ will call it → also add method to frontend/src/lib/devMock.ts (e2e webServer run bun run dev:mock). Missing devMock method = silent no-op, spec timeout, no error.Git*/meta method touched by CollectionSettings.tsx/FolderSettings.tsx/SourceControlPanel.tsx → also add to tests/visual/mock-backend.mjs.go-git/v5 library only, never shell out to git binary.refreshCollection in frontend/src/lib/actions.ts — single choke point.model.Collection → add to BOTH hand-copy sites in internal/store/store.go (ReadMeta AND SaveCollection copy fields explicit) or silent no-persist.go test ./...cd frontend && bun run typecheck (catch missing api.ts wrapper)test-stubs/app.ts for method name (typecheck NOT catch missing stub)