菜单
Add a WorkManager worker to the :data:core layer — a CoroutineWorker controller that orchestrates data sources for background/deferred work, injected by Koin. Use when asked to "add a worker", "background sync", "schedule a job", "periodic refresh", or "do <X> in the background".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | add-worker |
| description | Add a WorkManager worker to the :data:core layer — a CoroutineWorker controller that orchestrates data sources for background/deferred work, injected by Koin. Use when asked to "add a worker", "background sync", "schedule a job", "periodic refresh", or "do <X> in the background". |
A WorkManager worker is a controller (like a repository or a PagingSource):
it decides what background work to do and orchestrates one or more data
sources to do it. It lives in :data:core; the data sources it drives live in
:datasources:*. Scope this skill to one worker + its binding.
Add via the add-dependency skill:
[versions]
work = "2.10.0"
[libraries]
androidx-work-runtime-ktx = { group = "androidx.work", name = "work-runtime-ktx", version.ref = "work" }
koin-androidx-workmanager = { group = "io.insert-koin", name = "koin-androidx-workmanager", version.ref = "koin" }
:data:core needs both (CoroutineWorker + workerOf).:app needs koin-androidx-workmanager (for workManagerFactory()).:data:core, com.ericwafula.rickandmorty.data.<feature>. First two constructor
params are always Context + WorkerParameters; everything after is injected:
internal class CharacterSyncWorker(
context: Context,
params: WorkerParameters,
private val remoteDatasource: CharacterRemoteDatasource,
) : CoroutineWorker(context, params) {
override suspend fun doWork(): Result =
when (remoteDatasource.getCharacters(page = 1)) {
is RemoteResult.Success -> Result.success()
is RemoteResult.Error -> Result.retry()
}
}
workerOf wires the injected params from the graph. Put it in an internal
workerModule included by dataModule:
import org.koin.androidx.workmanager.dsl.workerOf
import org.koin.dsl.module
internal val workerModule = module {
workerOf(::CharacterSyncWorker)
}
// in DataModule.kt: includes(remoteDatasourceModule, repositoryModule, workerModule)
In initKoin add workManagerFactory():
startKoin {
androidLogger()
androidContext(this@initKoin)
workManagerFactory()
modules(dataModule)
}
Then disable WorkManager's default initializer so Koin's factory is used —
in app/src/main/AndroidManifest.xml:
<provider
android:name="androidx.startup.InitializationProvider"
android:authorities="${applicationId}.androidx-startup"
android:exported="false"
tools:node="merge">
<meta-data
android:name="androidx.work.WorkManagerInitializer"
tools:node="remove" />
</provider>
From wherever the work is triggered (often a repository — another controller — or app startup):
WorkManager.getInstance(context).enqueue(
OneTimeWorkRequestBuilder<CharacterSyncWorker>().build()
)
./gradlew :data:core:compileDebugSources :app:assembleDebug --console=plain
(Set JAVA_HOME to a JDK 21 — e.g. an SDKMAN *-jbr — if the shell can't find
Java.)
work-runtime-ktx + koin-androidx-workmanager in :data:core;
koin-androidx-workmanager in :app.internal, extends CoroutineWorker, injects data sources after
the Context, WorkerParameters params.workerOf(::Worker) in an internal module included by
dataModule.workManagerFactory() in initKoin and removes the default
WorkManagerInitializer from the manifest.:data:core compiles and :app:assembleDebug succeeds.Add a screen's composables to a feature module using the Route → Screen → Content structure. Use when asked to "add a screen", "build the <X> screen", "wire up a screen's UI", or to render a feature's state. Pairs with add-viewmodel.
Add a ViewModel to a feature module using the Action / State / Event triad, depending on use case / repository interfaces. Use when asked to "add a viewmodel" or to wire a screen's state, actions, and events. The screen's composables are a separate skill (add-screen).
Add a reusable design-system Composable to the :ui module — stateless, themed via RickAndMortyTheme tokens, with a preview. Use when asked to "add a button", "add a shared component", "add a card/loader/empty state", or to build any reusable UI primitive shared across screens.
Unit-test a use case with hand-written fake repositories. Use when asked to "test a use case", "add use case tests", or to verify a use case's aggregation and error-propagation logic.
Unit-test a ViewModel's Action → State → Event behaviour with fakes. Use when asked to "test a viewmodel", "add viewmodel tests", or to verify a screen's state transitions and one-time events.
Add a repository to :data:core as composable single-unit repositories ([Verb][Name]Repository) encapsulated by a parent contract, each mapping a data source's RemoteResult into DataResult. Use when asked to "add a repository", "wire up a repository", or to expose data-layer operations to domain/presentation.