菜单
Use when changing AHKFlowApp appsettings, options binding, user-secrets, App Service configuration, or environment config.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | dck-configuration |
| description | Use when changing AHKFlowApp appsettings, options binding, user-secrets, App Service configuration, or environment config. |
AHKFlowApp uses committed safe defaults in appsettings.json, gitignored local development files, dotnet user-secrets for local backend secrets, and Azure App Service Configuration for TEST/PROD runtime settings. Key Vault appears in older/planned deployment notes, but it is not the current primary secrets path.
.env files.wwwroot/appsettings*.json values are downloadable by users.Backend secrets:
dotnet user-secrets set "AzureAd:TenantId" "<tenant-id>" --project src/Backend/AHKFlowApp.API
dotnet user-secrets set "AzureAd:ClientId" "<client-id>" --project src/Backend/AHKFlowApp.API
The helper script scripts/setup-dev-entra.ps1 sets backend user-secrets and writes the frontend wwwroot/appsettings.Development.json.
Deployment scripts set App Service configuration values:
az webapp config appsettings set --name <app> --resource-group <rg> --settings KEY=VALUE
Use App Service Configuration for backend TEST/PROD secrets and operational settings. Treat Key Vault as a future option unless the current task explicitly provisions and wires it.
public sealed class ScriptGenerationOptions
{
public const string SectionName = "ScriptGeneration";
[Range(1, 10000)]
public int MaxDefinitionsPerScript { get; init; } = 1000;
}
builder.Services.AddOptions<ScriptGenerationOptions>()
.BindConfiguration(ScriptGenerationOptions.SectionName)
.ValidateDataAnnotations()
.ValidateOnStart();
Use IOptions<T> for stable singleton settings, IOptionsSnapshot<T> for scoped reloadable settings, and IOptionsMonitor<T> for singleton services that must observe changes.
| Surface | Config source |
|---|---|
| API local secrets | dotnet user-secrets |
| API TEST/PROD secrets | Azure App Service Configuration |
| Blazor WASM public config | wwwroot/appsettings*.json and deploy substitution |
| CLI shipped defaults | src/Tools/AHKFlowApp.CLI/appsettings.json patched during packaging |
| Worktree local dev | setup/remove worktree scripts |
IConfiguration["Some:Key"] throughout business services.appsettings.Development.json values.| Scenario | Recommendation |
|---|---|
| Backend local secret | dotnet user-secrets |
| TEST/PROD backend secret | App Service Configuration |
| Service setting | Options class with validation |
| Frontend public endpoint/client ID | Blazor appsettings/deploy substitution |
| New secret store | Plan infra, deployment, local dev, and tests together |
Use when creating, removing, or troubleshooting AHKFlowApp git worktrees across Claude Code, Codex, or Copilot.
Use when optimizing AHKFlowApp agent workflow, worktrees, planning, verification loops, context budget, or tool usage.
Use when verifying AHKFlowApp build, tests, formatting, diagnostics, security, or readiness before commit, push, or PR.
Compact the current conversation into a handoff document for another agent to pick up.
Use to scan .NET code for performance anti-patterns across async, memory, strings, collections, LINQ, regex, and I/O.
Use to evaluate assertion depth and diversity across a test suite and flag assertion-free, shallow, or tautological tests.