Wiki Intelligence

一套轻量 Claude Code hook，让每次对话都能为知识库增值。

功能

安装

# 1. 克隆 kj-skills（或已有则跳过）
git clone https://github.com/your-org/kj-skills.git

# 2. 一键安装
bash kj-skills/skills/wiki-intelligence/install.sh

# 3. 设置 wiki 路径
vim ~/.claude/wiki-intelligence.config.json
# 修改 "wiki_path" 为你的 wiki 绝对路径

# 4. 重启 Claude Code 生效

配置

唯一配置文件：~/.claude/wiki-intelligence.config.json

Wiki 目录约定

好提示词写入 {wiki_path}/{prompt_collection_path}/ 下按意图分类：

wiki/playbooks/prompts/
├── design.md      # 设计/架构类
├── analysis.md    # 分析/研究类
├── planning.md    # 规划/方案类
└── general.md     # 其他

知识沉淀（「确认沉淀」触发）由 Claude 侧规则处理写入，hooks 只负责分析与提示。

运行测试

# 跳过需要 claude -p 的集成测试（在 Claude Code 内部运行时使用）
WI_SKIP_CLAUDE_TESTS=1 bash tests/test-wiki-intelligence.sh

# 完整测试（在 Claude Code 外部运行）
bash tests/test-wiki-intelligence.sh

文件结构

hooks/
├── prompt-quality.sh         # UserPromptSubmit hook
├── knowledge-capture.sh      # Stop hook
├── session-start-cleanup.sh  # SessionStart hook
└── lib/
    ├── wiki-intelligence.sh  # 分析引擎（共享库）
    └── wiki-writer.sh        # Wiki 写入工具
tests/
└── test-wiki-intelligence.sh
wiki-intelligence.config.example.json
install.sh

依赖

• jq — JSON 解析（brew install jq）
• python3 — 解析对话记录（macOS 自带）
• claude CLI — AI 分析子进程（Claude Code 自带）

交付前自检

• 运行 WI_SKIP_CLAUDE_TESTS=1 bash tests/test-wiki-intelligence.sh 并确认退出码为 0；在 Claude Code 外部改动时再跑一次不带跳过变量的完整测试。
• 对照「文件结构」一节核验：hooks/ 下 prompt-quality.sh、knowledge-capture.sh、session-start-cleanup.sh 与 hooks/lib/ 下两个共享库均存在且可执行。
• 运行 jq . ~/.claude/wiki-intelligence.config.json 确认配置是合法 JSON 且退出码为 0，wiki_path 指向真实存在的目录。
• 确认好提示词只写入 {wiki_path}/{prompt_collection_path}/ 下的分类文件（design.md / analysis.md / planning.md / general.md），未写到 wiki 目录之外。
• 若改动了 hook 行为或新增配置字段，确认本文件「配置」表与「文件结构」段已同步更新。