Agent Skills
› UsefulSoftwareCo/executor
› wrdn-effect-atom-reactivity-keys
wrdn-effect-atom-reactivity-keys
GitHub修复 effect-atom 写入变异调用，为 useAtomSet 添加 reactivityKeys 以指定失效读取范围。确保数据更新时正确触发 UI 刷新，使用最窄键覆盖受影响区域。
Trigger Scenarios
lint 报错 useAtomSet 缺少失效键
手动检查 mutation 是否包含 reactivityKeys
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
