Agent Skills
› ai-shifu/ai-shifu
› hook-contract-refactor-safety
hook-contract-refactor-safety
GitHub用于安全重构 Hook 契约，确保返回字段或参数变更时，所有调用方的解构与对象同步更新，避免 TS 类型错误。
Trigger Scenarios
重构 Hook 返回字段
修改 Hook 参数
Install
npx skills add ai-shifu/ai-shifu --skill hook-contract-refactor-safety -g -y
SKILL.md
Frontmatter
{
"name": "hook-contract-refactor-safety",
"description": "当重构 hook 返回字段或参数契约时使用本技能。统一同步调用方解构与参数对象，避免大面积 TS 属性错误。"
}
Hook 契约重构安全
核心规则
- 公共 hook 字段改名后，消费方必须同批次同步改名。
- hook 删除参数后，调用对象中的旧字段必须同步移除。
工作流
- 先在 hook 导出类型上完成改名或删参。
- 全局检索调用点并同步更新解构、索引、依赖数组。
- 清理对象字面量中的未知属性。
- 运行定向
tsc或相关测试，确保契约收敛。
Version History
- e65aa77 Current 2026-08-20 15:14
