Knowledge Base Organizer

概述

本技能提供本地知識庫整理的完整流程，包括檔案合併、重新命名、去重、索引更新等操作。適用於 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 未更新

來源於7w4.net。

原因： 忘記更新索引目錄

解決：

1. 檢查檔案列表是否正確
2. 更新 README.md 中的檔案結構
3. 驗證每個檔案的內容說明

最佳實踐

1. 先備份再操作 - 在刪除或合併前先備份原始檔案
2. 小步快跑 - 每次只處理一個主題，避免一次性修改太多
3. 及時驗證 - 每完成一個步驟就驗證結果
4. 保持同步 - README.md 始終與實際檔案結構保持同步
5. 記錄變更 - 在 README.md 中記錄整理歷史