前言¶
知识库里的笔记、文档和片段往往已经够用，但缺少书稿常见的层级：目录、章节衔接和全书叙事。手工从知识库抽材料、再排成书，耗时长，也容易漏掉关联内容。若目标是「一本书」而不是单篇长文或摘要，需要 Agent 按书籍结构去组织已有知识，而不是泛泛地续写。
下面介绍 SkillHub 上的 写书skill（坐标 @user_92a031c4/xieshu），它面向「基于知识库自动撰写书籍」这一类需求。
这是什么¶
写书skill 是社区来源（community）的知识管理类 Skill，当前版本 1.0.0，由发布者 user_92a031c4 维护。SkillHub 分类为 knowledge-management，标签标明 requires_api_key=false，安装后无需额外配置 API Key。
一句话定位：在 Agent 对话中，当用户要把知识库内容整理成完整书籍时触发，由 Skill 引导 Agent 按书籍形态组织与撰写；不替代单篇文章、简单摘要或翻译类任务。
官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_92a031c4/xieshu
- API 坐标页：https://api.skillhub.cn/user_92a031c4/xieshu
核心功能¶
依据 SkillHub 与官方简介，已核实的能力边界如下。
- 触发语义：用户表达「写书」「把知识库写成书」「帮我出书」「基于知识库写一本书」，或明确表示希望将知识库内容组织成完整书籍时，应启用本 Skill。
- 输入假设：以现有知识库内容为素材，输出方向是「书」的结构化成果，而非零散问答。
- 明确排除：单篇文章写作、简单摘要、翻译不在适用范围内；遇到这类需求时不应误用本 Skill。
Skill 本体遵循通用 SKILL.md 格式，具体章节模板与写作流程以安装包内说明为准；公开页面未展开逐步流水线，正文不臆测未公布的步骤。
安装与启用¶
通过 SkillHub CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 写书skill 时，必须用 --dir 指向当前 Agent 的 skills 目录；默认装到 ./skills/ 可能不会被 Agent 识别。示例：
skillhub install user_92a031c4/xieshu --dir <skills 目录>
坐标写法亦可与 SkillHub 页面一致，向 Agent 说明：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_92a031c4/xieshu。
各客户端 skills 目录（节选）¶
安装路径需与所用产品一致，常见如下（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
装到正确目录后，按各客户端要求刷新或重启 Agent，使新 Skill 生效。
典型用法¶
公开资料未提供带固定知识库 ID 的端到端命令示例，可复现的部分是自然语言触发与任务边界。在已接入知识库、且 Agent 已加载本 Skill 的前提下，可直接使用简介中的表述，例如：
把知识库写成书，按章节结构输出全书大纲并逐章撰写。
或：
基于知识库写一本书，需要目录、章节正文，不要写成单篇博客。
Agent 应根据 Skill 内 SKILL.md 的指引，从知识库取材并组织成书籍形态。若需求仅为「写一篇长文」「做摘要」或「翻译」，应改用其他 Skill 或通用写作流程，避免误触发。
适用场景与注意¶
适合谁
- 已在 Cursor、Claude Code、Codex 等支持 Skills 的环境里维护知识库，希望一次性产出结构化书稿的开发者或内容维护者。
- 需要 Agent 理解「书」与「单篇/摘要」差异，并在对话中自动选用正确工作流的团队。
限制与注意
- 不适用单篇文章、简单摘要、翻译；选型错误会导致产出形态不符合预期。
- 安装务必指定 Agent 对应的
--dir，否则 Skill 可能未被加载。 - SkillHub 统计（以抓取资料为准）：评分 100000，下载 1400，安装计数 0；社区来源，升级与行为变更以 SkillHub 上 v1.0.0 及后续版本为准。
结尾¶
写书skill 把「知识库 → 完整书籍」收敛为可触发的 Agent 能力：用固定话术启用，用分类与简介划清与单篇写作、摘要、翻译的边界。若你正在把分散文档收成可出版或内部分发的书稿结构，可在 SkillHub 查看说明并安装 @user_92a031c4/xieshu：https://www.skillhub.cn/skills/user_92a031c4/xieshu
