SKILL.md
WeChat Article Writer
⚠️ 重要配置说明
默认使用AI工具内置能力创作,无需配置API Key!
本skill适用于Claude Code、Cursor、OpenClaw、OpenCode、Antigravity等所有支持skills的AI工具平台。默认使用AI工具的内置能力进行内容创作,用户无需配置任何API Key即可使用。只有当用户明确需要使用外部API(如特定图像生成服务)时,才需要配置相应的API Key。
优先级:
- 优先使用AI工具内置能力完成内容创作
- 仅在特定需求下使用外部API(如高质量图像生成)
- 简化用户操作,零配置即可开始创作
支持平台:
- Claude Code
- Cursor
- OpenClaw
- OpenCode
- Antigravity
- 其他支持skills的AI工具
Overview
Automated WeChat Official Account article creation skill that generates high-quality articles with AI-powered content creation and infographic generation. The skill uses a multi-agent collaboration system with specialized agents for titles, structure, and content, plus a three-layer review process to ensure professional-quality articles suitable for public account publishing.
Key Features:
- Multi-Agent System: Specialized agents for titles (100+ techniques), structure design, and content writing
- Three-Layer Review: Theme consistency, design & language, AI removal & colloquial optimization
- Multi-Version Output: 4 variants (full/condensed × markdown/plain text)
See AGENTS.md for detailed agent specifications and workflow.
When to Use
Suitable scenarios:
- Creating WeChat Official Account articles from scratch
- Writing technical tutorials, industry analysis, or knowledge sharing articles
- Generating articles with infographics and visual content
- Producing SEO-optimized articles with structured formatting
Not suitable for:
- Short social media posts (use xhs-generator instead)
- Academic papers requiring strict citations
- News reporting requiring real-time verification
- Extremely specialized domain knowledge requiring expert review
Usage
Direct invocation in AI tool:
/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器"
With custom word count:
/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器" --word-count 3000
Disable web search:
/wechat-article-writer "AI工具推荐:提升10倍效率的5个神器" --no-search
The AI tool will automatically:
- Load preferences from EXTEND.md (if configured)
- Analyze the topic and present a plan for confirmation
- Search the web for latest information (if supported and enabled)
- Generate 3 engaging titles using Title Specialist Agent (100+ techniques)
- Design article structure using Structure Specialist Agent
- Write article content using Content Specialist Agent
- Three-layer Review:
- Review 1: Theme consistency check - Review 2: Design & language check - Review 3: AI removal & colloquial optimization
- Generate 4 article variants (full/condensed × markdown/plain text)
- Generate 2 PNG infographic images (auto-generated using infographic-generator skill)
- Save all outputs to the appropriate directory structure
- Provide a summary with next steps
Result: A complete, publish-ready article package with text + images!
Customization via EXTEND.md:
Users can create skills/wechat-article-writer/EXTEND.md to customize:
- Default writing style (knowledge, emotional, tutorial, review)
- Voice (professional, casual, friendly)
- Target audience
- Infographic style preferences
- Article length and structure preferences
Workflow
This skill is executed by AI tools (Claude Code, Cursor, OpenClaw, etc.) using their built-in capabilities.
Multi-Agent System: This skill uses a multi-agent collaboration system for article generation. See AGENTS.md for detailed agent specifications.
When user invokes /wechat-article-writer, the AI tool should:
Phase 1: Setup & Analysis
- Step 0: Load Preferences - Read
skills/wechat-article-writer/EXTEND.mdif exists, apply default preferences - Step 1: Content Analysis - Analyze topic, determine article type, target audience, and key points
- Step 1.5: Web Research (Optional) - If AI tool supports web search, search for latest information on the topic
- Step 2: Smart Confirm - Present analysis results to user for confirmation before generation
Phase 2: Multi-Agent Article Generation
- Step 3: Generate Titles - Use Title Specialist Agent to generate 3 engaging titles with 100+ techniques
- Step 4: Design Structure - Use Structure Specialist Agent to design article framework and outline
- Step 5: Generate Content - Use Content Specialist Agent to write article based on structure and titles
- Step 6: Review 1 - Theme Consistency - Check if content aligns with central theme
- Step 7: Review 2 - Design & Language - Check for typos, grammar, and design issues
- Step 8: Review 3 - AI Removal & Colloquial Optimization - Remove AI traces and make content natural
⚠️ 重要:子代理调用实现
本系统使用Agent工具调用专业子代理,确保真正的专业分工和质量提升。
子代理配置文件位置:
- 标题专家:
skills/wechat-article-writer/agents/title-specialist.md - 结构专家:
skills/wechat-article-writer/agents/structure-specialist.md - 内容专家:
skills/wechat-article-writer/agents/content-specialist.md - Review专家:
skills/wechat-article-writer/agents/review-specialist.md
调用原则:
- 每个子代理有独立的角色定位和专业知识
- 输入完整上下文,不依赖会话历史
- 输出结构化结果,便于后续处理
- 失败时有降级策略
Phase 3: Multi-Version Generation
- Step 9: Generate 4 Article Versions - Generate multiple versions for different use cases:
- Full Markdown version (5000 words) - Condensed Markdown version (1000 words) - Full Plain Text version (WeChat compatible) - Condensed Plain Text version (WeChat compatible, 1000 words)
- Step 10: Generate Infographic Descriptions - Create detailed descriptions for 2 infographics
- Step 11: Generate PNG Images - Use infographic-generator skill to generate actual PNG images
Phase 4: Output & Summary
- Step 12: Save Outputs - Save all generated content to
wechat-articles/{topic-slug}/directory - Step 13: Output Summary - Present final results with file locations and next steps
Detailed Execution Guide
For AI tools executing this skill:
Step 0: Load Preferences
Read skills/wechat-article-writer/EXTEND.md if it exists. Apply these default preferences if not configured:
---
default_style: knowledge
default_voice: professional
target_audience: "大众读者"
infographic_style: notion
word_count_limit: 5000
enable_web_search: true
need_title_variants: 3
need_summary: true
---
Step 1: Content Analysis
Analyze the user's topic and determine:
- Article Type: knowledge | emotional | tutorial | review
- Target Audience: Who will read this article?
- Content Framework: Choose appropriate structure:
- Problem-Solution-Example (for tutorials) - What-Why-How (for knowledge articles) - Story-Insight-Action (for emotional articles) - Overview-Analysis-Conclusion (for reviews)
- Key Points: 3-5 main points to cover
Step 1.5: Web Research (Optional)
Intelligent web research with priority-based search selection:
Execute web search to gather latest information using the best available method:
- Web Search Priority (automatically select the best available method):
Priority 1: Exa AI MCP (强制优先 - 最佳质量) - 检查Exa AI MCP服务器配置: claude mcp list | grep exa - 如果可用 → 强制使用 mcpexawebsearchexa 工具 - 优势: - 🎯 高精度AI驱动的搜索引擎 - 🚀 实时信息检索,质量最高 - 📊 清晰的结构化结果 - 💡 强大的语义理解能力 - 实现:await mcpexawebsearchexa({ query: searchQuery, numResults: 8 }) - ⚠️ 重要规则:即使其他搜索工具可用,只要检测到Exa AI,必须优先使用
Priority 2: Claude Code WebSearch Tool - 检查 WebSearch 工具在环境中是否可用 - 如果可用且Exa AI不可用 → 使用内置WebSearch工具 - 实现:await WebSearch({ query: searchQuery }) - 注意:仅在Exa AI不可用时使用此选项
Priority 3: Cursor/OpenCode/OpenClaw Built-in Capabilities - 这些工具集成了网络搜索功能 - 使用其原生搜索能力 - 在上述工具都不可用时使用
Priority 4: Graceful Fallback - 如果没有检测到网络搜索能力 → 使用AI知识库 - 无错误,无缝体验
- Execute search (if capability detected AND
enablewebsearchis true):
When to search: - ✅ Web search capability available (from priority check) - ✅ enablewebsearch is true (default) or user hasn't disabled it - ✅ User hasn't used --no-search flag
How to search: - Generate 2-3 relevant search queries based on topic - Execute searches using the highest priority available method: - Exa AI: mcpexawebsearchexa({ query: query, numResults: 8 }) - WebSearch: WebSearch({ query: query }) - Collect latest information, data, statistics, and examples
- Handle results:
- Success: Organize findings into research summary - Key findings and insights - Recent developments or trends - Relevant statistics or data - Notable examples or case studies - Source URLs for reference - Save to wechat-articles/{topic-slug}/research.md
- Failure/No capability: Skip gracefully - Continue to Step 2 as normal - Use existing knowledge base - No error messages to user - seamless fallback
Implementation example for Claude Code with Exa AI:
// Pseudo-code for intelligent search selection
if (enable_web_search && !no_search_flag) {
try {
// Priority 1: Try Exa AI MCP (best quality)
if (hasExaAIMCP()) {
const results = await mcp__exa__web_search_exa({
query: searchQueries,
numResults: 8
});
saveResearch(results);
}
// Priority 2: Fall back to WebSearch tool
else if (typeof WebSearch !== 'undefined') {
const results = await WebSearch({ query: searchQueries });
saveResearch(results);
}
// Priority 3: Use built-in capabilities (Cursor/OpenCode)
else if (hasBuiltInSearch()) {
const results = await builtInSearch(searchQueries);
saveResearch(results);
}
// Priority 4: Graceful fallback
else {
// Continue without web research
}
} catch (error) {
// Search failed, continue without research
}
}
User control:
- Command line:
/wechat-article-writer "topic" --no-search - Configuration: Set
enablewebsearch: falsein EXTEND.md
Exa AI Setup (Recommended for best quality):
# Configure Exa AI MCP server
claude mcp add exa-search "https://api.exa.ai/mcp?key=YOUR_EXA_API_KEY" -t http
# Get your API key at https://exa.ai
# Free tier available with generous usage limits
Step 2: Smart Confirm
Present analysis to user:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 内容分析
主题: {topic}
类型: {type} | 风格: {style}
框架: {framework}
受众: {audience}
字数限制: {word_count_limit}字
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔍 联网搜索
状态: {已启用/已禁用/不支持}
结果: {已获取X条最新信息/跳过}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🎨 推荐方案
风格: {style}
信息图: {infographic_style} (2张)
标题: {title_count}个备选
摘要: 自动生成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
是否继续?(Y/n)
Wait for user confirmation before proceeding.
Step 3: Generate Titles (Using Title Specialist Agent)
调用标题专家子代理生成标题
作为主代理,你需要调用标题专家来生成专业标题。以下是具体执行步骤:
3.1 准备输入参数
从前面的步骤中提取以下信息:
- 主题: 从用户输入的主题
- 目标受众: 从Step 1分析得到的目标受众
- 文章风格: 从用户偏好或默认配置
- 字数要求: 15-25字
3.2 调用标题专家
使用Agent工具调用标题专家,按照以下prompt格式:
你现在是【标题专家】,专门为微信公众号文章创作高转化率的标题。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/title-specialist.md
输入参数:
- 主题: {从用户输入提取的主题}
- 目标受众: {目标受众}
- 文章风格: {风格}
- 字数要求: 15-25字
请严格按照 title-specialist.md 中的规范输出,包括:
1. 生成3个标题,每个标题标注使用的技巧和理由
2. 推荐1个最佳标题并说明推荐理由
3.3 处理输出
解析标题输出:
标题专家会返回Markdown格式的输出,包含:
**标题1**: {标题内容}
- **技巧**: {技巧名称}
- **理由**: {为什么有效}
**标题2**: ...
**标题3**: ...
**推荐**: 标题{N}
**推荐理由**: {为什么推荐}
处理步骤:
- 提取3个标题的内容
- 记录每个标题对应的技巧和理由
- 找到"推荐"部分,记录推荐标题的内容
- 验证标题长度是否为15-25字
保存输出:
- 将标题专家的完整输出保存到:
wechat-articles/{topic-slug}/titles.md - 记录推荐标题的内容,用于下一步骤
3.4 质量检查
- 生成了3个标题
- 每个标题标注了技巧和理由
- 有明确的推荐标题
- 标题长度符合要求(15-25字)
3.5 错误处理
如果标题专家失败:
- 使用降级方案: 生成默认标题
{主题} - 完整指南 - 记录失败原因
- 继续下一步骤
如果输出格式不完整:
- 提取可用的标题信息
- 手动选择第一个标题作为推荐
- 标注"部分输出"
Step 4: Design Structure (Using Structure Specialist Agent)
调用结构专家子代理设计结构
作为主代理,你需要调用结构专家来设计文章结构。以下是具体执行步骤:
4.1 准备输入参数
- 主题: 从用户输入的主题
- 选定标题: 从Step 3得到的推荐标题
- 目标受众: 从Step 1分析得到的目标受众
- 文章风格: 从用户偏好或默认配置
- 字数要求: 默认5000字或用户指定
4.2 调用结构专家
使用Agent工具调用结构专家,按照以下prompt格式:
你现在是【结构专家】,专门为微信公众号文章设计清晰的逻辑框架和段落架构。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/structure-specialist.md
输入参数:
- 主题: {主题}
- 选定标题: {从Step 3得到的推荐标题}
- 目标受众: {目标受众}
- 文章风格: {风格}
- 字数要求: {字数}字
请严格按照 structure-specialist.md 中的规范输出,包括:
1. 选择合适的文章类型并说明理由
2. 提炼中心思想(一句话概括)
3. 设计完整的文章结构大纲(开头、主体、结尾)
4. 分配各部分字数
4.3 处理输出
解析结构输出:
结构专家会返回Markdown格式的输出,包含:
**文章类型**: {类型名称}
**选择理由**: {为什么选择这个类型}
**中心思想**: {一句话概括}
**文章结构大纲**:
**开头部分**
- 主要内容: {...}
- 目标: {...}
- 字数: {N}字
**主体部分**
- 段落1: {...}
- 段落2: {...}
...
**结尾部分**
- 主要内容: {...}
- 字数: {N}字
处理步骤:
- 提取文章类型和选择理由
- 提取中心思想(一句话)
- 提取完整的结构大纲
- 验证各部分字数分配是否合理
保存输出:
- 将结构专家的完整输出保存到:
wechat-articles/{topic-slug}/structure.md - 记录中心思想,用于后续Review验证
4.4 质量检查
- 选择了合适的文章类型
- 提炼了清晰的中心思想
- 设计了完整的结构大纲
- 字数分配合理
4.5 错误处理
如果结构专家失败:
- 使用降级方案: 采用"总分总"结构
- 生成默认大纲: 开头(15%) + 主体(70%) + 结尾(15%)
- 记录失败原因
如果中心思想不明确:
- 根据主题和标题手动提炼中心思想
- 标注"手动提炼"
model: 'sonnet' });
// 解析输出 const structure = parseStructureOutput(structureResult); saveToFile(wechat-articles/${topicSlug}/structure.md, structureResult);
// 提取中心思想用于后续Review const centralTheme = structure.centralTheme;
**输出位置**: `wechat-articles/{topic-slug}/structure.md`
**质量检查:**
- [ ] 选择了合适的文章类型
- [ ] 提炼了清晰的中心思想
- [ ] 设计了完整的结构大纲
- [ ] 字数分配合理
### Step 5: Generate Content (Using Content Specialist Agent)
**调用内容专家子代理撰写内容**
作为主代理,你需要调用内容专家来撰写文章内容。以下是具体执行步骤:
#### 5.1 准备输入参数
- **主题**: 从用户输入的主题
- **选定标题**: 从Step 3得到的推荐标题
- **文章结构**: 从Step 4得到的结构大纲(完整Markdown)
- **目标受众**: 从Step 1分析得到的目标受众
- **文章风格**: 从用户偏好或默认配置
#### 5.2 调用内容专家
使用Agent工具调用内容专家,按照以下prompt格式:
你现在是【内容专家】,专门根据结构大纲和标题撰写高质量文章内容。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/content-specialist.md
输入参数:
- 主题: {主题}
- 选定标题: {从Step 3得到的推荐标题}
- 文章结构: {从Step 4得到的完整结构大纲}
- 目标受众: {目标受众}
- 文章风格: {风格}
请严格按照 content-specialist.md 中的规范输出,确保:
- 完全遵循结构大纲
- 内容支撑标题承诺
- 段落简短(2-4句),易于阅读
- 有具体案例和数据支撑
- 符合微信公众号写作规范
#### 5.3 处理输出
**保存内容:**
- 将内容专家的完整输出保存到: `wechat-articles/{topic-slug}/content-initial.md`
- 记录内容长度和段落数
#### 5.4 质量检查
- [ ] 内容符合结构大纲
- [ ] 围绕中心思想展开
- [ ] 有具体案例和数据
- [ ] 段落简短易读(2-4句)
- [ ] 符合字数要求
#### 5.5 错误处理
**如果内容专家失败:**
- 使用降级方案: 根据结构大纲生成简化内容
- 记录失败原因
- 标注"简化版本"
**如果内容偏离结构:**
- 记录偏离部分
- 在后续Review中修正
### Step 6: Review 1 - Theme Consistency (Using Review Specialist Agent)
**调用Review专家执行中心思想一致性检查**
作为主代理,你需要调用Review专家执行第一层质量检查。以下是具体执行步骤:
#### 6.1 准备输入参数
- **中心思想**: 从Step 4结构大纲中提取的中心思想
- **文章内容**: 从Step 5生成的初始内容
#### 6.2 调用Review专家
使用Agent工具调用Review专家,按照以下prompt格式:
你现在是【Review专家】,专门执行文章质量检查。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/review-specialist.md
现在执行【Review 1: 中心思想一致性检查】
输入参数:
- 中心思想: {从Step 4提取的中心思想}
- 文章内容: {从Step 5生成的文章内容}
请按照 review-specialist.md 中 Review 1 的规范输出:
- 评估结果(通过/需修改)和置信度(0-100)
- 问题列表(如有偏离主题的内容,标注位置)
- 具体修改建议
- 验证标准
如果需要修改,请明确指出问题位置和修改方向。
#### 6.3 处理输出
**解析Review输出:**
Review专家会返回包含评估结果的输出:
评估结果: {通过/需修改} 置信度: {0-100}
问题列表:
- 问题1: {描述} (位置: 第N段)
- 问题2: ...
修改建议: {...}
**保存输出:**
- 将Review 1的完整输出保存到: `wechat-articles/{topic-slug}/review-1.md`
#### 6.4 Review循环机制
**如果评估结果为"需修改":**
1. **检查重试次数:**
- 维护重试计数器(初始为0)
- 如果重试次数 < 3,继续修改
- 如果重试次数 ≥ 3,标记"部分通过",继续Step 7
2. **调用内容专家修改内容:**
使用Agent工具调用内容专家:
```
你现在是【内容专家】,需要根据Review 1的反馈优化内容。
请阅读你的角色配置: skills/wechat-article-writer/agents/content-specialist.md
输入参数:
- 初始内容: {当前文章内容}
- Review 1结果: {Review 1的完整输出}
请根据Review 1的问题列表和修改建议优化内容,然后输出优化后的完整文章。
当前重试次数: {N}/3
优化策略: {根据重试次数选择: 第1次直接修改/第2次分析根源/第3次全面重写}
```
3. **更新重试计数器:** 重试次数 + 1
4. **重新执行Review 1:** 返回Step 6.2
**如果评估结果为"通过":**
- 继续Step 7
#### 6.5 错误处理
**如果Review专家失败:**
- 使用降级方案: 标注"未经Review 1检查"
- 继续Step 7
**如果Review超时(>60秒):**
- 记录超时
- 标注"Review 1超时"
- 继续Step 7
#### 6.6 质量阈值优化(可选)
**引入质量阈值,避免过度Review:**
- 如果置信度 ≥ 80分,即使"需修改"也可选择通过
- 记录"高分通过"和修改建议
- 继续Step 7
这样可以减少不必要的重试,提升性能
### Step 7: Review 2 - Design & Language (Using Review Specialist Agent)
**调用Review专家执行设计与语言检查**
作为主代理,你需要调用Review专家执行第二层质量检查。以下是具体执行步骤:
#### 7.1 准备输入参数
- **文章内容**: 当前最新的文章内容(可能已通过Review 1修改)
#### 7.2 调用Review专家
使用Agent工具调用Review专家,按照以下prompt格式:
你现在是【Review专家】,专门执行文章质量检查。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/review-specialist.md
现在执行【Review 2: 设计与语言检查】
输入参数:
- 文章内容: {当前文章内容}
请按照 review-specialist.md 中 Review 2 的规范输出:
- 评估结果(通过/需修改)和置信度(0-100)
- 问题列表(错别字、语法错误、语义不通等,标注位置)
- 具体修改建议
- 验证标准
#### 7.3 处理输出
**保存输出:**
- 将Review 2的完整输出保存到: `wechat-articles/{topic-slug}/review-2.md`
#### 7.4 Review循环机制
**如果评估结果为"需修改":**
执行与Review 1相同的循环逻辑:
1. 检查重试次数(最多3次)
2. 调用内容专家根据Review 2反馈修改
3. 更新重试计数器
4. 重新执行Review 7.2
**如果评估结果为"通过":**
- 继续Step 8
#### 7.5 错误处理
**如果Review专家失败:**
- 标注"未经Review 2检查"
- 继续Step 8
**如果Review超时(>60秒):**
- 记录超时
- 标注"Review 2超时"
- 继续Step 8
#### 7.6 质量阈值优化(可选)
- 如果置信度 ≥ 80分,即使"需修改"也可选择通过
- 记录"高分通过"和修改建议
- 继续Step 8
### Step 8: Review 3 - AI Removal & Colloquial Optimization (Using Review Specialist Agent)
**调用Review专家执行去AI化与口语化优化**
作为主代理,你需要调用Review专家执行第三层质量检查。以下是具体执行步骤:
#### 8.1 准备输入参数
- **文章内容**: 当前最新的文章内容(可能已通过Review 1和Review 2修改)
- **目标受众**: 从Step 1分析得到的目标受众
#### 8.2 调用Review专家
使用Agent工具调用Review专家,按照以下prompt格式:
你现在是【Review专家】,专门执行文章质量检查。
请阅读你的角色配置文件: skills/wechat-article-writer/agents/review-specialist.md
现在执行【Review 3: 去AI化与口语化优化】
输入参数:
- 文章内容: {当前文章内容}
- 目标受众: {目标受众}
请按照 review-specialist.md 中 Review 3 的规范输出:
- 评估结果(通过/需修改)和置信度(0-100)
- AI痕迹列表(过度结构化、空洞表达等,标注位置)
- 口语化建议(具体给出优化前后对比)
- 验证标准
#### 8.3 处理输出
**保存输出:**
- 将Review 3的完整输出保存到: `wechat-articles/{topic-slug}/review-3.md`
#### 8.4 Review循环机制
**如果评估结果为"需修改":**
执行与Review 1相同的循环逻辑:
1. 检查重试次数(最多3次)
2. 调用内容专家根据Review 3反馈修改
3. 更新重试计数器
4. 重新执行Step 8.2
**如果评估结果为"通过":**
- 准备生成最终优化版本
#### 8.5 生成最终优化版本
**Review全部通过后,调用内容专家生成最终版本:**
使用Agent工具调用内容专家:
你现在是【内容专家】,需要根据三层Review的反馈生成最终优化版本。
请阅读你的角色配置: skills/wechat-article-writer/agents/content-specialist.md
输入参数:
- 初始内容: {当前文章内容}
- Review 1结果: {Review 1的输出}
- Review 2结果: {Review 2的输出}
- Review 3结果: {Review 3的输出}
请整合所有三层Review的修改建议,输出最终的优化文章内容。
要求:
- 整合所有有效的修改建议
- 确保不引入新问题
- 保持文章完整性和连贯性
**保存最终内容:**
- 将最终优化版本作为后续多版本生成的基础
#### 8.6 错误处理
**如果Review专家失败:**
- 标注"未经Review 3检查"
- 使用当前内容继续Step 9
**如果Review超时(>60秒):**
- 记录超时
- 标注"Review 3超时"
- 继续Step 9
#### 8.7 质量阈值优化(可选)
- 如果置信度 ≥ 80分,即使"需修改"也可选择通过
- 记录"高分通过"和修改建议
- 继续Step 9
---
**Review循环机制总结:**
每层Review最多重试3次:
- **第1次修改**: 根据问题列表直接修改
- **第2次修改**: 分析问题根源,针对性修改
- **第3次修改**: 全面审查,系统性修改
如果3次后仍未完全通过,标记为"部分通过",记录未解决问题,继续下一步。这样可以避免死循环,同时保证质量。
**性能优化建议:**
- 引入质量阈值(≥80分即可通过)
- 设置超时限制(每层Review最多60秒)
- 并行执行Review 1和Review 2(可选)
---
### Step 9: Generate Article Versions
- The outline structure
- User's voice preferences (professional/casual/friendly)
- **Word count limit**: Stay within the specified word count limit (default 5000 words)
- **Research integration**: If web research was conducted, incorporate relevant findings into the article
- WeChat formatting best practices:
- Use emoji in section headers (📌 💡 🎯 📊 ✅)
- Keep paragraphs short (2-4 sentences)
- Use **bold** for emphasis
- Include practical examples
**Word count management**:
- Monitor word count during generation
- If approaching limit, prioritize essential content
- Ensure conclusion section is included even if abbreviated
- Note: Word count refers to Chinese characters, not English words
**Using research materials** (if Step 1.5 was executed):
- Integrate latest data and statistics from research
- Reference recent developments or trends discovered
- Cite specific examples or case studies found
- Ensure information is accurate and up-to-date
Save to: `wechat-articles/{topic-slug}/article.md`
### Step 4.5: Generate Article Variants (WeChat Compatibility)
**Why**: WeChat Official Account articles do not support Markdown formatting. Generate multiple versions for different use cases.
**Generate 3 additional versions**:
#### 1. 1000-Word Condensed Version (Markdown)
**Purpose**: Quick-read version for users who want the key insights without reading the full article.
**Process**:
- Extract the most important 3-4 points from the full article
- Maintain the core message and value proposition
- Keep Markdown formatting for blog/platform publication
- Word count: ~1000 Chinese characters (±10%)
**Content guidelines**:
- Focus on the most impactful insights
- Remove detailed examples and explanations
- Keep section headers and structure
- Maintain readability and flow
Save to: `wechat-articles/{topic-slug}/article-1000.md`
#### 2. 1000-Word Condensed Version (Plain Text)
**Purpose**: Direct copy-paste to WeChat editor without formatting issues.
**Process**:
- Use the same content as the 1000-word Markdown version
- **Remove all Markdown formatting**:
- Remove `#` headers → Use plain text with line breaks
- Remove `**bold**` → Just plain text
- Remove `*italic*` → Just plain text
- Remove `-` list markers → Use plain text
- Remove `[text](url)` links → Just keep text
- Remove code blocks → Use plain text
- Keep emojis in section headers (微信支持emoji)
- Word count: ~1000 Chinese characters (±10%)
**Format example**:
标题:文章标题
引言段落...
📌 核心要点一 内容描述...
📌 核心要点二 内容描述...
📌 核心要点三 内容描述...
总结...
Save to: `wechat-articles/{topic-slug}/article-1000-plain.txt`
#### 3. Full-Length Plain Text Version
**Purpose**: Complete article content without Markdown, ready for WeChat publication.
**Process**:
- Use the full article content from Step 4
- **Remove all Markdown formatting**:
- Remove `#` headers → Use plain text with line breaks
- Remove `**bold**` → Just plain text
- Remove `*italic*` → Just plain text
- Remove `-` list markers → Use plain text
- Remove `[text](url)` links → Just keep text or add as plain text reference
- Remove code blocks → Use plain text
- Remove `> ` blockquotes → Just plain text
- Keep emojis in section headers (微信支持emoji)
- Maintain all content and examples
- Word count: Same as full Markdown version
**Format example**:
标题:文章标题
副标题或引言...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📌 第一部分标题
内容段落...
💡 核心观点 详细说明...
📊 数据支持 具体数据...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 📌 第二部分标题
内容段落...
(以此类推)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 总结
总结内容...
Save to: `wechat-articles/{topic-slug}/article-plain.txt`
**Quality Check**:
- [ ] All three versions generated
- [ ] Markdown properly removed from plain text versions
- [ ] Word counts match targets (1000±100 for condensed, full length for complete)
- [ ] Emojis preserved in headers
- [ ] Content remains coherent without Markdown formatting
- [ ] Ready for direct copy-paste to WeChat editor
### Step 5: Review & Refine
**Critical quality control step** - Review the generated article for:
#### Review Checklist
**✅ Content Accuracy**
- [ ] Facts and data are correct
- [ ] Code examples are valid and runnable
- [ ] Technical concepts are explained accurately
- [ ] No misleading or incorrect information
**✅ Topic Relevance**
- [ ] Article stays on topic throughout
- [ ] All sections directly support the main theme
- [ ] No unnecessary tangents or off-topic content
- [ ] Examples and cases align with the topic
**✅ Structure & Flow**
- [ ] Logical progression from beginning to end
- [ ] Clear transitions between sections
- [ ] Consistent voice and tone
- [ ] Balanced depth across sections
**✅ Quality Standards**
- [ ] Clear and easy to understand
- [ ] Practical and actionable
- [ ] Engaging and readable
- [ ] Proper formatting and emoji usage
#### Review Process
1. **Self-Review**: AI tool reviews its own generated content
2. **Issue Identification**: Note any problems found
3. **Refinement**: Fix identified issues
4. **Final Check**: Verify all checklist items pass
#### Refinement Guidelines
If issues are found:
- **Content errors**: Correct inaccurate information
- **Off-topic content**: Remove or redirect to the main theme
- **Unclear explanations**: Rewrite for clarity
- **Missing elements**: Add necessary examples or context
- **Poor flow**: Reorganize or add transitions
**Important**: Do not proceed to infographic generation until the article passes all review criteria.
Save refined version to: `wechat-articles/{topic-slug}/article.md` (overwrite if needed)
### Step 6: Generate Infographic Descriptions
Create detailed descriptions for 2 infographics that best visualize the article content.
**What to describe**:
1. **Infographic 1**: Core concept diagram or framework visualization
- Identify the most important concept from the article
- Design a visual representation (comparison, flow, or structure)
- Specify visual style, colors, and layout
2. **Infographic 2**: Process or method diagram
- Choose a practical process or method from the article
- Design step-by-step visualization
- Include key points and examples
**Description format** (save as Markdown files):
Infographic Title
Type
[concept-comparison | process-flow | data-visualization]
Visual Style
- Theme: [notion | warm | minimal | professional]
- Colors: [color scheme]
- Layout: [vertical | horizontal | grid]
Content
[Detailed description of what should be visualized]
Text Elements
- Title: [main title]
- Headers: [section headers]
- Labels: [data labels or annotations]
Visual Elements
- Icons needed: [list]
- Charts needed: [bar/line/pie/etc.]
- Diagram type: [flowchart/mindmap/etc.]
Save descriptions to: `wechat-articles/{topic-slug}/infographic/prompts/01-*.md` and `02-*.md`
### Step 7: Generate PNG Images
**Automatically generate actual PNG images** using the infographic-generator skill.
**Implementation**:
For each infographic description
/infographic-generator infographic/prompts/01-.md --output infographic/01-.png /infographic-generator infographic/prompts/02-.md --output infographic/02-.png
**Process**:
1. **Check skill availability**: Verify if `infographic-generator` skill is available
2. **Invoke skill**: Call the skill for each infographic description
3. **Handle output**: Save generated PNG images to the output directory
4. **Fallback**: If skill not available, save description files and inform user
**Quality Check**:
- Verify PNG files are generated successfully
- Check image quality and content match
- If generation fails, save description for manual generation later
**Output location**:
wechat-articles/{topic-slug}/infographic/ ├── 01-concept.png # Generated PNG image 1 ├── 02-process.png # Generated PNG image 2 └── prompts/ # Description files (backup) ├── 01-concept.md └── 02-process.md
**User Communication**:
- ✅ If PNGs generated: "已生成2张信息图PNG图片"
- ⚠️ If skill unavailable: "信息图描述已保存,可使用 /infographic-generator 手动生成PNG"
### Step 8: Save Outputs
Create complete directory structure with all generated content:
wechat-articles/{topic-slug}/ ├── source.md # User's original input ├── analysis.md # Content analysis report ├── research.md # Web research findings (if web search was enabled) ├── titles.md # 3 titles with techniques and rationales ├── structure.md # Article structure and outline ├── content-initial.md # Initial content before reviews ├── review-1.md # Review 1: Theme consistency ├── review-2.md # Review 2: Design and language ├── review-3.md # Review 3: AI removal and colloquial ├── article-full.md # Full article (Markdown, 5000 words) ├── article-condensed.md # Condensed version (Markdown, 1000 words) ├── article-full-plain.txt # Full version (Plain text, WeChat compatible) ├── article-condensed-plain.txt # Condensed version (Plain text, 1000 words) ├── infographic/ # Infographic outputs │ ├── 01-.png # Generated PNG image 1 │ ├── 02-.png # Generated PNG image 2 │ └── prompts/ # Description files (backup) │ ├── 01-.md │ └── 02-.md └── meta.json # Metadata (tags, SEO info)
**Save process**:
1. Create output directory
2. Save titles with techniques and rationales
3. Save article structure and outline
4. Save initial content before reviews
5. Save all three review results
6. Save 4 article variants (full/condensed × markdown/plain text)
7. Organize infographic assets
8. Generate metadata file with article stats
### Step 13: Output Summary
Present comprehensive results to user:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ✅ WeChat Article Complete!
Topic: {topic} Style: {style} Voice: {voice}
Output: 📋 titles.md (3 engaging titles) 📋 structure.md (Article structure) 📄 content-initial.md (Initial content) 🔍 review-1.md (Theme consistency) 🔍 review-2.md (Design & language) 🔍 review-3.md (AI removal & colloquial) 📄 article-full.md (Full version, Markdown, 5000 words) 📄 article-condensed.md (Condensed, Markdown, 1000 words) 📄 article-full-plain.txt (Full version, Plain text, WeChat compatible) 📄 article-condensed-plain.txt (Condensed, Plain text, 1000 words) 🖼️ infographic/ ├─ 01-.png (PNG image 1) └─ 02-.png (PNG image 2) 📋 meta.json (metadata)
Files: ✓ {path}/titles.md ✓ {path}/structure.md ✓ {path}/content-initial.md ✓ {path}/review-1.md ✓ {path}/review-2.md ✓ {path}/review-3.md ✓ {path}/article-full.md ✓ {path}/article-condensed.md ✓ {path}/article-full-plain.txt ✓ {path}/article-condensed-plain.txt ✓ {path}/infographic/01-.png ✓ {path}/infographic/02-.png
Next Steps: → For WeChat: Use article-full-plain.txt or article-condensed-plain.txt → For Blog: Use article-full.md or article-condensed.md → Review all generated content → Preview infographic images → Run /baoyu-post-to-wechat to publish ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
## Technical Implementation Notes
**This skill is designed to be executed by AI tools directly, not as standalone scripts.**
- AI tools read SKILL.md and execute the workflow using their built-in capabilities
- No API key configuration required - AI tool's built-in capabilities are sufficient
- The `scripts/` directory contains **optional helper scripts** for advanced users only
- External APIs (like Claude API) are only needed for standalone script usage
### For Advanced Users: Standalone Scripts
If you want to run the skill standalone (not through an AI tool):
1. You'll need a Claude API key
2. Install Bun runtime
3. See `scripts/README.md` for detailed instructions
**Most users should ignore the scripts directory and use the skill through their AI tool.**
## Output Structure
All outputs are saved in `wechat-articles/{topic-slug}/` directory:
wechat-articles/{topic-slug}/ ├── source.md # Original user input ├── analysis.md # Content analysis report ├── outline.md # Article outline structure ├── article.md # Full article (Markdown, 5000 words) ├── article-1000.md # Condensed version (Markdown, 1000 words) ├── article-1000-plain.txt # Condensed version (Plain text, 1000 words) ├── article-plain.txt # Full version (Plain text, no Markdown) ├── infographic/ # Generated infographics │ ├── 01-.png # PNG image 1 (auto-generated) │ ├── 02-.png # PNG image 2 (auto-generated) │ └── prompts/ # Image description files (backup) │ ├── 01-.md # Description for image 1 │ └── 02-.md # Description for image 2 └── meta.json # Article metadata (tags, SEO, statistics)
**Key Deliverables**:
- ✅ **titles.md**: 3 engaging titles with techniques and rationales
- ✅ **structure.md**: Article structure and outline
- ✅ **content-initial.md**: Initial content before reviews
- ✅ **review-1.md**: Theme consistency review results
- ✅ **review-2.md**: Design and language review results
- ✅ **review-3.md**: AI removal and colloquial optimization results
- ✅ **article-full.md**: Complete article (Markdown, 5000 words)
- ✅ **article-condensed.md**: Condensed version (Markdown, 1000 words)
- ✅ **article-full-plain.txt**: Full version for WeChat (Plain text, no Markdown)
- ✅ **article-condensed-plain.txt**: Condensed version for WeChat (Plain text, 1000 words)
- ✅ **PNG images**: 2 high-quality infographics (auto-generated)
- ✅ **research.md**: Latest information and data (if web search enabled)
- ✅ **meta.json**: SEO metadata for publishing
**WeChat Publishing Guide**:
- **For WeChat Official Account**: Use `article-full-plain.txt` or `article-condensed-plain.txt`
- **Why**: These files have no Markdown formatting, ready for direct copy-paste
- **Note**: Emojis in headers are preserved (WeChat supports emojis)
- **For other platforms** (blog, knowledge base): Use Markdown versions (article-full.md, article-condensed.md)
- **Review process**: All articles go through three layers of review (theme consistency, design & language, AI removal & colloquial optimization)
## Preferences Configuration
Create `skills/wechat-article-writer/EXTEND.md` to customize default preferences:
Writing Preferences
Content Style
- Language: Chinese (Simplified)
- Tone: Professional yet accessible
- Word count limit: 5000 (customizable, default 5000)
- Structure: Problem → Solution → Examples → Conclusion
Format Preferences
- Headings: H1, H2, H3 hierarchy
- Lists: Numbered for procedures, bullet for features
- Code blocks: Include for technical topics
- Tables: For comparisons and data
Infographic Style
- Theme: Clean, modern, professional
- Color palette: Blue/gray/green scheme
- Elements: Icons, charts, diagrams
## Examples
### Example 1: Technical Tutorial
/wechat-article-writer "Go语言微服务架构实践:从零到部署"
**Output:**
- Topic: Microservices architecture with Go
- Sections: Background, Architecture Design, Implementation, Deployment, Best Practices
- Infographics: Architecture diagram, workflow chart, deployment process
### Example 2: Industry Analysis
/wechat-article-writer "2024年AI发展趋势与商业应用分析"
**Output:**
- Topic: AI industry trends and business applications
- Sections: Market Overview, Key Trends, Business Cases, Future Outlook
- Infographics: Market size chart, trend timeline, application matrix
## Common Pitfalls
1. **Skipping content analysis** - Always analyze the topic before generation to ensure quality
2. **Not customizing preferences** - Default preferences may not match your writing style
3. **Missing infographics** - Visual content significantly increases article engagement
4. **Poor outline structure** - A good outline is essential for coherent article flow
5. **Ignoring SEO** - Include keywords and meta information for search optimization
## References
- WeChat Official Account Publishing Guidelines
- AI Content Generation Best Practices
- Infographic Design Principles
- Technical Writing Standards
## Future Enhancements
- Multi-platform publishing support (WeChat, Zhihu,掘金)
- Automatic SEO optimization
- Template library for common article types
- Collaborative editing features
- Performance analytics integration