代码文档自动归类 v3.2：图片与图标智能分类

背景

v3.1.2 新增的 /docs-check 命令确实解决了一个实际痛点——自动检测并迁移旧版文档结构。但遗留了一个明显的盲区：项目里的图片文件完全不在扫描范围内。

试想一下，icon.svg、logo.png、设计稿、架构图、测试截图……这些文件分散在项目各处，而 /docs-check 只处理 .md 文件，图片全部被跳过。更不合理的是，像 icon.svg 这样的设计资产，竟和 fa vicon.ico 一样被一视同仁地排除在外。

v3.2.0 专门填补了这一空缺。

v3.2.0 更新要点

 复制代码️ 图片归类支持  │   icon/logo 归 design/  │  ️ 关键词规则升级
 代码变更：+231 行 / -53 行，5 个文件

核心改进

1. 图片文件纳入归类

之前仅覆盖 .md，现在扫描范围正式扩展到图片文件：

 复制代码# 文档
**/*.md# 图片（新增！）
**/*.png
**/*.jpg
**/*.jpeg
**/*.gif
**/*.webp
**/*.svg

归类示例清晰展示：

 复制代码mapping = {
    # 文档
    "README.md": "other/",
    "docs/PRD.md": "requirements/",
    "docs/architecture.md": "technical/",    # 图片（新增！）
    "docs/architecture-diagram.png": "technical/",
    "docs/ui-mockup.png": "design/",
    "docs/figma-export.jpg": "design/",
    "docs/test-screenshot.png": "testing/",
    "docs/flowchart.svg": "design/",
    "icon.svg": "design/",          # UI 图标归 design/
    "logo.svg": "design/",          # 项目 logo 归 design/
}

2. icon/logo 归类修正

旧版行为： icon.svg 和 fa vicon.ico 一样被排除。
新版行为： 只有 fa vicon.* 被排除，icon.* / logo.* 归类到 design/。

3. 关键词规则增强

新增一批关键词，图片和文档均可按规则自动归类：

4. 图片归类特殊规则

• 默认归 design/ — 图片多与设计相关，符合直觉
• 含 screenshot/bug → testing/
• ️ 含 architecture/er-diagram → technical/
• 含 flowchart/mockup → design/

全部指令列表（6 个）

升级步骤

 复制代码# 一行命令完成升级
/plugin uninstall code-documents-auto@code-documents-auto-skill && 
rm -rf ~/.claude/plugins/cache/code-documents-auto-skill && 
/plugin install code-documents-auto@code-documents-auto-skill

然后在现有项目中执行一次：

 复制代码/docs-check    #  自动迁移 + 图片归类

使用建议

1. 升级后运行 /docs-check，项目中散落的图片将被自动归类
2. 纯前端项目图标多，现在 icon/logo 都能准确归到 design/ 目录
3. 测试截图放在项目中也无需担心，screenshot 关键词自动归入 testing/

链接

GitHub 仓库：github.com/Leo-skye-ta…

从 v3.1.2 到 v3.2.0 的完整变更日志：github.com/Leo-skye-ta…