前言¶
让 AI 直接写长文档时，常见问题是结构跑偏、重点错位，改稿往往比从零写还费时间。若能在动笔前先对齐章节与要点，再进入正文，返工会少很多。下面介绍 SkillHub 上的「专家写作小助手」，它把流程固定为两阶段：先出结构化大纲供确认，再写正文。
这是什么¶
「专家写作小助手」是面向专业文档写作的 Agent Skill，坐标为 @user_8a026320/confirm-expert-writer，当前版本 1.0.2，来源为 community，分类 content-creation，由发布者 user_8a026320 维护。
与「一句话让模型直接生成全文」不同，本技能强调先大纲、后正文，并在确认后支持两种正文路径：基于召回的私有化文档内容撰写，或直接生成正文。标签 requires_api_key=false，不依赖额外 API Key 配置。
核心功能¶
已核实的能力如下：
- 两阶段流程：大纲 → 用户确认 → 正文，官方表述为「确保一次写对」。
- 结构化大纲：先生成可供审阅、修改的提纲，再进入写作。
- 正文生成方式：确认大纲后，可选用私有化文档召回结果写正文，也可不依赖召回直接生成正文。
- 自定义大纲模板：可按团队或文档类型约定大纲结构。
- 自然语言触发：可用「帮我写个文档」「生成大纲」「写方案」「先出大纲」「确认后再写」等表述唤起技能。
安装与启用¶
SkillHub 页面给出的安装提示是：让 AI 按官方安装文档执行，并安装指定坐标。
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_8a026320/confirm-expert-writer`。
若本机已安装 skillhub CLI，可将技能装到当前 Agent 的 skills 目录（未指定 --dir 时默认落在 ./skills/，部分客户端不会自动加载）。通用安装方式如下。
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时把 --dir 指向当前环境识别的 skills 目录，例如：
skillhub install @user_8a026320/confirm-expert-writer --dir ~/.cursor/skills/
其他常见路径（以 SkillHub 安装文档为准）：Claude Code 为 ~/.claude/skills/；Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。装好后按所用客户端要求刷新或重启，使 Skill 生效。
典型用法¶
官方未提供独立示例仓库；用法可从简介与触发词还原为可复现的对话流程。
- 在已启用该 Skill 的 Agent 中，用触发词说明任务，例如：「先出大纲，帮我写个文档：XXX 技术方案」。
- 审阅模型返回的结构化大纲，提出增删改，直到结构满意。
- 明确「确认后再写」，并说明正文偏好：
- 需要贴合内部资料时，依赖 Agent 侧已配置的私有化文档召回能力；
- 不需要引用私有库时，可直接要求生成正文。 - 若团队有固定文档形态，可在对话中说明或引用自定义大纲模板，再重复步骤 1～3。
全程保持「先对齐结构、再写全文」，避免在成稿阶段大改章节逻辑。
适用场景与注意¶
适合谁
- 需要写方案、说明、规范类长文档，且对章节结构有明确要求的开发者或技术写作者。
- 希望正文与内部知识库对齐、又愿意在大纲阶段投入一次确认成本的团队。
限制与注意
- 私有化正文质量取决于 Agent 的文档召回与上下文配置，Skill 本身只声明支持该路径，不替代知识库接入工作。
- 评分与下载量以 SkillHub 页面为准（资料抓取时：评分 100000，下载 1974）；安装数在部分统计中为 0，可能与统计口径有关，以商店实时数据为准。
- 技能遵循通用 SKILL.md 格式，行为以
@user_8a026320/confirm-expert-writer包内说明为准；升级时注意版本号（当前 1.0.2）。
结尾¶
「专家写作小助手」把文档写作拆成「大纲确认」与「正文生成」两步，并支持自定义大纲模板与可选的私有化内容召回，适合不想在成稿后推倒重来的写作场景。
- SkillHub 页面：https://www.skillhub.cn/skills/user_8a026320/confirm-expert-writer
- API 入口：https://api.skillhub.cn/user_8a026320/confirm-expert-writer
