前言¶
写周报、项目方案或年度计划时，最难的往往不是措辞，而是章节该怎么排：哪些块必填、先后顺序如何、占位处写什么。很多人会从旧文档里复制一份再改标题，结构容易漏项，也不利于 Agent 后续自动填内容。
下面介绍 SkillHub 上的社区 Skill「文档模板生成器」（坐标 @user_f28fdad8/oc-doc-template，版本 1.0.0）。它按文档类型和需求生成结构化模板，输出标准 Markdown，脚本侧仅依赖 Python 标准库，无需 API Key。
这是什么¶
「文档模板生成器」由社区发布者 user_f28fdad8 维护，分类为 office-efficiency，来源标注为 community。定位是文档骨架生成：输入文档类型与关键信息，得到带占位提示的 Markdown 结构，而不是对已有长文做摘要或润色。
SkillHub 页面简介与 SKILL 元数据一致：覆盖报告、方案、计划、总结四类办公场景；商店侧显示评分 100000、下载约 902 次（以 SkillHub 页面统计为准），标签 requires_api_key=false。
核心功能¶
经核对 SKILL.md，能力拆为四条流水线，均通过 scripts/ 下脚本以 JSON 入参驱动：
- 报告模板：
scripts/report.py，支持日报、周报、月报、季报、年报、专项报告等类型。 - 方案模板：
scripts/proposal.py，按主题、受众、范围生成方案文档结构。 - 计划模板：
scripts/plan.py，按目标、周期、团队规模等工作计划骨架。 - 总结模板：
scripts/summary.py，按总结范围、角色、亮点等生成总结文档模板。
设计原则在 SKILL 中写得很明确：输出标准 Markdown；模板内含填写提示；实现仅用 Python 标准库；入参统一为 JSON，便于 Agent 对接。
安装与启用¶
方式一：让 Agent 按 SkillHub 指引安装¶
SkillHub 技能页给出的提示词为：请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f28fdad8/oc-doc-template。适用于 Cursor、Claude Code 等已支持 Skill 的对话环境，由 Agent 读取安装文档后把技能装到当前客户端的 skills 目录。
方式二：SkillHub CLI¶
先确认本机已安装 skillhub（安装方式见 https://skillhub.cn/install/skillhub.md）。安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
在 Cursor 中，常用路径为 ~/.cursor/skills/；Codex CLI 常用 ~/.codex/skills/ 或项目下的 .agents/skills/。以下示例以 Cursor 用户目录为例：
command -v skillhub && skillhub --version
skillhub install oc-doc-template --namespace user_f28fdad8 --dir ~/.cursor/skills/
搜索索引中给出的坐标写法与上式等价，完整包名为 @user_f28fdad8/oc-doc-template。
安装完成后，按所用客户端要求重启或刷新 Agent，使新 Skill 被加载。
典型用法¶
技能包安装后，在技能根目录执行脚本（路径相对于 @user_f28fdad8/oc-doc-template 包内）。官方 SKILL.md 给出四条可复现命令。
生成报告模板（示例为技术部周报）：
python scripts/report.py --input '{"type": "周报", "department": "技术部", "period": "2026年第23周"}'
生成方案模板：
python scripts/proposal.py --input '{"topic": "AI智能体商业化", "target": "投资人", "scope": "技术方案+商业模式"}'
生成计划模板：
python scripts/plan.py --input '{"goal": "Q3产品上线", "duration": "3个月", "team_size": 5}'
生成总结模板：
python scripts/summary.py --input '{"scope": "年度总结", "role": "技术负责人", "highlights": ["项目A上线", "团队扩展"]}'
在 Agent 对话中，也可直接用自然语言触发。SKILL 元数据中的 trigger 包含「生成文档模板」「报告模板」「方案模板」「工作计划」「文档结构」等表述，由 Agent 读取 SKILL 后选择对应脚本与 JSON 字段。
经过上面的步骤，终端或 Agent 应得到 Markdown 模板文件或文本，再在各节占位处填入实际内容即可。
适用场景与注意¶
适合谁
- 需要固定章节结构的周报、月报、专项报告；
- 对外方案、内部计划书、阶段性总结的起草前搭架子；
- 希望用 JSON 描述需求、让 Coding Agent 批量生成同构文档的团队。
限制与注意
- 产出是模板与结构提示，不包含自动联网调研或事实核查；正文仍需人工或结合其他工具填写。
- 脚本依赖本机
python与标准库，需在技能包目录下执行，或让 Agent 切换到正确工作目录。 - 商店简介另列「工作报告 / 项目方案 / 计划书 / 会议纪要」等表述，与 SKILL 中四类「报告 / 方案 / 计划 / 总结」场景一致；若需会议纪要专用结构，应在对话中明确需求，由 Agent 在总结或报告流程上扩展，而非假定有单独脚本名。
- 安装坐标须带命名空间
user_f28fdad8，裸 slug 可能导致下载失败。
结尾¶
「文档模板生成器」把办公文档里重复的排版决策收敛成可复用的 Markdown 骨架，并用纯标准库脚本降低环境成本。若要在本地或 Agent 中启用，可从 SkillHub 技能页与 API 入口查看元数据与安装说明：
- https://www.skillhub.cn/skills/user_f28fdad8/oc-doc-template
- https://api.skillhub.cn/user_f28fdad8/oc-doc-template
