SuperAPI AI 工具集

init

智能体与模型

查看项目

更新于 10-15 21:36

技能介绍

用途:init 用于为用户搭建一个“共享大脑”知识库文件夹,默认路径为 ~/kb,也可用 $KB_DIR 或用户显式给出的路径。它面向需要跨会话、跨智能体持久记忆但尚无知识库的场景,例如“帮我建一个 kb / 共享大脑 / 持久记忆文件夹”。

主要能力:生成一个自包含目录,纯 Markdown,无数据库、无服务器。包含记忆协议文件 AGENTS.md(完整读写与 dream 规则)、CLAUDE.md(Claude Code 的轻量指针)、DREAM.md(整合过程)、MEMORY.md(所有智能体首先读取的索引);memory/ 作为 OKF v0.1 bundle 根,每条笔记是一个带 frontmatter type 的 .md 文件;raw/inbox/ 用于低门槛日常记录,raw/ 存放不可变源文档。自带 CLI 与工具并 vendored 到 scripts/ 与 bin/,即使之后移除该插件文件夹仍可用:bin/kb(capture/lint/sync/gen/viz/wire)、scripts/render_okf_viewer.py(重新生成 memory/**/index.md 与自包含 viz.html 图查看器)、scripts/lint.sh、scripts/sync.sh、scripts/wire.sh。

使用方式:解析目标路径后,用绝对路径运行捆绑脚本(脚本不展开 ~):bash "${CLAUDE_PLUGIN_ROOT}/skills/init/scripts/scaffold.sh" "$HOME/kb"。脚本是幂等的,只创建缺失文件、为脚本加可执行权限、初始化 memory/{user,feedback,reference,projects,topics}/ 分组,绝不覆盖已存在文件,并会运行一次 render_okf_viewer.py 使 memory/index.md 与 viz.html 立即存在。之后报告创建与跳过的文件数及目标路径。三个后续操作需先询问、不自动执行:建议把 export PATH="<target>/bin:$PATH" 加入 shell rc;可选 git init 及 git remote add origin <url>;运行 <target>/scripts/wire.sh on 会向 ~/.claude/CLAUDE.md(以及存在时的 ~/.codex/AGENTS.md、~/.config/opencode/AGENTS.md)添加标记块,使未来会话自动读取 kb,wire.sh off 可干净撤销。

限制与安全:scaffold.sh 只创建不存在的文件,对已部分或完全初始化的 kb 重跑安全;不触碰目标文件夹之外的任何内容(全局配置、shell rc、git remote 均需确认后单独执行);不写入个人数据,生成的都是通用模板。若用户想要示例笔记,不应编造个人事实,可留空或用 kb capture 记录。后续维护可用本插件的 dream 技能;更丰富的 OKF 编写与校验可用 okf 插件;添加笔记后可用 kb viz 打开图查看器。