菜单
Use when adding the HTTP layer for a resource that already has (or will get) a service layer — chains casting-a-service-layer first if the service is missing
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when adding a complete resource to an existing magic-based service — emits migration, types, service layer, and route layer in one pass
Use when bootstrapping a brand-new microservice on github.com/tink3rlabs/magic — clones the service template, applies wizard answers, runs a smoke build
Use when adding domain logic (types + service interface + implementation) for a resource without HTTP — typically because the route is handled differently (worker, scheduled job, internal-only)
Use when the user asks to scaffold or extend a magic-based service and the right cast sequence is ambiguous — runs a question tree and emits a cast plan
Use when a cast needs to verify whether a package, type, or middleware exists in github.com/tink3rlabs/magic — the in-bounds surface for spellcasting templates
Use when modifying an existing resource on a magic-based service — add a column, add a filter, add a role guard, add soft-delete, swap a storage adapter — enforces DTO-completeness on every field change
| name | casting-a-route |
| description | Use when adding the HTTP layer for a resource that already has (or will get) a service layer — chains casting-a-service-layer first if the service is missing |
Emits pkg/routes/<resource>/ with five handlers (List, Get, Create, Update, Delete), validation, table-driven test, and appends the mount line to cmd/server.go. Auto-chains the service layer if missing.
RESOURCE exists at pkg/features/${RESOURCE}/service.go.If the service layer is missing AND the user did not pass --custom:
casting-a-service-layer via the Skill tool, passing the same RESOURCE argument.If --custom was passed (user said e.g. "just the routes, I'll wire it myself"), skip the chain and proceed — leave the service-interface import unresolved and instruct the user to wire it.
RESOURCE (lowercase singular). Same token derivations as casting-a-feature.
mkdir -p "pkg/routes/${RESOURCE}"
cp "${CLAUDE_PLUGIN_ROOT}/templates/route/pkg/routes/RESOURCE/"*.go \
"pkg/routes/${RESOURCE}/"
find "pkg/routes/${RESOURCE}" -type f -name '*.go' \
-exec sed -i.bak \
-e "s/RESOURCETABLE/${RESOURCETABLE}/g" \
-e "s/Resources/${RESOURCES_CAP}/g" \
-e "s/RESOURCES/${RESOURCES}/g" \
-e "s/Resource/${RESOURCE_CAP}/g" \
-e "s/RESOURCE/${RESOURCE}/g" \
-e "s/SERVICENAME/${SERVICENAME}/g" {} \;
find pkg/routes -name '*.go.bak' -delete
Find the block router.Route("/", func(r chi.Router) { and append, after the existing r.Mount lines (or as the first one if none exist):
import_line=' "SERVICENAME/pkg/features/RESOURCE"'
import_line2=' RESOURCEroutes "SERVICENAME/pkg/routes/RESOURCE"'
mount_line=' r.Mount("/RESOURCES", RESOURCEroutes.NewResourceRouter(RESOURCE.NewService(storageAdapter)).Router)'
The agent appends these. Use goimports after the edit to fix import ordering, or gofmt if goimports isn't available.
go vet ./pkg/routes/${RESOURCE}/...
go test ./pkg/routes/${RESOURCE}/...
git add pkg/routes/${RESOURCE}/ cmd/server.go
git commit -m "feat: add ${RESOURCE} route layer"
Routes use chi, chi/render, magic/middlewares.ErrorHandler, magic/errors, and (for guarded subroutes only) magic/middlewares.RequireRole. No project-specific common libraries; no per-resource ACL authorizers beyond RequireRole. See magic-capabilities.
chi.Router: https://pkg.go.dev/github.com/go-chi/chi/v5middlewares.ErrorHandler: https://pkg.go.dev/github.com/tink3rlabs/magic@v0.17.3/middlewares#ErrorHandlermiddlewares.RequireRole: https://pkg.go.dev/github.com/tink3rlabs/magic@v0.17.3/middlewares#RequireRolepkg/routes/)