AgentSkillsCN

alias-guardian

将相对导入重构为tsconfig/Vite别名（如`@/components`），以确保导入的一致性，并使文件移动时仍能保持稳定。

SKILL.md
--- frontmatter
name: alias-guardian
description: "Refactors relative imports into tsconfig/Vite aliases (e.g., `@/components`) to keep imports consistent and resilient to file moves."
license: MIT
triggers:
  - "refactor imports to @/"
  - "apply tsconfig aliases"
  - "clean relative imports"

Alias Guardian

When to use this skill

  • •Run after adding tsconfig path aliases or when many long relative imports exist.
  • •Triggered by prompts to convert ../../.. style imports to @/ aliases.

Instructions

  1. •

    First Step: Ensure tsconfig.json has paths configured ("@/*": ["src/*"]) and vite.config.ts supports the aliases (via vite-tsconfig-paths or manual resolve.alias).

  2. •

    Second Step: Use an AST-based tool (e.g., jscodeshift, ts-morph) or a controlled regex to find and replace relative import paths. Prefer AST to avoid accidental matches.

  3. •

    Third Step: Update affected files' imports to the alias form and run TypeScript to verify no resolution errors.

Examples

  • •Before: import PaperCard from '../../components/molecules/PaperCard'
  • •After: import PaperCard from '@/components/molecules/PaperCard'

Additional Resources

Notes

  • •Always run tests and TypeScript type-check after mass refactors; commit in a dedicated branch and use Git to move files safely.