skill.json

{
  "name": "wechat-burst-gen",
  "version": "2.0.0",
  "description": "公众号爆款文章生成器 - 具备自我迭代优化能力，支持教程转文章",
  "author": "ruby鑫燕",
  "main": "main.py",

  "features": [
    "从Get笔记知识库获取素材",
    "AI生成高质量文章内容",
    "自动生成配图（封面+配图）",
    "10维度资深编辑审稿",
    "基于审稿意见自动重写",
    "自我学习系统持续优化",
    "教程内容转公众号文章",
    "完整的6步自动化工作流"
  ],

  "config": {
    "getnote": {
      "api_key": "${GETNOTE_API_KEY}",
      "kb_id": "707AGXvn"
    },
    "feishu": {
      "app_id": "${FEISHU_APP_ID}",
      "app_secret": "${FEISHU_APP_SECRET}",
      "bitable_token": "${FEISHU_BITABLE_TOKEN}",
      "table_id": "${FEISHU_TABLE_ID}",
      "folder_token": "${FEISHU_FOLDER_TOKEN}"
    },
    "image": {
      "api_key": "sk-DIByfAZ3S7xYSNZxwkD9Vf7GtOHQ9U9N8XNUkc08NpFNPHHH",
      "vision_api_key": "sk-3fIEB7PsdNPZTDfO2N62I8lhJbYjNAVmH6WXlsazmcXwulLS",
      "base_url": "https://xiaohumini.site"
    },
    "defaults": {
      "author": "ruby鑫燕",
      "style": "简约",
      "images_per_article": 3,
      "word_count": 2000
    }
  },

  "dependencies": {
    "python": ">=3.8",
    "packages": {
      "anthropic": "latest",
      "requests": ">=2.28.0",
      "jinja2": ">=3.1.0",
      "markdown": ">=3.4.0"
    }
  },

  "commands": {
    "generate": {
      "description": "生成公众号文章（支持自动审稿+优化）",
      "usage": "python main.py <主题> -c <分类> -w <字数> --auto-review --auto-optimize --no-feishu",
      "examples": [
        "python main.py \"职场沟通技巧\" -c 职场 -w 2000 --auto-review --auto-optimize --no-feishu",
        "python main.py \"AI提示词进阶\" -c 科技 -w 2500 --auto-review --no-feishu"
      ]
    },
    "query": {
      "description": "查询Get笔记素材",
      "usage": "./query.sh <关键词> -c <分类> -n <数量>",
      "examples": [
        "./query.sh \"职场效率\" -c 职场 -n 5",
        "./query.sh \"AI技术\" -c 科技 -n 3 -v"
      ]
    },
    "tutorial": {
      "description": "教程转文章（3种类型）",
      "usage": "python tutorial_to_article.py <教程文件> -t <类型>",
      "types": {
        "framework": "框架方法型 - 适合提示词、方法论",
        "practical": "实用教程型 - 适合操作指南、工具使用",
        "case_study": "案例分析型 - 适合调研、案例深度分析"
      },
      "examples": [
        "python tutorial_to_article.py tutorials/prompt_guide.md -t framework",
        "python tutorial_to_article.py tutorials/tool_guide.md -t practical",
        "python tutorial_to_article.py tutorials/case_study.md -t case_study"
      ]
    },
    "workflow": {
      "description": "完整自动化工作流（推荐）",
      "usage": "./workflow.sh <主题> <分类> <字数>",
      "steps": [
        "1. 生成初稿",
        "2. 首次审稿",
        "3. 基于审稿重写",
        "4. 转HTML并配图",
        "5. 二次审稿",
        "6. 自我学习优化"
      ],
      "examples": [
        "./workflow.sh \"职场沟通技巧\" 职场 2000"
      ]
    },
    "convert": {
      "description": "Markdown转HTML+配图",
      "usage": "python md_to_html.py <md文件> [-a 作者] [--no-images]",
      "examples": [
        "python md_to_html.py output/article.md",
        "python md_to_html.py output/article.md --no-images"
      ]
    },
    "review": {
      "description": "10维度编辑审稿",
      "usage": "python editor_review.py <html文件>",
      "examples": [
        "python editor_review.py output/article_*_final.html"
      ]
    },
    "rewrite": {
      "description": "基于审稿意见重写",
      "usage": "python rewrite_with_persona.py <review文件> <原文件>",
      "examples": [
        "python rewrite_with_persona.py output/*_review.md output/*.html"
      ]
    },
    "learn": {
      "description": "自我学习系统",
      "usage": "python self_learning.py <review文件> [--show-prompt]",
      "examples": [
        "python self_learning.py output/*_review.md",
        "python self_learning.py output/*_review.md --show-prompt"
      ]
    }
  },

  "modules": {
    "core": {
      "main.py": "主程序 - 集成OptimizedContentGenerator",
      "tutorial_to_article.py": "教程转文章生成器",
      "md_to_html.py": "Markdown转HTML+配图",
      "query_materials.py": "素材查询工具",
      "query.sh": "素材查询脚本"
    },
    "quality": {
      "editor_review.py": "10维度审稿系统",
      "rewrite_with_persona.py": "基于审稿重写",
      "self_learning.py": "自我学习系统"
    },
    "automation": {
      "workflow.sh": "6步自动化工作流"
    },
    "libraries": {
      "modules/content_gen.py": "AI内容生成",
      "modules/layout_engine.py": "HTML排版引擎（修复标题重复）",
      "modules/image_match.py": "图片生成模块",
      "mcp_tools/getnote.py": "Get笔记API客户端",
      "mcp_tools/feishu.py": "飞书API客户端"
    }
  },

  "key_features": {
    "self_learning": {
      "description": "自我学习与持续优化",
      "capabilities": [
        "分析审稿意见提取问题模式",
        "识别根本原因",
        "自动优化提示词模板（prompt_templates.json）",
        "生成发布前检查清单（pre_publish_checklist.md）",
        "记录优化历史（learning_log.jsonl）",
        "累积已知问题库（known_issues.json）"
      ],
      "improvement_cycle": "生成 → 审稿 → 提取问题 → 优化配置 → 下次生成应用",
      "score_trajectory": "65→75→83-88（预期）"
    },
    "tutorial_conversion": {
      "description": "教程内容转公众号文章",
      "persona": "ruby鑫燕 - 北京大妞儿风格",
      "transformations": [
        "专业术语 → 大白话",
        "理论框架 → 实战案例",
        "学术表述 → 口语化表达",
        "抽象概念 → 生动比喻"
      ],
      "language_features": [
        "咱们、姐妹们、哥们儿",
        "其实、说白了、你想啊",
        "呗、嘛、哈（北京话）"
      ]
    },
    "auto_optimization": {
      "description": "自动审稿与配置优化",
      "trigger": "分数 < 85",
      "process": [
        "10维度打分",
        "提取具体问题",
        "分析根本原因",
        "生成优化建议",
        "更新配置模板",
        "生成检查清单"
      ],
      "persistence": "配置自动持久化，下次生成立即应用"
    }
  },

  "quality_system": {
    "scoring_dimensions": [
      "选题价值 (0-10)",
      "引流能力 (0-10)",
      "内容逻辑 (0-10)",
      "主标题 (0-10)",
      "子标题 (0-10)",
      "语气调性 (0-10)",
      "人设契合 (0-10)",
      "洞察深度 (0-10)",
      "非暴力沟通 (0-10)",
      "整体质量 (0-10)"
    ],
    "standards": {
      "excellent": "85+ 可直接发布",
      "good": "70-84 小幅修改后发布",
      "acceptable": "60-69 大幅修改后发布",
      "poor": "<60 建议重写"
    },
    "persona_requirements": {
      "name": "ruby鑫燕",
      "background": "高级经管硕士，职场专家",
      "style": "北京大妞儿",
      "traits": [
        "幽默风趣，直接不绕弯",
        "简洁有力，不说废话",
        "平等对话，拒绝说教",
        "洞察力强，化繁为简"
      ]
    }
  },

  "file_structure": {
    "output/": {
      "description": "生成的文章文件",
      "patterns": {
        "article_*.html": "初稿HTML",
        "article_*_review.md": "审稿报告",
        "article_*_rewritten.md": "重写Markdown",
        "article_*_rewritten_final.html": "最终HTML",
        "tutorial_article_*.md": "教程转文章Markdown",
        "tutorial_article_*_final.html": "教程转文章HTML"
      }
    },
    "images/": {
      "description": "AI生成的配图",
      "patterns": {
        "gemini_*_1.png": "封面图（1792x1024）",
        "gemini_*_[2-4].png": "配图（1024x1024）"
      }
    },
    "config/": {
      "description": "配置和优化记录",
      "files": {
        "getnote.env": "Get笔记API配置",
        "prompt_templates.json": "提示词模板（自动更新）",
        "prompt_library.json": "高级提示词框架库",
        "known_issues.json": "已知问题库",
        "learning_log.jsonl": "学习日志",
        "pre_publish_checklist.md": "发布前检查清单"
      }
    },
    "tutorials/": {
      "description": "教程源文件",
      "files": {
        "prompt_frameworks_tutorial.md": "提示词框架教程"
      }
    }
  },

  "recent_updates": {
    "v2.0.0": [
      "✅ 修复HTML标题重复问题（layout_engine.py）",
      "✅ 集成OptimizedContentGenerator到主程序",
      "✅ 添加--auto-review和--auto-optimize参数",
      "✅ 创建tutorial_to_article.py（3种类型）",
      "✅ 创建self_learning.py自我学习系统",
      "✅ 创建prompt_library.json框架库",
      "✅ 实现配置持久化与自动应用",
      "✅ 生成动态检查清单",
      "✅ 作者名统一为ruby鑫燕",
      "✅ 去除AI标识文字"
    ]
  },

  "performance_metrics": {
    "quality_improvement": {
      "initial": "65-70/100",
      "first_rewrite": "75/100",
      "after_optimization": "81/100（实测）",
      "expected_peak": "83-88/100",
      "total_improvement": "+18-23分"
    },
    "key_improvements": [
      "人设契合：3 → 7 → 9（预期）",
      "语气调性：4 → 6 → 8（预期）",
      "标题质量：5 → 7 → 8（预期）"
    ]
  },

  "documentation": {
    "README_SELF_LEARNING.md": "自我学习系统完整说明",
    "TUTORIAL_TO_ARTICLE_GUIDE.md": "教程转文章使用指南",
    "INTEGRATION_COMPLETE.md": "系统集成完成总结",
    "QUICKREF.md": "快速参考卡片",
    "QUERY_GUIDE.md": "素材查询指南",
    "config/GETNOTE_SETUP.md": "Get笔记配置说明"
  },

  "quick_start": {
    "basic": "python main.py \"主题\" -c 分类 --no-feishu",
    "with_review": "python main.py \"主题\" -c 分类 --auto-review --no-feishu",
    "full_auto": "python main.py \"主题\" -c 分类 --auto-review --auto-optimize --no-feishu",
    "workflow": "./workflow.sh \"主题\" 分类 字数",
    "tutorial": "python tutorial_to_article.py tutorials/xxx.md -t framework"
  }
}