Agent Skills
› UsefulSoftwareCo/executor
› wrdn-effect-atom-reactivity-keys
wrdn-effect-atom-reactivity-keys
GitHub修复 Effect-atom 写入突变时缺少无效化键的问题，指导在 useAtomSet 调用中添加 reactivityKeys 以明确数据依赖，确保状态一致性。
Trigger Scenarios
lint 提示 useAtomSet 突变缺少 invalidation keys
需要为 effect-atom 写入操作添加细粒度缓存失效键
Install
npx skills add UsefulSoftwareCo/executor --skill wrdn-effect-atom-reactivity-keys -g -y
SKILL.md
Frontmatter
{
"name": "wrdn-effect-atom-reactivity-keys",
"description": "Add reactivityKeys to effect-atom write mutation calls. Use when lint flags a useAtomSet mutation call that mutates data without invalidation keys.",
"allowed-tools": "Read Grep Glob Bash"
}
Effect-atom write mutations must say which reads they invalidate.
Fix Shape
- Find the
useAtomSet(...)write mutation call. - Add
reactivityKeysto the mutation payload at the call site. - Use the narrowest keys that cover the rows/lists affected by the write.
- Keep read-only probe/preview OAuth flows out of this pattern.
- If the mutation should update UI immediately, check whether
wrdn-effect-atom-optimisticalso applies.
Good
await updateSource({
params: { scopeId, sourceId },
payload,
reactivityKeys: [["sources", scopeId]],
});
Version History
- fd4fb02 Current 2026-07-05 10:55
