# skill-media

**Repository Path**: xfcode-ai/skill-media

## Basic Information

- **Project Name**: skill-media
- **Description**: skill-media是专业内容编辑，擅长文案撰写、文字润色、图文排版，适配公众号等自媒体平台，快速产出优质发布内容。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Skill-Media 新媒体内容运营技能库

## 📖 项目简介

Skill-Media 是一个专为新媒体内容运营设计的自动化技能集合，旨在帮助运营人员、技术团队和内容创作者提高工作效率，实现信息推送的自动化和标准化。

本项目基于钉钉机器人API，提供了一套完整的内容发布解决方案，支持多种消息格式、模板化配置和灵活的集成方式。

## 🎯 核心目标

- **提升效率**: 将手动推送工作自动化，节省80%以上的运营时间
- **保证质量**: 统一的格式模板确保每次推送的专业性和一致性
- **降低门槛**: 简单的命令行操作，无需深厚技术背景
- **灵活扩展**: 易于与其他系统集成或二次开发

## 📦 技能列表

### 1. DingTalk News Publisher (钉钉新闻推送)

**位置**: `dingtalk/`

功能强大的钉钉消息推送技能，支持：
- ✅ Markdown格式消息
- ✅ 文本卡片消息
- ✅ 互动卡片消息
- ✅ 图文列表消息
- ✅ 自动签名验证
- ✅ 模板化新闻生成
- ✅ @成员功能

**适用场景**:
- 每日行业简报推送
- 项目进度更新
- 技术分享推荐
- 紧急通知发布
- 数据报告推送

📄 [查看详细文档](dingtalk/README.md)

## 🚀 快速开始

### 前置要求

- Python 3.6+
- 钉钉账号和企业/团队
- 网络连接

### 安装步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd skill-media
```

2. **安装依赖**
```bash
cd dingtalk
pip install -r requirements.txt
```

3. **配置钉钉机器人**
   - 在钉钉群中添加自定义机器人
   - 获取Webhook URL和密钥（如启用加签）
   - 设置环境变量或准备配置文件

4. **测试运行**
```bash
cd dingtalk
python scripts/format_news.py --output test.json --title "测试消息" --date "2026-05-08"
# 编辑 test.json 添加内容
python scripts/send_dingtalk.py --config test.json
```

详细使用说明请参考各技能的README文档。

## 📂 项目结构

```
skill-media/
├── README.md              # 项目总览文档
├── .gitignore            # Git忽略配置
└── dingtalk/             # 钉钉新闻推送技能
    ├── README.md         # 技能详细说明
    ├── SKILL.md          # 技能技术规范
    ├── config.md         # 配置文件示例
    ├── requirements.txt  # Python依赖
    └── scripts/          # 脚本目录
        ├── dingtalk_client.py  # 核心客户端
        ├── format_news.py      # 新闻格式化工具
        ├── send_dingtalk.py    # 命令行接口
        └── test.json           # 测试配置文件
```

## 💡 使用建议

### 对于新媒体运营人员
- 利用模板系统快速创建每日/每周资讯
- 建立标准化的内容格式规范
- 结合定时任务实现自动化推送

### 对于技术团队
- 集成到CI/CD流程中发送构建通知
- 用于项目进度和里程碑提醒
- 技术文章和资源分享

### 对于管理者
- 定期接收业务数据报告
- 及时了解团队动态和项目进展
- 快速传达重要决策和通知

## 🔧 高级用法

### Python API集成

```python
from dingtalk.scripts.dingtalk_client import DingTalkClient

client = DingTalkClient()

# 发送Markdown消息
success = client.send_markdown(
    title="今日资讯",
    text="## 新闻内容..."
)

# 发送时@特定成员
success = client.send_markdown(
    title="重要通知",
    text="请各位注意...",
    at_mobiles=["13800138000"]
)
```

### 定时任务配置

**Linux/Mac (crontab)**:
```bash
# 每天上午9点发送日报
0 9 * * * cd /path/to/skill-media/dingtalk && python scripts/send_dingtalk.py --config daily_news.json
```

**Windows (任务计划程序)**:
使用图形界面创建定时任务，指向Python脚本。

## 🤝 贡献指南

欢迎贡献新的技能或改进现有功能！

### 贡献步骤
1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

### 开发新技能
如需开发新的媒体运营技能，请参考：
1. 在根目录下创建新的技能文件夹
2. 遵循现有的项目结构
3. 编写完整的README.md和SKILL.md
4. 提供清晰的示例和文档

## 📝 文档资源

- [钉钉开放平台文档](https://developers.dingtalk.com/)
- [自定义机器人接入指南](https://developers.dingtalk.com/document/robots/custom-robot-overview)
- [消息类型与数据格式](https://developers.dingtalk.com/document/robots/custom-robot-send-messages)

## ❓ 常见问题

### Q: 如何选择合适的消息类型？
**A**: 
- 长篇内容 → Markdown
- 单条公告 → 文本卡片
- 带链接的文章 → 互动卡片
- 多条新闻 → 图文列表

### Q: 发送失败怎么办？
**A**: 
1. 检查Webhook URL是否正确
2. 确认签名密钥是否匹配
3. 查看错误提示信息
4. 参考各技能的故障排除章节

### Q: 可以发送到多个群吗？
**A**: 可以，为每个群创建独立的机器人，分别配置不同的Webhook URL。

## 📄 许可证

本项目基于MIT许可证开源，可自由使用和修改。详见 [LICENSE](LICENSE) 文件。

## 🙏 致谢

感谢所有为本项目做出贡献的开发者和使用者！

## 📮 联系方式

如有问题或建议，请通过以下方式联系：
- 提交Issue
- 发起Discussion
- 发送邮件至：[your-email@example.com]

---

**⭐ 如果这个项目对您有帮助，请给我们一个Star！**