code-documents-auto-skill v3.1.2：新增 /docs-check：一个命令自动修复旧文档结构

前言

上次 v3.1.1 发布了智能助手 /docs，一个命令让 AI 自动识别意图。这次 v3.1.2 解决了一个更实际的问题：从旧版升级上来的项目，文档结构全是旧的，手动迁移太痛苦。

于是 /docs-check 诞生了——检测 + 自动迁移，零手动操作。

v3.1.2 更新概览

 复制代码 1 个新指令  │   4 大新特性  │   3 个问题修复
 代码变更：+2083 行 / -189 行，9 个文件

头号新功能：/docs-check

检测 + 自动迁移

 复制代码$ /docs-check
 文档结构检测 + 迁移完成
 changelog 结构:  → 
 表格格式:    5 列 → 8 列
 docs/ 子目录: 缺失 → 已创建
 标题质量:    不合格 → 已改进

检测范围和自动修复对照：

四大新特性

1. 智能文档归类

旧行为： 扫到 1 个文档问 1 次，用 cp 复制（原位置保留双份文件） 新行为： 扫到 10 个文档只问 1 次，用 mv 移动（原位置不再保留，更清爽）

关键改进：

• mv 替代 cp — 原位置不再保留双份文件
• 自动排除 CLAUDE.md 和 AGENTS.md — 工作流文件留在原位
• 批量处理 — 10 个文档 = 1 次提示，不是 10 次

2. 前端项目智能识别

一个项目，一次扫描，只生成你需要的文档：

3. 统一 Changelog 结构

首次扫描现在和归档使用相同的文件夹结构，终于一致了：

 复制代码   升级前 (v3.1.0):
  changelog/
  └── 2026-06-16-initial-scan.md   ← 单文件   升级后 (v3.1.2):
  changelog/
  └── 2026-06-16-initial-scan/
      ├── overview.md
      ├── files.md
      ├── technical.md
      ├── impact.md
      ├── testing.md
      └── deployment.md

4. 升级 Changelog 表格

标题列不再只填 "feat"，现在有实际描述了：

 复制代码- | 2026-06-16 | feat | ... |
+ | 2026-06-16 | 添加智能助手命令 | 新增 /docs 统一入口 | feat | commands | AI | done |

完整指令清单（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    #  自动迁移到 v3.1.2 格式

使用小贴士

1. 把 /docs-check 加入团队 PR 合并后的工作流
2. 日常开发直接用 /docs <描述>，让 AI 智能路由
3. 纯前端项目用 /docs-scan 现在更快了，跳过无关文档

链接

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

如果这个项目对你有帮助，请给个 Star ⭐

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