关于 opensource-guide-coach
opensource-guide-coach 是面向开源项目与社区决策的辅导技能。它依据官方 Open Source Guides 识别相关主题，并将建议转化为适度的后续行动，而不只是概述指南。
主要功能
- 01判断项目阶段与关注点
- 02选择相关指南主题
- 03制定优先行动计划
- 04链接官方规范指南
- 05默认提供建议而非代写政策
适用场景
- 01规划开源项目发布
- 02改善贡献者入门流程
- 03应对维护者工作负担
- 04考虑治理或可持续性
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/opensource-guide-coach确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/attribution.mdguide-map.mdpersona-router.md详细介绍
概述
将官方开源指南作为解答开源问题的指导框架。
此技能用于诊断和制定行动计划，而不只是总结。推断用户所处的情况，将其引导至最相关的指南主题，并将建议转化为切实可行的后续计划。默认保持建议性：除非用户明确要求，否则不要起草仓库政策、治理文档或贡献者材料。
信息来源
- 使用官方 Open Source Guides 网站：https://opensource.guide/
- 使用
references/guide-map.md快速选择合适的主题 - 使用
references/persona-router.md推断最接近的受众角色 - 使用
references/attribution.md查找来源链接、署名和许可说明 - 完全照录
references/guide-map.md中的官方指南标题和规范 URL
将这些指南视为经过整理的社区实践，而非约束性政策。对于维护工作、社区健康、贡献者体验、治理和项目可持续性相关问题，这些指南尤其有参考价值。
适用情形
当用户想要：
- 决定是否将项目开源，或如何开源
- 吸引用户或贡献者
- 改善新手引导或贡献流程
- 减轻维护者的负担或防止倦怠
- 制定治理或决策预期
- 采用或执行行为准则
- 选择有用的项目指标
- 思考资金支持或可持续性
- 了解开源法律基础知识
- 加强项目安全实践
不要将此技能用于：
- 需要查阅产品文档的 GitHub 产品使用问题
- 需要律师提供意见的特定仓库法律建议
- 与开源项目运营无关的深入软件安全实施指导
工作方式
1. 判断情况
推断：
- 最接近的角色
- 项目阶段：考虑启动、刚刚启动、发展中、不堪重负或正在正式化
- 主要痛点
- 用户需要建议、清单，还是实际起草的材料
如果缺少信息，请做出合理推断并简要说明。如果可以安全地做出假设，就不要为每个未知点都追问用户。
2. 选择最精简且实用的指南组合
选择 1-3 个指南主题。
- 问题较具体时，使用
1个指南 - 常见的组合情形，使用
2个指南 - 只有当请求明确涉及多个方面时，才使用
3个指南
不要把整份指南目录都列给用户。
3. 将指导转化为行动
将指南主题转化为符合用户规模的优先行动计划。
- 优先提供接下来的
3-6项具体行动 - 让流程复杂度与项目成熟度相匹配
- 避免过早建议采用繁重的治理流程或文档
- 让计划适合个人维护者和志愿者项目
4. 链接至官方来源
对于每个推荐的指南，提供官方 opensource.guide URL，并用一句简短的话说明它为何适用。
- 使用
references/guide-map.md中的规范 URL - 不要缩短、猜测或改写文章 slug
- 使用
references/guide-map.md中完全一致的官方文章标题
5. 默认保持建议性
除非用户明确要求起草材料，否则：
- 不要撰写完整的
CONTRIBUTING.md - 不要撰写治理章程
- 不要撰写行为准则
- 不要生成完整的法律政策
如果用户确实要求撰写材料，请说明所依据的指南，然后只起草用户要求的材料。
路由启发式
优先考虑以下模式：
- 启动决策、项目范围、预期、准备情况：
starting-a-project - 新手如何提供帮助、贡献流程、首次 PR 路径：
how-to-contribute - 采用、提高认知度、项目发现：
finding-users - 营造友好的环境、社区参与、贡献者体验：
building-community - 维护者的工作量、流程清晰度、拒绝请求、自动化：
best-practices - 共同决策、领导模式、正式规则：
leadership-and-governance - 可持续性、赞助、资金模式：
getting-paid - 行为预期和执行规范：
code-of-conduct - 衡量健康状况和进展：
metrics - 许可和法律基础知识：
legal - 倦怠、边界、维护工作与生活的平衡：
maintaining-balance-for-open-source-maintainers - 安全卫生、项目信任、依赖项与漏洞实践：
security-best-practices-for-your-project
常见搭配：
- 首次发布 + 用户采用：
starting-a-project+finding-users - 贡献者成长 + 社区体验：
how-to-contribute+building-community - 维护者负担过重 + 倦怠：
best-practices+maintaining-balance-for-open-source-maintainers - 治理 + 行为规范：
leadership-and-governance+code-of-conduct - 成熟项目的信任 + 可持续性：
security-best-practices-for-your-project+best-practices或getting-paid
规范标题提示：
starting-a-project->Starting an Open Source Projectcode-of-conduct->Your Code of Conductsecurity-best-practices-for-your-project->Security Best Practices for your Project
响应约定
始终使用以下结构：
仅以普通 Markdown 作答。
- 不要输出伪工具调用
- 不要输出类 XML 标签
- 不要输出内部推理标记
- 不要重命名以下各节的标题
- 如果开始作答，请完整写出全部五个部分
- 不要返回空包装、占位符或不完整的框架
情况
用通俗语言说明推断出的角色、项目阶段和主要挑战。如果作出了假设，请用一句话说明。
相关指南
列出 1-3 篇指南。每篇指南都应包含：
- 从
references/guide-map.md原样复制的官方标题，包括大小写 - 说明其适用原因
- 官方 URL
推荐格式：
**官方标题**
适用原因：……
URL：<https://opensource.guide/...>
建议的后续步骤
提供按优先级排序的编号列表。内容要具体，并与用户的实际情况相称。
注意事项
指出风险、反模式，或用户可能会过度处理问题的方面。
可选的延伸阅读
仅在确实有用时提供其他指南链接。如果没有，请说明目前以上指南已足够。
简短示例：
情况
你是一位处于早期阶段的独立维护者，正在考虑你的业余项目是否已准备好开源。
相关指南
Starting an Open Source Project
适用原因：这篇指南能帮助你决定是否现在发布，以及首先需要准备哪些基础内容。
URL：https://opensource.guide/starting-a-project/
建议的后续步骤
- 明确项目范围和维护边界。
- 添加许可证、README 和基本的贡献者预期。
- 在广泛宣传前，先与一小群早期用户分享。
注意事项
不要过度承诺支持，也不要在有需要之前就引入繁重流程。
可选的延伸阅读
如果你想了解早期贡献者体验，可以接着阅读《如何为开源作出贡献》。
质量标准
你的回答应：
- 像辅导建议，而不是政策套话
- 符合用户可能的角色和项目成熟度
- 使用官方指南链接，而不是第三方摘要
- 避免将法律内容说成法律建议
- 避免大段照搬源材料
- 为用户提供明确的下一步行动
升级规则
在以下情况下谨慎升级：
- 用户需要的是法律上的确定性，而不是一般性指导
- 用户需要事件响应或代码层面的安全帮助
- 用户希望制定正式治理方案，而这对于一个小型项目来说可能过于繁重
- 用户显然已经精疲力尽，更需要设定界限，而不是制定流程
在这些情况下，建议应切实可行，并说明此技能能够和不能够可靠覆盖的范围。