Knowledge Base Organizer

整理本地知识库，包括文件合并、重命名、去重、索引更新等。使用当用户需要整理知识库、合并重复内容、统一文件命名格式、更新目录索引时。适用于 Markdown 文档、脚本文件、配置文件等知识库内容的整理。

Security Scan

The skill's files and runtime instructions are consistent with its stated purpose (local knowledge‑base reorganization); it requests no credentials or installs, but it performs destructive file operations so you should backup and use the provided --dry-run first.

Purpose & Capability

Name/description match the included SKILL.md and the shell script: both focus on scanning, renaming, merging suggestions, and updating README.md for a local knowledge base. No unrelated credentials, binaries, or config paths are requested.

Instruction Scope

Instructions explicitly read, rename (mv), and delete (rm) local files under a user-specified path — this is within scope. However these are destructive operations: SKILL.md and the script recommend backing up and provide a --dry-run. The SKILL.md also contains example rm commands; users should be aware examples could be executed if they follow them manually or if future script changes implement deletions.

Install Mechanism

No install spec is present and the skill is instruction-only with one included bash script. Nothing is downloaded or written to disk by an installer, which minimizes install-time risk.

Credentials

The skill requires no environment variables, credentials, or config paths. It only acts on a path provided by the user, which is proportional to the stated functionality.

Persistence & Privilege

always is false and the skill does not request permanent system presence or modification of other skills. The script runs only when invoked and prompts for confirmation before performing actions (unless used in dry-run mode).

Assessment

This skill appears coherent and does what it claims — it inspects and can rename/delete local files. Before using it: 1) Inspect the script yourself (organize-knowledge-base.sh) to confirm behavior. 2) Always run with --dry-run first to see suggested actions. 3) Make a backup or use version control for the target directory. 4) Run as a non-root user and point it only at directories you control. 5) Be cautious about following rm/mv examples in SKILL.md without review. If the skill will be invoked autonomously by an agent, consider restricting which directories the agent may act on or require explicit user confirmation for destructive steps.

概述

本技能提供本地知识库整理的完整流程，包括文件合并、重命名、去重、索引更新等操作。适用于 OpenClaw 资料库、技术文档、项目文档等知识库的整理。

整理原则

1. 仔细查阅目录索引 README.md - 在整理前先了解现有结构
2. 将同类型内容整理到一个文件内 - 合并重复或相关的内容
3. 其他未做修改的文件不需要更改阅读 - 只处理需要修改的文件
4. *所有文件名需按"- 01 - "编号 - 统一命名格式
5. 添加或修改完文件后，更新索引目录 - 保持 README.md 同步

整理流程

步骤 1：分析现有结构

# 查看知识库目录结构
ls -la /path/to/knowledge-base/

# 查看现有文件列表
find /path/to/knowledge-base/ -type f -name "*.md" | sort

步骤 2：识别重复内容

