Agent Skills › ai-shifu/ai-shifu › module-augmentation-guardrails

module-augmentation-guardrails

GitHub

解决 TypeScript 子路径导出类型丢失或冲突，通过规范模块增强写法避免覆盖上游导出，确保类型声明正确生效。

src/cook-web/skills/module-augmentation-guardrails/SKILL.md ai-shifu/ai-shifu

TypeScript 子路径导出类型丢失类型声明冲突模块增强需避免覆盖上游

npx skills add ai-shifu/ai-shifu --skill module-augmentation-guardrails -g -y

More Options

Non-standard path

npx skills add https://github.com/ai-shifu/ai-shifu/tree/main/src/cook-web/skills/module-augmentation-guardrails -g -y

Use without installing

npx skills use ai-shifu/ai-shifu@module-augmentation-guardrails

指定 Agent (Claude Code)

npx skills add ai-shifu/ai-shifu --skill module-augmentation-guardrails -a claude-code -g -y

安装 repo 全部 skill

npx skills add ai-shifu/ai-shifu --all -g -y

预览 repo 内 skill

npx skills add ai-shifu/ai-shifu --list

Frontmatter

{
    "name": "module-augmentation-guardrails",
    "description": "当 TypeScript 对子路径导出出现类型丢失或声明冲突时使用本技能。通过规范的 module augmentation 写法避免覆盖上游导出。"
}

TypeScript 模块增强防护

改类型前先核对 node_modules 中发布版声明文件。
augmentation 文件必须包含顶层 import "package/subpath"; 与 export {};。
仅增强已导出的 interface；非 interface 结构优先用本地 wrapper 类型。
为子路径组件补扩展 props 时，要 augment 到真实导出子路径（如 markdown-flow-ui/slide），不要误写到相邻模块导致类型表面可用、运行接入点却不生效。