메뉴
LLM 维护的持久化 Markdown 知识库 —— 既可用作个人知识库（~/wiki/）， 也可用于给开源项目做架构 wiki（<repo>-wiki/）。 触发场景：用户说 "wiki"、"/wiki"、"添加到wiki"、"ingest"、"wiki lint"、 "wiki add"、"wiki query"、"wiki status"、"添加到知识库"、"导入这篇文章"、 "收藏这个"、"记到wiki里"、"建一个 wiki"、"给 X 做架构 wiki"。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | wiki |
| description | LLM 维护的持久化 Markdown 知识库 —— 既可用作个人知识库（~/wiki/）， 也可用于给开源项目做架构 wiki（<repo>-wiki/）。 触发场景：用户说 "wiki"、"/wiki"、"添加到wiki"、"ingest"、"wiki lint"、 "wiki add"、"wiki query"、"wiki status"、"添加到知识库"、"导入这篇文章"、 "收藏这个"、"记到wiki里"、"建一个 wiki"、"给 X 做架构 wiki"。 |
| metadata | {"version":"1.2.0","author":"lanshu","permissions":{"file-read":true,"file-write":true,"network":true,"shell":true}} |
让 LLM 增量构建并维护一个持久化的 Markdown 知识库，基于 Karpathy 的 LLM Wiki 模式。
按下列规则自上而下判断，命中即停：
| 条件 | wiki root | 模式 |
|---|---|---|
CWD 或任一上级目录含 SCHEMA.md + index.md | 该目录 | code-repo |
CWD 是 ~/wiki/ 或其子目录 | ~/wiki/ | personal |
CWD 含 CLAUDE.md + index.md（且不是项目源码的 CLAUDE.md） | CWD | personal |
| 上述都不满足，但用户在说 wiki 操作 | ~/wiki/（默认） | personal |
| 用户明确说"建一个新 wiki" | 走 Step 4：新建 wiki 引导 | — |
模式的本质区别：
raw/sources/entities/concepts/syntheses/），有 reliability 分级concepts/entities/changelog/，可选 guide/），结论必带 文件:行号每次新会话首次触发 wiki 操作时，先读取当前 wiki root 的 schema 文件：
<wiki-root>/CLAUDE.md<wiki-root>/SCHEMA.mdschema 文件是唯一权威——所有页面格式、标签体系、frontmatter 字段、ingest 步骤、lint 检查项都在里面。本 SKILL.md 不重复 schema 内容，只做路由。
如果 schema 文件缺失，说明这个 wiki 还没正确初始化 → 走 Step 4。
按顺序：
<wiki-root>/index.md —— 了解 wiki 全貌（不读全文，了解有哪些页面）<wiki-root>/log.md 最后 10 条 —— 了解最近做了什么<wiki-root>/inbox.md（如存在）—— 看是否有待处理项后续操作只要不切换 wiki root 就不重复读这些。
用户在一个没有现成 wiki 标记的目录说"建一个 wiki"、"给 X 做架构 wiki"、"做个新知识库" 时：
你这个 wiki 想做什么？
A) 个人知识库 —— 沉淀阅读笔记、跨领域观察（personal 模式）
B) 代码仓库 wiki —— 跟踪一个开源项目的源码架构（code-repo 模式）
本 skill 仓库（默认在 ~/code/lanshu-wiki-skill/）的 schema/ 目录有两份模板：
| 类型 | 模板源 | 目标 |
|---|---|---|
| personal | schema/wiki-personal-CLAUDE.md | <wiki-root>/CLAUDE.md |
| code-repo | schema/wiki-code-repo-SCHEMA.md | <wiki-root>/SCHEMA.md |
执行（以 personal 为例）：
SKILL_ROOT="${SKILL_ROOT:-$HOME/code/lanshu-wiki-skill}"
WIKI_ROOT="$HOME/wiki" # 或用户指定的路径
# 建立五层目录骨架
mkdir -p "$WIKI_ROOT"/{raw,sources,entities,concepts,syntheses,reports,assets}
# 复制权威 schema
cp "$SKILL_ROOT/schema/wiki-personal-CLAUDE.md" "$WIKI_ROOT/CLAUDE.md"
# 初始化必备文件
cd "$WIKI_ROOT"
echo "# Wiki Index" > index.md
echo "# Wiki Log" > log.md
echo "# Wiki Inbox" > inbox.md
code-repo 模式同理：目录建 {concepts,entities,changelog} 三层，schema 复制 wiki-code-repo-SCHEMA.md 到 <wiki-root>/SCHEMA.md。
读完模板后，搜索 ⚠️ 标记的位置，逐项问用户：
/wiki ingest <来源> 即可开始填充git init 并定期 push 备份所有命令的具体步骤都在 schema 里。本表只做映射。
| 命令 | 自然语言触发 | 做什么 | 详细规则去哪读 |
|---|---|---|---|
/wiki add <来源> | "加到 wiki"、"收藏" | 追加到 inbox.md，不立即处理 | schema 的 Ingest 节 |
/wiki ingest <来源> | "ingest"、"导入" | 完整 ingest 工作流 | schema 的 Ingest 节 |
/wiki inbox | "看待办" | 列 inbox.md 内容，问是否逐个 ingest | — |
/wiki query <问题> | "wiki 里有 X 吗" | 读 index → 读相关页 → 合成答案 → 可能归档为 synthesis | schema 的 Query 节 |
/wiki lint | "lint 一下" | 按 schema Lint 节扫描，写 reports/lint-report.md | schema 的 Lint 节 |
/wiki status | "wiki 现状" | 见下方 status 模板 | — |
/wiki deprecate <页> | "废弃这页" | 标 archived + 加废弃说明 + 移出 index 正常列表 | schema 的 Deprecate 节 |
/wiki retract <来源> | "撤回这来源" | 标 archived + 扫描所有引用页降置信度 | schema 的 Retract 节 |
/wiki merge <A> <B> | "合并这两页" | 内容合并 + 链接全局替换 + 副页归档 | schema 的 Merge 节 |
# 以已定位的 $WIKI_ROOT 为准（Step 1 决定）
echo "=== 页面统计 ==="
find "$WIKI_ROOT" -name "*.md" -not -path "*/\.*" -not -path "*/raw/*" -not -path "*/_archive/*" | wc -l
echo "=== 最近操作 ==="
grep "^## \[" "$WIKI_ROOT/log.md" 2>/dev/null | tail -3
echo "=== 待处理 ==="
[ -f "$WIKI_ROOT/inbox.md" ] && grep -c "^- \[ \]" "$WIKI_ROOT/inbox.md" || echo "(无 inbox)"
不论 personal 还是 code-repo，以下规则都成立（schema 里也会重申）：
文件:行号；做不到宁可不写raw/ 不可变，log.md 只追加，矛盾要标注不要消解schema/ 目录可以按需放更多模板（如 wiki-paper-research-SCHEMA.md 用于文献综述、wiki-product-research-SCHEMA.md 用于产品研究）。新模板需要：
wiki-<scenario>-SCHEMA.md 或 wiki-<scenario>-CLAUDE.md加新模板后，在 Step 4.1 增加对应选项即可。