前言¶

用 Agent 或腳本往 Wiki 裏不斷寫 Markdown 時，常見問題是：頁面散落在目錄裏，模型一次只能讀有限上下文，很難知道「庫裏到底有什麼」；事後也很難回答「這條結論是什麼時候、從哪次操作寫進去的」。只靠文件夾瀏覽或全文搜索，成本高，也不利於增量協作。

下面介紹 SkillHub 社區 Skill create-index（座標 @user_6c29a21a/create-index，版本 1.0.0）。它是一套面向 LLM Wiki 的索引與日誌規範及操作指引：用 index.md 做內容導向的全局目錄，用 log.md 記錄攝入、查詢、編輯等操作上下文，讓模型和人類都能導航、發現並追溯知識。

這是什麼¶

create-index 由社區發佈者 user_6c29a21a 維護，分類爲 knowledge-management，來源標註爲 community。官方簡介說明：該 Skill 用於構建和維護智能知識庫索引，通過生成和管理 index.md（內容索引）與 log.md（操作日誌）兩個核心文件，幫助 LLM 與用戶組織、發現和追溯知識。標籤 requires_api_key=false，安裝與使用不依賴額外 API Key。

Skill 本體以通用 SKILL.md 形式交付（安裝包內主要爲 SKILL.md 與 README.md），供 Agent 在維護 Wiki 時按文檔中的結構、字段與流程執行；文檔中還包含索引/日誌示例、協同讀寫流程說明，以及可選的 Python / Shell 解析示例（作爲參考實現，而非單獨的可執行腳本包）。

核心功能¶

結合官方 SKILL.md 與 README.md，可覈實的能力包括：

1. index.md（內容索引）
   - 承擔知識庫「目錄」：分類組織、一行摘要、元數據（如 tags、status、updated 等）。
   - 支持導航（目標明確時縮小範圍）、發現（瀏覽分類與標籤）、概覽（評估覆蓋與結構）。
   - 設計原則包括適度分層分類、每條條目一行摘要、元數據字段保持一致。

2. log.md（操作日誌）
   - 記錄 INGEST、QUERY、EDIT、LINT、SYNTHESIZE 等操作類型，帶時間戳、會話 ID、標籤與觸發查詢、來源、處理過程等字段。
   - 用於可追溯性、調試與增量學習的證據鏈；文檔給出結構化條目格式，並示例用 grep、awk 等 Unix 工具做統計與篩選。

3. 兩者協同
   - 寫入：攝入或修改頁面時，同步更新頁面文件、index.md 條目，並向 log.md 追加記錄。
   - 讀取：先讀 index.md 建立全局認知，必要時查 log.md 瞭解時效與歷史，再加載具體頁面。
   - 進階：文檔描述分層索引（根索引 + 分類索引）、標籤詞彙表、關係圖譜，以及大型 Wiki 的一致性檢查思路。

4. README 中的啓用約定
   - 可將規則寫入 SOUL.md 或 AGENTS.md：讀取文檔時按本 Skill 維護索引；檢索資料時先查已有 index.md 再補充檢索。

安裝與啓用¶

官方 SkillHub 頁面給出的安裝方式是：讓 AI 參照 SkillHub 安裝說明 安裝 @user_6c29a21a/create-index。

若本機已安裝 skillhub CLI，可先確認版本，再安裝到當前 Agent 的 skills 目錄（安裝時必須使用 --dir，否則默認落在 ./skills/ 且 Agent 可能無法識別）：

command -v skillhub && skillhub --version

skillhub install @user_6c29a21a/create-index --dir ~/.cursor/skills/

在 Cursor 中，skills 目錄一般爲 ~/.cursor/skills/；Claude Code 爲 ~/.claude/skills/；Codex 爲 ~/.codex/skills/ 或項目下的 .agents/skills/（以 SkillHub 安裝文檔 爲準）。安裝後按所用客戶端要求重啓或刷新 Agent，使 Skill 被加載。

未安裝 CLI 時，可按安裝文檔執行一鍵腳本（完整安裝或僅 CLI）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

典型用法¶

1. 在 Wiki 根目錄建立雙文件¶

在 Wiki 項目根（文檔示例爲 example-wiki/）維護：

• index.md：按概念、實體、來源、綜合頁、待處理等分類，用表格列出頁面鏈接、一行摘要、標籤與狀態。
• log.md：按日期分節，每條以 ### HH:MM:SS UTC | 操作類型 | session:... | tags:[...] 開頭，並填寫觸發查詢、攝入來源、輸出結果等。

文檔給出的 index.md 表格行 速查格式：

| [頁面標題](路徑) | 一行摘要 | 標籤1, 標籤2 | 狀態 |

log.md 條目 頭部示例：

### 10:23:45 UTC | INGEST | session:2026-04-07-001 | tags:[ml,transformer,architecture]

**觸發查詢**: "請總結一下 Transformer 架構的核心組件和工作原理"
**攝入來源**: ./sources/papers/attention-all-you-need.md
**輸出結果**: 創建了 ./concepts/nlp/transformer-architecture.md

2. 頁面 Front Matter 與索引聯動¶

Wiki 頁面可使用 YAML front matter，便於掃描生成或手工維護 index.md（字段以 Skill 文檔附錄爲準）：

---
title: 頁面標題
summary: 簡短摘要
tags: [標籤1, 標籤2]
status: completed
category: concepts
updated: 2026-04-07
related_pages: [page1.md, page2.md]
---

3. 用日誌做檢索與審計¶

文檔示例：統計每日操作、篩選 INGEST、按標籤查會話等，例如：

grep "^###.*INGEST" log.md | head
grep -B 5 "tags:\[.*llm.*\]" log.md | grep "^###.*UTC"

4. 與 Agent 規則結合¶

README.md 建議將下列意圖寫入 SOUL.md 或 AGENTS.md（大意）：每次讀取 Wiki 文檔時按 create-index 規範更新索引；對外搜資料時優先基於已有 index.md 定位，再決定是否擴展內容。

適用場景與注意¶

適合誰

• 用 Markdown Wiki 做個人或團隊知識庫，且主要由 LLM Agent 持續寫入、修訂的場景。
• 需要在小體積索引裏給模型「全庫地圖」，又需要操作留痕、便於復盤與排錯的場景。
• 分類爲 knowledge-management、希望統一 index/log 寫法而非各項目隨意定格式的團隊。

限制與注意

• 當前安裝包爲說明型 Skill，自動化能力依賴 Agent 按 SKILL.md 執行，或自行落地文檔中的 Python/Shell 示例；並非自帶獨立 CLI 服務。
• index.md 在頁面數量很大時需分層索引或定期歸檔，否則單文件過長；log.md 會持續增長，文檔建議按 30–90 天歸檔或滾動日誌。
• 多人協作時，文檔建議配合 Git 等版本控制，日誌以追加爲主以減少衝突。
• SkillHub 抓取數據：評分 100000，下載約 1107 次，安裝記錄 5 次（統計隨平臺更新而變化）。

結尾¶

create-index 把 LLM Wiki 的「當前狀態」（index.md）與「演進過程」（log.md）拆開又對齊，適合作爲 Agent 維護知識庫時的共同約定。需要安裝或查看詳情時，可打開 SkillHub 頁面與 API 條目：

• SkillHub：https://www.skillhub.cn/skills/user_6c29a21a/create-index
• 官方地址：https://api.skillhub.cn/user_6c29a21a/create-index