القائمة
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/)