wenqu-library

文库（Library）Skill

📦 项目仓库与源码：https://github.com/gogoingai/wenqu-skills

用户输入工具

当本技能需要用户确认选择、补充必要信息或授权有副作用的操作时：

1. 优先使用当前运行时提供的原生用户输入工具，例如 AskUserQuestion、request_user_input、clarify、ask_user 或等价能力。
2. 若没有此类工具，使用带编号或字母选项的文本问答。
3. 同一决策阶段中彼此独立的问题可合并提问；后一个问题依赖前一回答时，按优先级逐个问。
4. 已由用户当前指令、调用方或文章偏好提供的信息，不重复询问。
5. 文中出现的具体工具名均为示例；应替换为当前运行时的等价能力。

定位

文曲创作流程的第一环——博观积累。在动笔写文章之前，先收集和整理素材，让创作有据可依、有米可炊。

文库不是“见什么都存”的素材仓库，而是带着写作意图做收集：当选题、写作目标和大致范围开始清楚后，再去找真正有用的相似文章与相关资料，避免把大量弱相关材料堆进来。

文库不是单篇文章的素材库（那由 wenqu-write 在写作时建立在文章存储 wenqu-skills/{文件名}/references/materials/ 路径下），而是一个跨文章、可长期沉淀的个人知识库：

• 收集技术资料、案例、观点与灵感
• 整理零散信息，形成可复用素材
• 沉淀个人知识资产
• 为后续文章创作（wenqu-write）提供内容基础

触发识别

用户信号	流程
"收集素材"、"整理资料"、"建素材库"	四步收集流程
"沉淀知识"、"积累案例"	沉淀与分类
"抓取这个网页"、"把这篇公众号存下来"	下载、整理（流程第 3、4 步）

存储位置

两级存储，职责不同：

全局文库（跨文章长期资产）

$HOME/.gogoingai/wenqu-skills/library/，按主题/领域分文件：

• {主题}.md —— 每个主题一个文件，内含该主题的素材条目
• 条目格式：| 编号 | 来源 | 内容 | 标签 |（编号 L1、L2……）
• 只存提炼后的条目和原始链接，不存抓取的原始文件

本篇素材目录（单篇文章工作台）

{项目根目录}/wenqu-skills/{文件名}/references/materials/，由 wenqu-write 在写作流程中建立和使用：

materials/
├── index.md      # 素材索引（检索与管理的唯一入口）
├── local/        # 本地素材：源码大段摘录、本地文档导出
├── articles/     # 网页文章：博客、公众号、新闻、教程
├── papers/       # 论文、研究报告
└── docs/         # 官方文档、deep-crawl 整站抓取产物

分类按内容类型分目录；同类文件多时可再按来源站点建二级子目录（如 articles/mp.weixin.qq.com/）。

index.md 索引格式（每条一行）：

| 编号 | 摘要 | 来源类型 | 来源 | 检索渠道 | 文件路径 | 用途 | 标签 | 关联章节 | 日期 |
| M1 | xxx 机制源码摘录 | 实现事实 | src/cache.py:42 | 本地文件 | local/cache-lru.md | 事实素材 | 缓存,LRU | 2.1 | 2026-07-25 |
| M2 | 某公众号文章：XX 系统实践 | 外部研究 | https://mp.weixin.qq.com/s/xxx | agent-native、wenqu-cli:sogou | articles/mp.weixin.qq.com/xx.md | 写法参考 | 架构 | 待定 | 2026-07-25 |

登记规则：

1. 来源必填：网页素材填完整原始 URL（不是域名，是能回到原文的那条链接）；本地素材填 path:line；确实没有来源的标「用户口述或粘贴」
2. 来源类型沿用 provenance 词汇：实现事实、团队选择、外部研究、合理推断、简化场景、待确认（边界见 wenqu-write 的 references/planning/content-provenance.md）
3. 编号唯一：M1、M2…… 全篇唯一，骨架和审查引用这个编号
4. 检索渠道必填：填 agent-native、wenqu-cli:{engine}、wenqu-cli:{engine}:{channel}、用户提供 或 本地文件；同一 URL 被多个渠道发现时合并填写，不丢渠道信息。channel 仅在 CLI 输出不是 direct 时记录，例如 browser 或 delegate:duckduckgo
5. 文件路径相对 materials/ 填写；只登记不写文件的短素材（几行数字、一句话事实）该列填 -
6. 用途分两类：写法参考（相似文章，不能当事实来源）与 事实素材（支撑正文的机制、数字、案例）
7. 标签：2~4 个关键词，方便 grep 检索；素材多了以后按标签或目录检索，不靠通读
8. 关联章节：收集阶段先填「待定」，骨架定稿后回填章节号
9. 素材有实体文件时才进目录；小片段直接写在 index.md 摘要列即可，不为每条都建文件