القائمة
本地知识资料索引与 Wiki 编译
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
跨 IDE / 跨 LLM 的声明式工作流引擎，以 CLI 状态机形态运行。把多步任务、用户阻塞、条件循环、跨 LLM CLI 协作（claude / codex / caller）描述为一份 YAML，CLI 负责落盘、推进、崩溃恢复，所有推理交给 caller（你）或外部 LLM。当用户提到"workflow"、"流程"、"多步任务"、"跨 LLM 协作"、"用户确认环节"、"自动化 SOP"、"批量处理"、"恢复昨天的任务"，或意图需要 ≥3 个节点、需要审计、需要可重复 SOP 时使用。Python 3.10+，零运行时网络依赖。
skillix-hub 项目标准化 Skill 开发流程指南和脚手架工具。当用户要求创建新 Skill、 初始化 Skill 目录结构、或询问 Skill 开发规范时使用。提供 10 阶段完整生命周期： 需求命名、可行性分析、设计文档、讨论迭代、代码开发、单元测试、测试报告、技术文档、README 同步、docs 同步。
将知识材料编译为结构化 Wiki。AI 即编译器，Markdown-in Markdown-out，覆盖度追踪，增量编译。
第一性原理分析。将问题拆解到不可置疑的基础事实，系统挑战每一个假设，再从地基向上重建解决方案——而非依赖惯例或类比。适用于成本质疑、架构选型、根因分析、产品定义、约束破除、战略决策。
苏格拉底式批判性思维分析。自动识别需求分析、系统设计、技术选型、数据分析四类场景，智能决定快速结论（≤1问）或深度探索（≤5问），防止过度追问与草率结论。Socratic critical thinking for requirements, design review, tech research, and data analysis.
Prompt 编写辅助工具。基于 PRISM 框架（Facet 驱动的 Prompt 设计方法论），提供编写、编辑、质量检测、行为诊断四大功能。当用户需要编写、修改、检查或诊断 Prompt 时使用。
| name | knowledge-base |
| version | 0.1.0 |
| description | 本地知识资料索引与 Wiki 编译 |
| triggers | ["知识库","之前的设计文档","找之前的资料","相关设计","knowledge base","kb"] |
管理本地的设计资料、文档、数据集、代码仓库的位置索引，并通过 LLM 编译成结构化 Wiki（含反向链接、概念归类、知识图谱）。支持任意文件类型。
SKILL_PATH="skills/knowledge-base"
# 添加单个资料
python3 $SKILL_PATH/main.py add /path/to/doc.md --tags "tag1,tag2" --category "分类"
# 导入项目 design/ 目录
python3 $SKILL_PATH/main.py import-project
# 查看索引
python3 $SKILL_PATH/main.py list
# 浏览知识库
python3 $SKILL_PATH/main.py browse
# 搜索
python3 $SKILL_PATH/main.py search "记忆架构"
| 命令 | 说明 |
|---|---|
add <path> | 添加资料索引（支持 --title, --tags, --type, --category） |
add <dir> --type directory --pattern "*.md" --recursive | 批量添加目录下的文件 |
list [--type X] [--tag X] [--category X] [--pending] | 列出索引，支持过滤 |
remove <id> | 移除索引条目 |
edit <id> [--title X] [--tags X] [--category X] | 更新索引元数据 |
import-project [--dir design] [--pattern "*.md"] | 快捷导入项目目录 |
| 命令 | 说明 |
|---|---|
compile | 增量编译 Wiki（生成 prompt 供 Agent 执行） |
compile --full | 全量重新编译 |
compile --dry-run | 预览待编译清单 |
compile --finalize | 编译后处理（更新反向链接和知识图谱） |
| 命令 | 说明 |
|---|---|
browse | 知识地图概览 |
browse <category> | 查看分类下的概念 |
read <concept-id> | 读取概念条目全文 |
source <source-id> | 查看原始资料信息 |
search <query> | 知识导航（输出 Wiki 结构供 Agent 语义定位） |
status | 知识库状态总览（条目统计、编译状态） |
check | 路径有效性检查 |
搜索策略：search 输出完整知识结构（分类 + 概念列表），由你（Agent）根据查询意图自主判断哪些概念相关，然后用 read <concept-id> 读取全文。这比关键词匹配更准确。
| 命令 | 说明 |
|---|---|
graph | 输出知识图谱（JSON） |
graph --format mermaid | 输出 Mermaid 格式图谱 |
graph --center <id> --depth 2 | 以某概念为中心的子图 |
| 命令 | 说明 |
|---|---|
concept list | 列出所有概念 |
concept remove <concept-id> | 删除概念 |
concept merge <id1> <id2> | 合并两个概念 |
concept rename <concept-id> "新标题" | 重命名概念 |
| 命令 | 说明 |
|---|---|
category list | 列出所有分类 |
category rename <old-name> <new-name> | 重命名分类 |
| 命令 | 说明 |
|---|---|
install [--target <path>] | 安装初始化（创建数据目录） |
update [--target <path>] | 更新代码 |
uninstall | 卸载 |
| 类型 | 扩展名 | 索引行为 |
|---|---|---|
| markdown | .md, .mdx, .rst | 读取全文，自动提取标题 |
| code | .py, .js, .ts, .java, .go, .rs, .vue 等 | 读取全文，返回文件名 |
| config | .yaml, .toml, .json, .xml, .env 等 | 读取全文，返回文件名 |
| text | .txt, .log, .tex | 读取全文 |
| dataset | .csv, .json, .jsonl, .tsv | 读取前 20 行预览 |
| image | .png, .jpg, .gif, .svg, .webp | 索引路径 + 文件大小 |
| binary | .pdf, .zip, .exe, .whl 等 | 索引路径 + 文件大小 |
| repo | 含 .git 的目录 | 读取 README + 目录结构 |
| directory | 普通目录 | 目录树（深度 2） |
| link | 外部 URL | 存储 URL + 手动摘要 |
未知扩展名自动通过二进制检测区分文本/二进制，不限制文件类型。
运行时数据存储在 skills/knowledge-base-data/：
knowledge-base-data/
├── raw/
│ └── index.jsonl ← 索引清单
├── wiki/
│ ├── index.md ← 知识地图
│ ├── concepts/ ← 概念条目（Markdown + frontmatter）
│ ├── categories/ ← 分类索引
│ └── graph.json ← 知识图谱（含反向链接关系）
├── wiki.bak/ ← 编译前自动备份
└── compile/
└── history.jsonl ← 编译历史（保留最近 50 条）
kb compile --dry-run — 预览待编译清单kb compile — 生成 prompt，Agent 分析内容、提取概念、写入 wiki/concepts/kb compile --finalize — 构建知识图谱、知识地图、分类索引