| name | yo-wiki-atom |
| description | 从用户输入中提取知识原子并写入原子库。当用户分享值得沉淀的信息、提供链接或文档、想要记录洞察、或明确要求保存到知识库时使用。 |
| version | 0.0.1 |
| author | yolanda |
yo-wiki-atom
将用户任意输入拆解为知识原子,写入原子库,如用户要求或判断为可复用资产时保存进资料库。不负责提炼规律、更新画像或写入知识库。
$WIKI_DIR 是系统环境变量,指向知识库根目录。下文所有路径通过 $WIKI_DIR 引用。首次使用若未配置,按 references/first-time-setup.md 引导用户设置。
User Input Tools
当本 skill 需要提示用户时,按此工具选择规则(优先级顺序):
- 优先使用当前 agent runtime 内置的用户输入工具 — 如
AskUserQuestion、request_user_input、clarify、ask_user、questionnaire 或等效工具。
- 回退到纯文本:若无此类工具,输出编号的纯文本消息,让用户回复选择的编号/答案。
- 批量规则:若工具支持单次调用多个问题,将所有适用问题合并为一次调用;若仅支持单问题,按优先级逐个提问。
下文对 AskUserQuestion 的具体提及均为示例 — 其他 runtime 按规则替换为本地等效工具。
可用工具
- 网页搜索与访问:
web_search web_fetch
- 需登录/cookie 的网页内容读取:
opencli
- 原子库读写:
yo wiki search / yo wiki add(通过 -h 查看参数)
必须阅读
$WIKI_DIR/使用说明.md — 跨层权限,禁止直接编辑 atoms.jsonl
$WIKI_DIR/原子库/使用说明.md — atom 字段、type 定义、价值标准
$WIKI_DIR/资料库/使用说明.md — 资料保存规范(如需保存资料时读取)
禁止行为
- 严禁直接查看或编辑
atoms.jsonl,只通过 yo wiki add 写入
- 严禁直接修改
$WIKI_DIR/ 中的任何信息,除了通过 yo wiki add 的更新
做什么
- 信息读取:用户可能提供链接或文件,先通过可用工具获取原文内容,再从中提取。
- 信息理解:收到用户输入后,先归纳整体,识别信息是否有错误/歧义,如有则告知用户确认。
- 价值判断:判断是否值得记录——标准同原子库使用说明:"下个月能不能用上"。用不上就不动,不为了记录而记录。
- 知识提炼:值得记录时,从输入中提取独立的知识点,按原子库的 type 定义归类,通过
yo wiki add 写入。一条输入可拆多条原子,每条一个独立知识点。不必拆太碎,只提取有长期价值的。
- 信息标注:
confidence 标注知识点在原文中的可靠程度(原文中有明确证据的标 high,原文自己也不确定的标 low),不加 AI 自身的推断或观察。
- 资料保存:当用户提到需要保存资料,或当判断该资料为高价值是后续可复用的资产时,对资料整理,排版并保存进
资料库 目录,具体参考$WIKI_DIR/资料库/使用说明.md 规范进行整理