前言¶
在 Cursor、Claude Code 等环境里写文档，常见做法是每次在对话里重复说明章节结构、标题层级和输出格式。同类内容换一篇报告或 Brief，又要从头描述一遍。若希望 Agent 按固定骨架输出 Markdown，并能在 Typora、GitHub 或导出 PDF 时少改格式，需要一个专门约束「文档形态」的 Skill。下面介绍 SkillHub 上的 结构化 Markdown 文档生成器（坐标 @user_d82fedf3/document-engine），它把「通用文档生成」收敛成可安装的 Skill 能力。
这是什么¶
结构化 Markdown 文档生成器是社区发布的办公效率类 Skill（分类 office-efficiency，版本 1.0.0）。发布者为 user_d82fedf3，SkillHub 页面标注作者为 EastSeaO。官方简介概括为：通用文档生成引擎，支持报告、分析、SOP、Brief 等结构化 Markdown 输出，并声明兼容 Typora、GitHub 与 PDF 等常见渲染/导出路径。
该 Skill 基于通用 SKILL.md 格式分发；标签标明 requires_api_key=false，即不依赖额外 API Key 即可使用（以 SkillHub 页面信息为准）。
核心功能¶
以下能力均来自 SkillHub 与预抓取资料，未展开的实现细节以安装后 Agent 加载的 SKILL.md 为准。
- 多类文档模板语义：面向报告、分析、SOP、Brief 等常见办公文档，输出带结构的 Markdown，而不是零散段落。
- 结构化 Markdown：强调标题层级、章节划分等可预测结构，便于后续在编辑器或仓库中维护。
- 输出环境兼容：官方说明兼容 Typora、GitHub 风格 Markdown 以及 PDF 导出链路（具体排版仍取决于本地工具与主题）。
- 无强制 API Key：适合在本地 Agent 环境中直接启用，无需单独配置第三方密钥（见 SkillHub 标签）。
安装与启用¶
SkillHub 推荐两种方式：让 AI 按安装文档操作，或使用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一：提示词安装（官方页面原文）¶
将下面提示发给支持 Skill 的 AI，由其按 SkillHub 安装说明拉取技能：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_d82fedf3/document-engine`。
方式二：CLI 安装¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；装到默认 ./skills/ 可能不会被 Agent 加载。常见路径如下（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
在对应目录下执行（将 <skills 目录> 替换为实际路径）：
skillhub install user_d82fedf3/document-engine --dir <skills 目录>
也可先搜索再安装：
skillhub search document-engine
skillhub install user_d82fedf3/document-engine --dir <skills 目录>
安装后按你所用客户端要求重启或刷新 Agent，使 Skill 生效。Cursor、Codex CLI、Claude Code 的差异主要体现在 skills 目录位置，安装命令本身一致；若某客户端使用项目级 skills 目录，将 --dir 指向该项目路径即可。
典型用法¶
公开页面未提供逐条复制的官方示例对话。可复现的用法是：在已启用该 Skill 的 Agent 中，用自然语言说明文档类型与素材，并明确要求「按结构化 Markdown」输出。类型与官方简介对齐，例如：
- 报告 / 分析：给出主题、数据或结论要点，要求分章节（背景、分析、结论等）的 Markdown。
- SOP：给出流程步骤与角色，要求固定章节（目的、范围、步骤、注意事项等）的 Markdown。
- Brief：给出项目背景与目标受众，要求短结构（摘要、要点、行动项等）的 Markdown。
生成后可在 Typora 或 GitHub 预览；需 PDF 时使用本地导出工具，并检查标题层级是否符合你的模板习惯。
适用场景与注意¶
适合谁：需要反复让 Agent 写同类办公文档、又希望 Markdown 结构稳定的一线研发、产品、运营与文档维护者；分类为 office-efficiency，侧重效率而非代码仓库自动化。
社区与版本：来源为 community，当前页面版本为 1.0.0；SkillHub 统计（以预抓取资料为准）评分 100000，下载 1271 次。页面数据会更新，以 SkillHub 实时展示为准。
注意：
- 未在公开资料中承诺的具体章节名、front matter 字段或脚本命令，不应假设存在；复杂格式以安装后的
SKILL.md为准。 - PDF 最终效果依赖导出工具与 CSS，Skill 只保证 Markdown 结构化输出方向。
- 安装目录错误是常见坑：务必
--dir到当前 Agent 的 skills 路径。
结尾¶
结构化 Markdown 文档生成器把「报告、分析、SOP、Brief」等输出收敛为可安装的 Skill，减少每次手写格式说明的成本，并面向 Typora、GitHub、PDF 等下游场景。官方入口：
- SkillHub 页面：https://www.skillhub.cn/skills/user_d82fedf3/document-engine
- API 坐标页：https://api.skillhub.cn/user_d82fedf3/document-engine
