autoservice-config-driven-endpoints

分类: 开发与编程 | 上传者: hajdu-patrik | 下载: 0 | 版本: v1.0（最新）

在 AutoService 中实施配置驱动的 URL/端口和非硬编码端点策略。在添加或修改服务、端口、URL、环境变量、AppHost 连接、vite 配置、启动设置或 API 基本 URL 行为时使用此选项。

更新日志: Source: GitHub https://github.com/hajdu-patrik/ARSM

目录结构

当前层级: tree/main/.claude/skills/autoservice-config-driven-endpoints/

📄 SKILL.md 2.6 KB

SKILL.md

---
name: autoservice-config-driven-endpoints
description: Enforce config-driven URLs/ports and no-hardcoded endpoint policy in AutoService. Use this when adding or modifying services, ports, URLs, env variables, AppHost wiring, vite config, launch settings, or API base URL behavior.
disable-model-invocation: true
---

Use this skill whenever endpoint/port/address changes are involved.

Objective:
- Keep all service URLs and ports fixed in configuration files.
- Avoid hardcoded runtime fallback URLs in source code.
- Keep Aspire wiring as the source of truth for cross-service communication.

Repository policy:
- AppHost config source: AutoServiceApp/AutoService.AppHost/appsettings.json (Ports section).
- API local URL source: AutoServiceApp/AutoService.ApiService/Properties/launchSettings.json.
- API CORS origin source: AutoServiceApp/AutoService.ApiService/appsettings.json and appsettings.Local.json (`Cors:AllowedOrigins`).
- WebUI local source: AutoServiceApp/AutoService.WebUI/.env.development.
- API client must require VITE_API_URL from environment; do not add hardcoded fallback.
- vite serve mode must read PORT from environment and use strictPort true.

Required checks before edits:
1. Identify whether this is a new service or a modification of an existing one.
2. Identify all impacted config files (AppHost, launchSettings, .env, and service code).
3. Confirm there is no existing hardcoded URL fallback that would conflict.

Implementation workflow:
1. Add or update port keys in AppHost appsettings.json (single source of truth).
2. Keep API launch URL explicit in launchSettings.json.
3. Set/update WebUI env values in .env.development.
4. Ensure AppHost injects required endpoint env vars (for example VITE_API_URL).
5. Ensure API CORS `AllowedOrigins` is explicitly configured for the WebUI origin (no permissive wildcard fallback when credentials are used).
6. Update client/service code to read env-driven values only.
7. Verify no hardcoded URL fallback remains.

Validation checklist:
- No new localhost URL literals were introduced in client runtime fallback logic.
- VITE_API_URL is read from environment and required.
- PORT is read from environment in vite config for serve mode.
- API `Cors:AllowedOrigins` includes expected WebUI origins and matches credentialed cross-origin policy.
- AppHost, API, and WebUI settings agree on ports and protocol.
- Existing behavior remains stable after config change.

If a user requests a hardcoded shortcut:
- Explain the repository policy briefly.
- Implement the equivalent config-driven change instead.

When uncertain:
- Prefer minimal, additive config changes.
- Do not rename existing config keys unless explicitly requested.

登录后下载/点赞/收藏 ❤ 8 | ★ 0

autoservice-config-driven-endpoints

目录结构

SKILL.md

举报内容

提示