用途:okf-wiki 用于从现有文档、笔记或代码仓库搭建符合 Open Knowledge Format(OKF)规范的知识库(wiki、图谱或决策日志)。OKF 以小型 Markdown 文件存储知识,一个概念一个文件,每个文件在 YAML 前置元数据中携带自身来源信息,目录用 index.md 导航,并由校验器强制约束格式。
主要能力:脚手架生成符合规范、可通过自身校验的项目,包含 SPEC.md 格式契约、README.md、scripts/validate.py 校验器、bundle/ 知识树,以及可选的 .claude/ 会话钩子(SessionStart 加载索引、PreToolUse 首次操作前要求确认已读索引)。支持从已有材料(文件、文件夹、仓库或 URL)逐个撰写概念,也支持直接采用已符合 OKF 的 bundle。
使用方式:先与用户确认受众(内部、公开或两者)、标题与起始分区、是否立即填充内容、发布目标,再运行脚手架命令,例如:python3 "${CLAUDE_SKILL_DIR}/scripts/scaffold.py" ./my-knowledge-base --title "Team knowledge base" --sections concepts,services,decisions。默认分区为 concepts;可用 --force、--no-validate、--date YYYY-MM-DD、--no-hooks、--hooks-os posix|windows、--trust-signals 等参数。校验命令:python3 scripts/validate.py --bundle bundle,需以退出码 0 结束。Windows 上用 python 代替 python3。
适用场景:新闻编辑室机构记忆、研究图谱、基础设施或设备地图、团队决策日志等需要人和智能体共同阅读与编辑的知识库。
限制:每个概念必须包含 type、title、description、source、版本对应的验证日期键、timestamp、tags 七个前置元数据键;type 取值受封闭词表限制;source 每个元素必须加引号;禁止写入任何密钥值,校验器会因泄露密钥而失败;index.md 与 log.md 为保留文件;[[slug]] 维基链接不被接受,须用相对路径链接。发布到 GitHub wiki 属高级手动操作,GitHub Pages 尚未实现。Codex 不读取 .claude/ 钩子配置。其余细节暂未提供。