Open Source Marketing

开源营销

何时使用

当用户想要以真诚方式推广开源项目时使用此技能。触发词：开源营销、OSS营销、GitHub推广、推广我的库、增长Star、开源发布、开源增长、贡献者营销。

本技能帮助你推广开源项目而不让人反感。涵盖 GitHub 优化、社区建设、贡献者体验、发布策略和可持续增长。

开始之前

先加载你的受众上下文。 阅读 .agents/developer-audience-context.md 以了解：

• 谁会使用这个项目（角色、技术栈、痛点）
• 他们在哪里发现工具（社区、社交媒体、搜索）
• 有哪些替代方案（为什么他们会切换？）
• 他们如何评估开源项目（Star、活跃度、文档、社区）

如果上下文文件不存在，先运行 developer-audience-context 技能。

开源营销思维

什么有效 vs. 什么无效

增长公式

Growth = (Real value) × (Discoverability) × (First-use experience)

任何一个因子为零，增长就为零。

GitHub 优化

README 优化

你的 README 就是你的落地页。把它优化好。

结构：

# Project Name

[One-line description that explains what it does]

[Badges: build status, version, license, downloads]

[Screenshot or GIF showing it in action]

## Why [Project Name]?

- ✅ [Benefit 1 - specific, not fluffy]
- ✅ [Benefit 2]
- ✅ [Benefit 3]

## Quick Start

\`\`\`bash
npm install project-name
\`\`\`

\`\`\`javascript
// 5 lines that show immediate value
\`\`\`

## Installation

[Detailed installation for all platforms]

## Usage

[Core usage patterns with examples]

## Documentation

[Link to full docs]

## Contributing

We love contributions! See [CONTRIBUTING.md](https://github.com/jonathimer/devmarketing-skills/tree/main/skills/open-source-marketing/CONTRIBUTING.md).

## License

[License type] - see [LICENSE](https://github.com/jonathimer/devmarketing-skills/tree/main/skills/open-source-marketing/LICENSE)

README 检查清单

仓库优化

Issue 和 PR 模板

Bug 报告模板：

---
name: Bug Report
about: Report a bug to help us improve
---

## Bug Description
[Clear description]

## Steps to Reproduce
1.
2.
3.

## Expected Behavior
[What should happen]

## Actual Behavior
[What actually happens]

## Environment
- OS:
- Node version:
- Package version:

## Additional Context
[Screenshots, logs, etc.]

功能请求模板：

---
name: Feature Request
about: Suggest an idea for this project
---

## Problem
[What problem does this solve?]

## Proposed Solution
[How would you like it to work?]

## Alternatives Considered
[Other approaches you've thought about]

## Additional Context
[Examples, mockups, etc.]

社区建设

社区平台

从 GitHub Discussions 开始。当活跃用户超过 50 人时再加 Discord。

社区原则

贡献者漏斗

User → Star → Issue → PR → Regular Contributor → Maintainer

优化每个转化环节：

贡献者体验

CONTRIBUTING.md 要点

# Contributing to [Project]

First off, thanks for considering contributing! ❤️

## Quick Start

1. Fork the repo
2. Clone your fork
3. Install dependencies: `npm install`
4. Create a branch: `git checkout -b my-feature`
5. Make your changes
6. Run tests: `npm test`
7. Commit: `git commit -m "Add my feature"`
8. Push: `git push origin my-feature`
9. Open a Pull Request

## Development Setup

[Detailed setup instructions]

## Code Style

- We use [Prettier/ESLint config]
- Run `npm run lint` before committing
- [Other conventions]

## Commit Messages

We follow [Conventional Commits](https://conventionalcommits.org/):
- `feat: add new feature`
- `fix: resolve bug`
- `docs: update readme`
- `chore: update dependencies`

## Pull Request Process

1. Update docs if needed
2. Add tests for new features
3. Ensure CI passes
4. Get one approval

## Good First Issues

Look for issues labeled `good first issue` — these are great starting points!

## Questions?

Open a Discussion or reach out on Discord.

"Good First Issue" 策略

创建真正容易上手的问题：

每个 good first issue 应包含：

• 解释上下文及为何重要
• 链接到相关代码文件
• 描述预期结果
• 在评论中提供帮助

发布策略

发布前检查清单

发布日行动手册

时间线：

各平台策略

Hacker News：

• 标题：描述性的，不夸大（"Show HN: X — a Y for Z"）
• 首条评论：解释动机和技术决策
• 保持在线数小时以回应
• 不要求赞（必死无疑）

Reddit：

• 找 2-3 个相关 Subreddit（不只是 r/programming）
• 先读规则
• 做社区成员，不做营销者
• 分享真正有用的上下文

Twitter/X：

• 主题帖格式：问题 → 方案 → 演示 → 链接
• 附上 GIF/视频
• 标记相关账号（框架作者等）
• 分享公开构建的历程

Dev.to / Hashnode：

• 写一篇"我为什么做了这个"文章
• 技术深度，个人故事
• 从你的博客交叉发布

发布后

可持续增长

增长策略

开源内容策略

避免倦怠

关键指标

虚荣指标 vs. 价值指标

追踪什么

工具

相关技能

• developer-audience-context — 了解你的用户
• community-building — 建立 Discord/Slack 社区
• devrel-content — 创建配套内容
• developer-advocacy — 会议演讲、播客
• hacker-news-strategy — 在 HN 上发布和互动

限制

• 仅当任务明确匹配其上游来源和本地项目上下文时使用此技能。
• 在应用变更前，验证命令、生成的代码、依赖、凭证和外部服务行为。
• 不要将示例替代针对特定环境的测试、安全审查，或用户对破坏性/高成本操作的审批。