第六部分：实战案例分析

本部分的：通过分析真实的企业级Skill，学习高级设计模式。

6.1 多步骤工作流设计

案例：公众号写作流程（8步自动化）

步骤0：选题过滤
    │
    │ worth_writing?
    │
    ├──→ No ──→ 结束，给出建议
    │
    ▼ Yes
步骤1：读取规范
    │
    ▼
步骤2：智能判断（是否需要Research）
    │
    │ need_research?
    │
    ├──────────┬──────────┤
    │          │          │
    ▼          ▼
步骤3      跳过
(Research)
    │          │
    └────┬─────┘
         │
         ▼
步骤4：创作文章
         │
    ┌────┴────┐
    │         │
    ▼         ▼
步骤5     步骤7
(标题)    (质量检测)
    │         │
    └────┬────┘
         │
         ▼
步骤6：保存 ←── 条件：质量检测通过
         │
         ▼
步骤8：发文前检查

工作流定义原则：

1. 单一职责：每个步骤只做一件事
2. 明确输入输出：步骤间数据传递清晰
3. 可断点恢复：失败后可以从断点继续
4. 可观测：每个步骤都有状态反馈

6.2 数据驱动架构

公众号写作助手的数据驱动流程：

数据收集 → 数据分析 → 自动同步 → 配置更新 → 脚本生效
    │          │          │          │          │
    │          │          │          │          ▼
    │          │          │          │      质检/标题
    │          │          │          │      脚本使用
    │          │          │          │      新配置
    │          │          │          │
    │          │          │          ▼
    │          │          │   formulas_config.json
    │          │          │   brands_config.json
    │          │          │   quality_config.json
    │          │          │
    │          │          ▼
    │          │   sync_config.py
    │          │   （自动同步脚本）
    │          │
    │          ▼
    │   rule_validation_report.json
    │   （分析报告）
    │
    ▼
wechat_articles.json
（原始数据）

配置文件示例（formulas_config.json）：

{
  "version": "8.0",
  "last_updated": "2025-12-17",
  "formulas": {
    "tool_recommendation": {
      "name": "工具推荐型",
      "pattern": "[品牌词] + [数字] + [推荐词]",
      "effectiveness": 5.25,
      "example": "Claude Code 5个必装插件，让你的开发效率翻倍"
    },
    "tutorial": {
      "name": "教程词型",
      "pattern": "[动作词] + [品牌词] + [场景]",
      "effectiveness": 1.95,
      "example": "手把手教你用Cursor，从入门到精通"
    }
  }
}

6.3 企业级Skill目录结构

公众号写作助手完整结构（V9.0 当前版本适配）：

.claude/skills/gongzhonghao-writer/
├── SKILL.md                              (核心定义文件：YAML + Markdown)
├── scripts/
│   ├── core/
│   │   ├── quality_detector.py           (质量检测)
│   │   ├── title_generator.py            (标题生成)
│   │   ├── title_scorer.py               (标题评分)
│   │   ├── topic_filter.py               (选题过滤)
│   │   └── pre_publish_checker.py        (发布检查)
│   ├── collectors/
│   │   └── collect_time_range.py         (数据收集)
│   └── utils/
│       └── fix_feishu_format.py          (格式修复)
├── config/
│   ├── formulas_config.json              (公式配置)
│   ├── brands_config.json                (品牌配置)
│   ├── quality_config.json               (质检配置)
│   └── sync_config.py                    (同步脚本)
├── instructions/
│   └── workflow.md                       (详细指令)
└── DATA_DRIVEN_WORKFLOW.md               (数据驱动文档)

SKILL.md结构示例：

---
name: gongzhonghao-writer
description: 当用户提到"公众号"、"写文章"、"老金风格"等关键词时，自动激活AI写作助手系统
---

# 公众号写作助手 V9.0

## 版本历史
[版本演进记录...]

## 一、角色定义
你是一位经验丰富的公众号写作专家...

## 二、核心能力
1. 爆款标题生成（5大公式）
2. 老金风格文章创作
3. 9维度质量检测
4. 选题自动过滤

## 三、工作流程
### 步骤1：选题过滤
[三层架构判断...]

### 步骤2：智能判断Research
[是否需要Research...]

### 步骤3：创作文章
[应用老金风格...]

### 步骤4：标题生成
[5大公式...]

### 步骤5：质量检测
[9维度检测...]

## 四、规则约束
[爆款规律、质量标准...]

## 五、工具调用
- 质量检测：`python scripts/core/quality_detector.py`
- 标题生成：`python scripts/core/title_generator.py`
- 选题过滤：`python scripts/core/topic_filter.py`

## 六、配置文件
- formulas_config.json：爆款公式配置
- brands_config.json：品牌词库
- quality_config.json：质检标准

关键设计点（V9.0更新）：

1. 单文件入口：SKILL.md替代skill.yaml+prompts/，简化管理
2. Hot Reloading：修改SKILL.md后立即生效
3. 脚本分类：core（核心）、collectors（收集）、utils（工具）
4. 配置驱动：所有可变参数放在config/目录
5. 渐进式披露：YAML Frontmatter常驻，Markdown Body按需加载