Doc Organizer

不应放文档的目录

整理标记

已整理的文档在开头添加标记：

<!-- organized: true -->

检查此标记避免重复整理。

工作流程

1. 扫描文档

find . -type f -name "*.md" | grep -v "^\./\.claude" | grep -v "^\./skills" | grep -v "^\./\.git" | grep -v "^\./data"

2. 检查目录位置

对每个文档检查当前目录是否合适：

位置检查规则：

1. 根目录：仅允许 README.md，其他文档需移动
2. data/ 目录：不应有 .md 文档，需移动
3. 根据文档内容判断是否在正确分类目录

内容分类判断：

• 标题/内容包含 "Rust/Python/Java/Go" 等 → 笔记/技术/
• 标题/内容包含 "Claude/Anthropic/Agent" → 笔记/anthropic/
• 标题/内容包含 "项目/方案/调研" → 项目/
• 标题/内容包含 "述职/报告/年度" → 归档/
• 从网上复制的教程/文章 → 收藏/

移动操作：

1. 识别需要移动的文档
2. 确定目标目录（如不存在则创建）
3. 移动文档到目标目录
4. 记录移动操作

3. 内容清洗

对于从网上复制的文档，执行以下清洗：

去除内容：

• 多余的 HTML 标签（<div>, <span> 等）
• 无意义的注释（如 <!-- more -->, <!-- comments -->）
• 复制时的格式残留（如多余的空行、特殊字符）
• 广告、推广链接
• 无关的版权声明

格式统一：

• 标题层级规范（一级标题仅一个）
• 列表格式统一
• 代码块添加语言标识
• 链接格式统一

4. 内容完善

检查并补充：

• 标题：确保有一级标题，简洁明确
• 日期：如需要可添加创建/更新日期
• 结构：补充缺失的章节
• 摘要：长文档添加简要说明

5. 命名规范

文件命名规则：

• 中文优先：内容为中文时用中文命名
• 英文例外：内容为英文时用英文命名
• 简洁明确：文件名能表达内容含义
• 避免特殊字符：不使用 /\:*?"<>| 等字符

6. 文档合并

合并条件：

• 内容相似度高的文档
• 同一主题的多个碎片文档
• 重复或副本文档

合并方式：

1. 识别内容相似的文档
2. 询问用户确认是否合并
3. 合并到较完整或命名更好的文档
4. 删除冗余副本

7. 添加整理标记

在文档开头添加：

<!-- organized: true -->

8. 完整性检查

# 查找未整理的文档
find . -type f -name "*.md" | grep -v "^\./\.claude" | grep -v "^\./skills" | grep -v "^\./\.git" | grep -v "^\./data" | while read f; do
  if ! grep -q "<!-- organized: true -->" "$f"; then
    echo "$f"
  fi
done

检查结果：

• 如有未整理文档 → 标记为 FAIL，继续整理
• 全部已整理 → 标记为 SUCCESS

输出格式

## 整理结果

- 整理文档: X 篇
- 移动文档: X 个
- 合并文档: X 组
- 重命名: X 个
- 删除: X 个
- 状态: SUCCESS / FAIL

### 移动详情

[原路径] → [新路径]

### 其他操作

[列出主要操作]

### 未整理文档 (如有)

[列出需要手动处理的文档]

注意事项

1. 保护目录不改动：skills/, .claude/, .git/, data/ 等目录不做任何修改
2. 确认后执行：合并、删除操作先询问用户
3. 保留原始信息：合并时保留所有有价值的内容
4. 循环检查：FAIL 状态必须继续整理直到 SUCCESS
5. 目录位置优先：先检查并移动放错位置的文档