Skillshub document-writer
多风格文档写作技能。支持乔木、小红书、Dankoe、微信公众号、Twitter等5种写作风格。Claude 根据内容智能选择风格,按规范撰写文章。
install
source · Clone the upstream repo
git clone https://github.com/ComeOnOliver/skillshub
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/ComeOnOliver/skillshub "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/huangserva/servasyy_skills/document-writer" ~/.claude/skills/comeonoliver-skillshub-document-writer && rm -rf "$T"
manifest:
skills/huangserva/servasyy_skills/document-writer/SKILL.mdsource content
Document Writer(多风格文档写作)
将任意主题或素材转化为指定风格的文章。
核心能力
- 🎨 5种写作风格:qiaomu、xiaohongshu、dankoe、wechat、twitter
- 🧠 Claude 智能决策:阅读内容后判断类型,选择合适风格
- 📝 纯Markdown输出:专注写作,配图交给
illustration-generator - ⚡ 风格转换:长文→短文→推特,一键转换
使用方式
# 指定风格写作 /document-writer "秦军消失之谜" --style wechat # 从素材改写 /document-writer source.md --style qiaomu # 风格转换 /document-writer convert article.md --to xiaohongshu
可用风格
| 风格 | 字数 | 特点 | 适用场景 |
|---|---|---|---|
| 8000-10000 | 口语化、对话感、生活化类比 | 技术论文解读、深度科普 |
| 800-1200 | 情绪化、去爹味、emoji点缀 | 种草文、干货分享 |
| 5000-8000 | 挑衅开场、反常识、长短句交替 | 深度思考、观点输出 |
| 3000-6000 | 短段落、重点加粗、结尾互动 | 公众号文章、行业分析 |
| 100-280 | 钩子开头、精炼有力 | Twitter帖子、知识卡片 |
工作流程(7步)
Step 1: 读取输入
Claude 执行:
- 识别用户输入类型:
- 主题文字 → 直接使用
- 文件路径 → 读取文件内容
- 记录输入内容
Step 2: 选择风格
如果用户指定了
:--style
- 直接使用指定风格
如果用户未指定风格:
- Claude 阅读内容,判断内容类型(历史/技术/生活/商业...)
- Claude 选择最合适的风格
- 告知用户选择结果和理由
调用 shared-lib 获取可用风格:
import sys sys.path.insert(0, str(Path.home() / '.claude' / 'skills' / 'shared-lib')) from writing import list_styles print(list_styles()) # ['qiaomu', 'xiaohongshu', 'dankoe', 'wechat', 'twitter']
Step 3: 获取风格规范
调用 shared-lib 获取风格提示词:
from writing import get_style_prompt, get_style_info # 获取风格详情 info = get_style_info('wechat') print(f"风格: {info['display_name']}") print(f"字数: {info['word_count']['min']}-{info['word_count']['max']}") # 获取完整风格指南(给 Claude 用) prompt = get_style_prompt('wechat') print(prompt)
Step 4: 撰写文章
Claude 按风格规范撰写:
-
阅读风格指南中的:
- 核心特征
- 结构要求
- 禁止使用项
- 字数要求
-
按规范撰写文章:
- 遵循结构要求(opening → body → closing)
- 控制字数在范围内
- 避免禁止项
-
输出完整 Markdown 文章
Step 5: 质量自检
Claude 根据风格执行自检:
qiaomu 风格检查:
- 术语解释 ≥ 15处
- 生活化类比 ≥ 3处
- 数据表格 ≥ 1个
- 破折号 = 0个
- 中文标点 100%
wechat 风格检查:
- 字数 3000-6000
- 每段 ≤ 5行
- 有小标题分隔
- 重点加粗
- 结尾有互动引导
xiaohongshu 风格检查:
- 字数 800-1200
- 每段 ≤ 3行
- 有情绪转折
- 无爹味表达
- 有互动钩子
发现问题 → 静默修复 → 继续
Step 6: 保存输出
创建输出目录和文件:
{output_dir}/ ├── {title}.md # Markdown文章 └── metadata.json # 元数据
metadata.json 格式:
{ "title": "文章标题", "style": "wechat", "word_count": 3500, "source": "source.md 或 null", "created_at": "2026-01-26T10:00:00", "generator": "document-writer" }
Step 7: 输出总结
✅ 文章生成完成! 📄 文件: {title}.md 📝 风格: 微信公众号风格 (wechat) 📊 字数: 3500字 ✓ 质量检查: 通过 下一步建议: - 调用 /illustration-generator 生成配图 - 调用 /wechat-article-formatter 格式化为微信HTML
风格转换
将已有文章转换为其他风格。
使用:
/document-writer convert article.md --to xiaohongshu
转换流程:
- 读取原文章
- 调用
获取转换指南get_conversion_guide(from_style, to_style) - 按指南调整:
- 长文→短文:提取核心观点,压缩为要点
- 短文→长文:扩展论述,添加案例和数据
- 按目标风格规范重写
- 质量自检
- 保存输出
与其他 Skill 配合
| 顺序 | Skill | 功能 |
|---|---|---|
| 1 | document-writer | 生成 Markdown 文章 |
| 2 | illustration-generator | 为文章生成配图 |
| 3 | md-to-pdf | 转换为 PDF |
| 4 | wechat-article-formatter | 格式化为微信 HTML |
| 5 | wechat-publisher | 发布到微信公众号 |
shared-lib 接口参考
模块路径:
~/.claude/skills/shared-lib/writing/
| 函数 | 用途 |
|---|---|
| 返回可用风格列表 |
| 返回风格详情(字数、特点等) |
| 返回完整风格指南(给 Claude 用) |
| 返回风格转换指南 |
注意: 内容类型判断由 Claude 完成,不依赖关键词匹配。
示例
示例1:写公众号文章
用户:
/document-writer "客家新论:秦军消失之谜" --style wechat
Claude 执行:
- 读取主题
- 使用 wechat 风格
- 获取风格规范
- 按规范撰写 3000-6000 字文章
- 自检:短段落、加粗、互动结尾
- 保存
客家新论:秦军消失之谜.md - 输出总结
示例2:从素材改写
用户:
/document-writer source.md --style xiaohongshu
Claude 执行:
- 读取 source.md 内容
- 使用 xiaohongshu 风格
- 获取风格规范
- 提取核心观点,压缩为 800-1200 字
- 自检:情绪化、去爹味、emoji
- 保存输出
- 输出总结
示例3:风格转换
用户:
/document-writer convert long-article.md --to twitter
Claude 执行:
- 读取长文
- 获取转换指南(qiaomu → twitter)
- 提取 3-5 个核心金句
- 每条 100-280 字
- 保存为推特线程格式
- 输出总结