# 查看所有 Markdown 文件
for file in /path/to/knowledge-base/*.md; do
  echo "=== $file ==="
  head -20 "$file"
done

步骤 3：合并重复内容

合并原则：

• 将相关主题的内容合并到一个文件
• 保留所有重要信息，不删减非重复内容
• 使用清晰的章节标题组织内容

合并示例：

• 原：02-安装.md + 07-卸载.md → 新：- 02 - 安装与卸载.md
• 原：03-配置.md + 06-管理.md + 08-更新.md → 新：- 03 - 配置与管理.md

步骤 4：重命名文件

命名格式： - <编号> - <标题>.md

重命名命令：

# 单个文件重命名
mv "old-name.md" "- 01 - new-name.md"

# 批量重命名（需要手动调整编号）
for file in *.md; do
  # 根据内容确定编号和标题
  mv "$file" "- XX - title.md"
done

步骤 5：删除旧文件

# 删除已合并的旧文件
rm "old-file-1.md"
rm "old-file-2.md"

步骤 6：更新索引目录

更新 README.md：

1. 更新文件结构列表
2. 更新每个文件的内容说明
3. 添加整理原则说明

README.md 模板：

# 知识库索引

## 文件结构

### - 01 - 文件名.md
- 内容说明 1
- 内容说明 2

### - 02 - 文件名.md
- 内容说明 1
- 内容说明 2

## 整理原则

1. 仔细查阅目录索引 README.md
2. 将同类型内容整理到一个文件内
3. 其他未做修改的文件不需要更改阅读
4. 所有文件名需按"- 01 - *"编号
5. 添加或修改完文件后，更新索引目录

步骤 7：验证整理结果

# 查看整理后的文件列表
ls -lh /path/to/knowledge-base/

# 验证文件命名格式
ls /path/to/knowledge-base/ | grep "^- [0-9][0-9] -"

# 检查 README.md 是否更新
cat /path/to/knowledge-base/README.md

常见场景

场景 1：合并安装和卸载文档

原文件：

• 02-安装.md
• 07-卸载.md

操作：

1. 读取两个文件内容
2. 合并到一个新文件：- 02 - 安装与卸载.md
3. 删除旧文件
4. 更新 README.md

场景 2：合并配置相关文档

原文件：

• 03-配置.md
• 06-管理.md
• 08-更新.md

操作：

1. 读取三个文件内容
2. 合并到一个新文件：- 03 - 配置与管理.md
3. 删除旧文件
4. 更新 README.md

场景 3：统一脚本文件命名

原文件：

• script1.sh
• script2.sh

操作：

1. 重命名：- 01 - script1.sh
2. 重命名：- 02 - script2.sh
3. 创建或更新 scripts/README.md

注意事项

1. 备份重要文件 - 在删除或合并前先备份
2. 保留所有信息 - 只删除重复内容，不删减非重复内容
3. 统一命名格式 - 严格按照"- 01 - *"格式命名
4. 更新索引 - 每次修改后都要更新 README.md
5. 验证结果 - 整理完成后验证文件列表和内容

资源

scripts/

organize-knowledge-base.sh

知识库整理自动化脚本

功能：

• 自动分析目录结构
• 识别重复内容
• 生成整理建议
• 执行文件重命名

使用方法：

bash /path/to/skill/scripts/organize-knowledge-base.sh /path/to/knowledge-base

参数：

• 第一个参数：知识库路径
• --dry-run：只显示建议，不执行操作
• --help：显示帮助信息

示例

示例 1：整理 OpenClaw 资料库

输入：

knowledge-base/
├── 01-API密钥管理.md
├── 02-安装.md
├── 03-配置.md
├── 04-飞书配置.md
├── 05-备份.md
├── 06-管理.md
├── 07-卸载.md
├── 08-更新.md
└── README.md

输出：

knowledge-base/
├── - 01 - API密钥管理.md
├── - 02 - 安装与卸载.md
├── - 03 - 配置与管理.md
├── - 04 - 飞书配置.md
├── - 05 - 备份.md
└── README.md

示例 2：整理脚本目录

输入：

scripts/
├── script1.sh
├── script2.sh
└── README.md

输出：

scripts/
├── - 01 - script1.sh
├── - 02 - script2.sh
└── README.md

故障排查

问题 1：文件重命名失败

原因： 文件名包含特殊字符或空格

解决：

# 使用引号包裹文件名
mv "old name.md" "- 01 - new-name.md"

问题 2：合并后内容丢失

原因： 合并时遗漏了某些内容

解决：

1. 检查原始文件是否已备份
2. 重新读取原始文件内容
3. 重新合并，确保所有内容都包含在内

问题 3：README.md 未更新

原因： 忘记更新索引目录

解决：

1. 检查文件列表是否正确
2. 更新 README.md 中的文件结构
3. 验证每个文件的内容说明

最佳实践

1. 先备份再操作 - 在删除或合并前先备份原始文件
2. 小步快跑 - 每次只处理一个主题，避免一次性修改太多
3. 及时验证 - 每完成一个步骤就验证结果
4. 保持同步 - README.md 始终与实际文件结构保持同步
5. 记录变更 - 在 README.md 中记录整理历史