Vue Doctor ​

打开目标 Vue 仓库，让 AI 使用 /vue-doctor。它会运行 dh-ai doctor，读取健康分和 Top 问题，按任务清单分批修复，再做增量复检。

Doctor 负责找问题，Skill 负责指导 Agent 改代码。完整命令、报告样例和规则说明见 Vue Doctor 项目健康检查。

支持 Vue 2 / Vue 3，以及 Vite、Vue CLI、Nuxt、Quasar、VitePress 和 VuePress 项目。扫描只在本地进行，不上传源码。

装一次 ​

只按右侧卡片操作：点「复制安装说明」，贴进 Qoder、Cursor、Codex 或 WorkBuddy 的新任务。

装完后必须完全退出 AI 工具再打开。Mac 上 Qoder 用 Command + Q。打开的目录必须是要检查的那个 Vue 仓库。

npm config set @szhn:registry https://npmmirror.digitalhainan.com.cn/
npm install -g @szhn/ai-cli@latest
dh-ai skill init frontend/vue-doctor --tool qoder --scope user

dh-ai doctor install

确认已经装上 ​

新会话里看两件事：

1. 能调用 /vue-doctor（Codex 是 $vue-doctor）。
2. 当前目录能执行 dh-ai doctor . --score。

第一次检查 ​

在目标 Vue 仓库新开任务：

/vue-doctor

扫描当前项目，按 Top 问题分批修复，每批修完再复检。

Codex 把 /vue-doctor 换成 $vue-doctor。也可以直接说「用 vue-doctor 检查这个 Vue 项目并修复」。

提交前或刚改完代码时：

/vue-doctor

只检查这次改动新引入的问题，有回归就修。

Agent 会：

1. 运行 dh-ai doctor . --verbose
2. 阅读 .dh-doctor/tasks.md 和 .dh-doctor/report.json
3. 只修本轮 Top 问题，不顺手重构
4. 每批修完再跑 dh-ai doctor . --verbose --scope changed

适合交给 Agent 的问题通常是局部、机械、可复检的改动，比如补稳定 key、给图片补 alt、给外链补 rel、把全量 lodash 改成按需引入。

安全、权限、接口封装、路由兜底、构建失败这类问题，Agent 应先停下来确认边界，再改具体代码。

推荐顺序 ​

1. 在业务仓库里装好本文的 Skill。
2. /vue-doctor 做一次摸底，看健康分和 Top 问题。
3. 按任务清单分批修复，每批只复检改动。
4. 提交前再跑一次增量检查。
5. 发版前需要看包体积时，在工具文档里使用 dh-ai doctor . --build。

更新和卸载 ​

npm install -g @szhn/ai-cli@latest
dh-ai skill init frontend/vue-doctor --tool qoder --scope user

已安装时这条命令会覆盖为当前内置版本。卸载：

dh-ai skill remove --skill frontend/vue-doctor --tool qoder --scope user

删除时 --tool 和 --scope 要和安装时一致。之后同样完全退出再打开 AI 工具。

常见问题 ​

没有 Node，也不会用终端。 点右侧「复制安装说明」贴进 AI 新任务。Mac 和 Windows 都可以。第一次装 Node 时可能要输入电脑密码。

Skill 已装，但跑不了 doctor。 先执行 dh-ai --version。没有命令时，按安装说明装 @szhn/ai-cli。

只想看报告，不让 AI 改代码。 用 工具文档 里的 npx dh-ai doctor .，打开 .dh-doctor/report.html。

规则误报。 先确认是不是测试、mock、生成代码或历史包袱。不要为了消掉提示去改业务行为；需要跳过时再配 doctor.config.json。

相关链接 ​

• Vue Doctor 项目健康检查
• dh-ai CLI 使用说明