@fugui200/llmwiki 0.1.2-beta.0

package/skill/llmwiki-connector/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: llmwiki-connector
+description: 连接 LLM Wiki 与当前项目。用于明确提到 LLM Wiki、个人知识库、召回历史经验、归档到 llmwiki、沉淀开发/产品/设计/个人知识的任务。
+---
+
+# LLM Wiki Connector
+
+## 概述
+
+本 skill 连接 `~/.llmwiki/` 与当前项目。它不把 `llmwiki` CLI 作为新能力入口，而是直接读取和维护仓库内的 `wiki/` 知识层。
+
+核心能力：
+- **Recall**：按任务召回开发、产品、设计、个人知识
+- **Archive**：将新经验写回 `wiki/`
+- **Lint**：运行仓库维护脚本检查健康度
+
+## 召回顺序
+
+不要在启动、`/clear` 或普通提问时自动读取全局 wiki 页面。只有用户明确要求召回/归档，或当前任务明显需要历史项目知识时，才按需读取：
+
+1. 先运行 `llmwiki classify` 判断当前项目归属。
+2. 优先读取当前 `archiveProjects` 对应页面。
+3. 按关键词读取相关 `patterns/tools/concepts` 页面。
+4. 必要时再读取 `~/.llmwiki/purpose.md`、`~/.llmwiki/schema.md`、`~/.llmwiki/wiki/overview.md`、`~/.llmwiki/wiki/index.md` 作为全局索引。
+
+必要时回溯 `~/.llmwiki/raw/sources/`。
+
+## Recall
+
+根据当前任务定位页面：
+
+- 项目名 → `wiki/projects/<project>/`
+- 构建、调试、踩坑 → `wiki/patterns/`
+- 产品需求、PRD、验收 → `wiki/concepts/`、`wiki/products/`
+- 设计体系、视觉契约 → `wiki/design/` 或项目内设计页面
+- 工具经验 → `wiki/tools/`
+- 历史会话 → `wiki/sessions/`
+
+推荐命令：
+
+```bash
+cd ~/.llmwiki
+rg -n "<关键词>" purpose.md schema.md wiki raw/sources
+```
+
+回答时区分：
+- 已沉淀结论
+- 从页面推导出的判断
+- 待验证假设
+
+## Workspace Classification
+
+如果当前项目或父目录存在 `.llmwiki.json`，归档前先判断项目归属：
+
+```bash
+llmwiki classify
+llmwiki classify <changed-or-discussed-path>...
+```
+
+规则：
+
+- 一个子项目命中 → 写入 `wiki/projects/<project>/`
+- 未列入配置但命中 workspace 下 git 仓库 → 写入 `wiki/projects/<repo>/`
+- 多个服务通过 `projectAliases` 映射到同一业务项目 → 写入 `wiki/projects/<alias>/`
+- 多个子项目命中 → 写入 `wiki/synthesis/`
+- 仅 workspace 根目录命中 → 写入 `wiki/projects/<defaultProject>/`
+
+`classify` 是只读建议；最终仍由 Agent 根据证据和内容决定具体页面。
+
+## Archive
+
+归档时遵循：
+
+1. 优先更新已有页面，避免重复创建相似页面。
+2. 如果有 `.llmwiki.json`，先按 workspace classification 判断项目归属。
+3. 单项目事实写入 `wiki/projects/<project>/`。
+4. 跨项目经验写入 `wiki/patterns/`，多子项目链路优先写入 `wiki/synthesis/`。
+5. 产品、设计、个人知识分别写入 `wiki/products/`、`wiki/design/`、`wiki/personal/`。
+6. 新页面必须包含 YAML frontmatter。
+7. 页面之间使用 Markdown 相对链接，不新增双中括号样式的 Wiki 链接。
+8. 更新 `wiki/index.md`。
+9. 追加 `wiki/log.md`。
+10. 运行 `npm run wiki:lint`。
+
+## Frontmatter
+
+```yaml
+---
+title: 页面标题
+type: project | pattern | session | concept | decision | rule | tool | product | design | personal | source | synthesis | query
+project: 可选项目名
+updated: YYYY-MM-DD
+status: active
+confidence: high | medium | low
+sources: []
+tags: []
+---
+```
+
+`sources` 只记录可确认的 `raw/sources/` 路径。不确定时保持空数组。
+
+## 维护命令
+
+```bash
+cd ~/.llmwiki
+npm run wiki:lint
+npm run wiki:overview
+npm run wiki:graph
+llmwiki classify
+llmwiki init --agent claude-code
+llmwiki init --agent codex
+llmwiki init --agent gemini
+llmwiki init --agent all
+```
+
+`llmwiki init` 在交互终端中会依次询问 agent、是否 workspace、profile（personal/team/local）和 wikiRoot；非交互环境必须显式传参。`claude-code` 写入 `.claude/settings.json` 归档提醒 hook，并在 `CLAUDE.md` 写入按需召回规则；`codex` 写入 `.llmwiki.json` 项目标记并安装全局 Codex hooks；`gemini` 写入 `GEMINI.md` 项目上下文入口；`all` 同时导入三者。三种接入默认只使用项目归属元数据和按需召回规则，不在启动、`/clear` 或普通提问时自动加载全局 wiki 页面。
+
+## 注意事项
+
+- 不改写 `raw/` 原始资料。
+- 不把聊天原文直接保存成 wiki 页面。
+- 大范围改动前先列出影响页面。
+- 归档完成必须说明新增/修改页面和 lint 结果。

package/skill/llmwiki-connector/scripts/wiki.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# LLM Wiki helper script for skill hooks
+
+WIKI_DIR="${LLMWIKI_DIR:-$HOME/.llmwiki}"
+
+case "$1" in
+  pull)
+    cd "$WIKI_DIR" && git pull --rebase -q 2>&1
+    ;;
+  index)
+    cat "$WIKI_DIR/index.md"
+    ;;
+  search)
+    shift
+    grep -rn --include="*.md" "$@" "$WIKI_DIR/" | grep -v ".git/" | head -20
+    ;;
+  push)
+    cd "$WIKI_DIR" && git push origin main 2>&1
+    ;;
+  status)
+    cd "$WIKI_DIR" && git status --short
+    ;;
+  *)
+    echo "Usage: wiki.sh {pull|index|search|push|status}"
+    exit 1
+    ;;
+esac