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

前言

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

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

v3.1.2 更新概览

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

🌟 头号新功能：/docs-check

检测 + 自动迁移

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

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

检测项	旧状态	修复后
changelog 结构	单文件	文件夹 + 6 个核心文档
表格格式	5 列	8 列（含"描述"列）
docs/ 子目录	缺失	5 个标准子目录已创建
标题质量	只填"feat"	从文件夹名改进标题

✨ 四大新特性

1. 智能文档归类

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

关键改进：

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

2. 前端项目智能识别

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

项目类型	database/	middleware/
🎨 纯前端	❌ 跳过	❌ 跳过
⚙️ 纯后端	✅ 生成	✅ 生成
🌐 全栈	✅ 生成	✅ 生成
📚 库/工具	❌ 跳过	✅ 生成
🖥️ 桌面/移动	❌ 跳过	❌ 跳过

3. 统一 Changelog 结构

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

▼
diff
复制代码
  ❌ 升级前 (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"，现在有实际描述了：

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

📦 完整指令清单（6 个）

指令	说明
/docs <描述>	智能助手，自动识别意图
/docs-scan	全量扫描，生成完整文档
/docs-update	增量更新，只更新变更部分
/docs-check	新增！ 检测文档结构并自动迁移
/docs-prepare <任务>	开发前准备，输出开发方案
/docs-archive	归档模式，更新文档

🔄 升级方法

▼
bash
复制代码
# 一行命令升级
/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

然后在已有项目中跑一次：

▼
bash
复制代码
/docs-check    # ✨ 自动迁移到 v3.1.2 格式

💎 使用小贴士

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

链接

GitHub 仓库：https://github.com/Leo-skye-taylor/code-documents-auto-skill

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

---

从 v3.0.0 到 v3.1.2 的完整变更日志：https://github.com/Leo-skye-taylor/code-documents-auto-skill/compare/v3.0.0...v3.1.2