القائمة
Use when working on Sake configuration — .sake.yml, environment variables, CLI options, ConfigManager, ConfigResolver, or adding new config options.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when working on CI workflows, GitHub Actions, release process, changelog generation (git-cliff), or dependabot configuration.
Use when working on SakeCLI or SakeCLILibrary targets — CLI entry point, config resolution, SakeAppManager build/run lifecycle, error handling, shell execution.
Use when writing or modifying Sake commands, CommandGroups, SakeApp files, or SakeApp/ directory code. Covers Command struct, dependencies, skipIf, context, storage, subprocess patterns, argument parsing.
Use when writing or updating Sake documentation — VitePress site structure, existing pages, how to add new docs, documentation conventions.
Use when modifying the @CommandGroup macro in SakeMacros target — SwiftSyntax ExtensionMacro, code generation patterns, testing with assertMacroExpansion.
Use when writing or running tests for the Sake project — unit tests, macro expansion tests, integration tests, test helpers, and CI test commands.
| name | sake-config-system |
| description | Use when working on Sake configuration — .sake.yml, environment variables, CLI options, ConfigManager, ConfigResolver, or adding new config options. |
Priority (highest first): CLI args → ENV vars → .sake.yml → defaults
CLIConfig → from ArgumentParser options (CommonOptions, CommandRelatedCommonOptions)
ENVConfig → from ProcessInfo.processInfo.environment
FileConfig → from .sake.yml via Yams
Config → resolved final config
ConfigResolver → merge logic
ConfigManager → orchestrates loading + resolution
| Option | CLI | ENV | .sake.yml | Default |
|---|---|---|---|---|
| Config path | --config-path | SAKE_CONFIG_PATH | — | .sake.yml |
| SakeApp path | --sake-app-path | SAKE_APP_PATH | sake_app_path | ./SakeApp |
| Prebuilt binary | --sake-app-prebuilt-binary-path | SAKE_APP_PREBUILT_BINARY_PATH | sake_app_prebuilt_binary_path | nil |
| Case strategy | --case-converting-strategy | SAKE_CASE_CONVERTING_STRATEGY | case_converting_strategy | keepOriginal |
| Experimental | — | SAKE_EXPERIMENTAL_FEATURES | — | disabled |
Mutual exclusion: sakeAppPath and sakeAppPrebuiltBinaryPath cannot both be set.
case_converting_strategy: toSnakeCase # keepOriginal | toSnakeCase | toKebabCase
sake_app_path: SakeApp
sake_app_prebuilt_binary_path: .build/prebuilt/SakeApp
Parsed with Yams library. FileConfig is Decodable.
enum CaseConvertingStrategy: String, CaseIterable, ExpressibleByArgument, Decodable, Sendable {
case keepOriginal // helloWorld → helloWorld
case toSnakeCase // helloWorld → hello_world
case toKebabCase // helloWorld → hello-world
}
Applied by CommandNameCaseConverter to command names when listing/running.
ConfigManager.Error:
.configFileNotFound(configPath:)
.configFileCorrupted(configPath:, error:)
ConfigResolver.Error:
.mutualExclusiveOptions(["sakeAppPath", "sakeAppPrebuiltBinaryPath"])
Sources/SakeCLILibrary/Config/Config.swift — Config struct + defaults
Sources/SakeCLILibrary/Config/CLIConfig.swift — from CLI args
Sources/SakeCLILibrary/Config/ENVConfig.swift — from env vars
Sources/SakeCLILibrary/Config/FileConfig.swift — from .sake.yml
Sources/SakeCLILibrary/Config/ConfigManager.swift — orchestration + resolver
Sources/SakeCLILibrary/CommonOptions.swift — ArgumentParser option groups
Sources/SakeShared/CaseConvertingStrategy.swift — enum