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

可用风格

工作流程（7步）

Step 1: 读取输入

Claude 执行：

1. 识别用户输入类型：

- 主题文字 → 直接使用 - 文件路径 → 读取文件内容

1. 记录输入内容

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 按风格规范撰写：

1. 阅读风格指南中的：

- 核心特征 - 结构要求 - 禁止使用项 - 字数要求

1. 按规范撰写文章：

- 遵循结构要求（opening → body → closing） - 控制字数在范围内 - 避免禁止项

1. 输出完整 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

转换流程：

1. 读取原文章
2. 调用 getconversionguide(fromstyle, tostyle) 获取转换指南
3. 按指南调整：

- 长文→短文：提取核心观点，压缩为要点 - 短文→长文：扩展论述，添加案例和数据

1. 按目标风格规范重写
2. 质量自检
3. 保存输出

与其他 Skill 配合

shared-lib 接口参考

模块路径： ~/.claude/skills/shared-lib/writing/

注意： 内容类型判断由 Claude 完成，不依赖关键词匹配。

示例

示例1：写公众号文章

用户：

/document-writer "客家新论：秦军消失之谜" --style wechat

Claude 执行：

1. 读取主题
2. 使用 wechat 风格
3. 获取风格规范
4. 按规范撰写 3000-6000 字文章
5. 自检：短段落、加粗、互动结尾
6. 保存 客家新论：秦军消失之谜.md
7. 输出总结

示例2：从素材改写

用户：

/document-writer source.md --style xiaohongshu

Claude 执行：

1. 读取 source.md 内容
2. 使用 xiaohongshu 风格
3. 获取风格规范
4. 提取核心观点，压缩为 800-1200 字
5. 自检：情绪化、去爹味、emoji
6. 保存输出
7. 输出总结

示例3：风格转换

用户：

/document-writer convert long-article.md --to twitter

Claude 执行：

1. 读取长文
2. 获取转换指南（qiaomu → twitter）
3. 提取 3-5 个核心金句
4. 每条 100-280 字
5. 保存为推特线程格式
6. 输出总结