将任意项目美化为适合 GitHub 发布的专业级开源版本，补齐全套社区健康文件与 CI 自动化，构建专属针对性门面与全生态分发。
Turn any project into a polished, GitHub-ready open-source repository with full community health files, CI automation, and tailored multi-channel distribution.
-brightgreen){kind=icon}
将代码、智能体或知识库项目推送到 GitHub 开源时，开发者往往面临这些繁琐痛点：
- 缺少合规的
LICENSE、CODE_OF_CONDUCT.md、SECURITY.md或现代 YAML 格式的 Issue 表单，导致 GitHub Insights → Community 健康度无法达到 100%； - README 结构泛化千篇一律，无法突出 AI 技能、MCP Server、大模型/GGUF、系统 CLI、浏览器扩展或全栈 Web 应用的独特核心价值；
- 缺少
uvx、bunx、pnpm dlx、Hugging Face、Chrome Web Store 的具体发版指令与 CI 矩阵测试； - 不慎把本地绝对路径（
<user_home>）、私有 Agent 会话标记、甚至 API 密钥与 Git 凭据推送到公共仓库造成泄露。
github-oss-prep 是一个专为 AI Agent（与开源作者）打造的专业级 GitHub 开源准备技能。它确立了 渐进式披露原则（Progressive Disclosure），内置 十大全景项目品类专属 README 完整模板库、全生态发版实操指南、五重深度环境与隐私安全审计网 与 GitHub 2026 社区与 CI 自动化文件库，实现一键规范化整理与安全发布。
| 核心模块 | 覆盖功能 | 带来价值 |
|---|---|---|
| 十大全景品类 README 引擎 | 覆盖 AI Skill、MCP Server、AI 模型/GGUF、CLI 工具、多媒体、SDK、浏览器扩展、IaC 配置、Web 应用、Awesome 清单 | 告别泛化概念，直接复制填空，精准呈现各类项目核心卖点 |
| 渐进式披露执行铁律 | 依据品类判定结果定向调阅专属规范，严格隔离无关品类 | 杜绝上下文膨胀与跨品类交叉污染，生成质量 100% 聚焦 |
| 五重深度隐私安全网 | 拦截 API Key、私有路径指纹、内部会话 ID、Git Remote Token、构建缓存，附带真伪泄露案例比对表 | 100% 杜绝敏感凭据与个人开发环境泄露 |
| 2026 社区与 CI 自动化库 | 交互式 YAML Issue Forms、PR 模板、SECURITY.md、Node/Python 矩阵 CI 与 Dependabot |
轻松获得 GitHub Community Profile 100% 满分并实现依赖自动安全更新 |
| 全生态分发与发版实操 | uv/PyPI、npm、Hugging Face、Chrome Web Store、Docker、Homebrew、Crates.io 具体发版指南与 Release Checksums | 提供从本地代码到全球各大分发中心的全流程发版指令 |
| 轻量规范化工程架构 | 主干精简，单层 Reference Map 直达，配齐自动化回归自测 | 严守工程纪律，skill-doctor 37 项审查 100% PASS |
[输入: 本地任意待开源项目 / 目录]
│
[Step 0: 十大全景品类识别与定位]
精准判定: AI Skill / MCP Server / 模型权重 / CLI 工具 / 浏览器扩展 / IaC / ...
│
[Step 1: 五重深度安全扫描]
拦截 API 密钥 / 私有路径指纹 / 内部会话 ID / Git URL 污染 / 垃圾缓存
│
[Step 2: 2026 社区与 CI 补齐]
生成交互式 YAML Issue Forms / PR 模板 / SECURITY.md / CI / Dependabot
│
[Step 3: 渐进式专属 README 门面渲染]
遵循渐进式披露，定向调阅专属品类完整骨架 (含动态 Shields 徽章)
│
[Step 4: 全生态分发与包管理配置]
配置 uvx / bunx / HuggingFace / ChromeStore / gh skill / Checksums
│
[Step 5: 干净环境回归自测]
运行 scripts/selftest.py，确保 100% 满分通过质量门禁
│
[Step 6: 分阶段授权发布]
经用户明确确认后推送 GitHub、打 Tag 并发布 GitHub Release
这是一个标准的 AI Agent Skill —— 安装到你的 AI 助手后即可直接使用。
把下面这句话直接复制发送给你的 AI 助手，它会自动识别环境并克隆到正确的技能目录：
请安装 github-oss-prep 技能：克隆
https://github.com/hyt315/github-oss-prep到你的 skills 目录（如~/.claude/skills/github-oss-prep或~/.agents/skills/github-oss-prep），并确认安装成功。
💡 小模型同样适配：安装完成后，只需对 AI 说“帮我把这个项目开源整理一下”或“准备发布到 GitHub”，即可自动触发全流程。
gh skill install hyt315/github-oss-prep github-oss-prep --agent claude-code --scope user| 平台 | 安装命令 |
|---|---|
| Claude Code | git clone https://github.com/hyt315/github-oss-prep.git ~/.claude/skills/github-oss-prep |
| Codex | git clone https://github.com/hyt315/github-oss-prep.git ~/.codex/skills/github-oss-prep |
| Cursor | git clone https://github.com/hyt315/github-oss-prep.git ~/.cursor/skills/github-oss-prep |
| 通用 Agents 目录 | git clone https://github.com/hyt315/github-oss-prep.git ~/.agents/skills/github-oss-prep |
python scripts/selftest.py假设本地有一个编写好的 Python CLI 工具、MCP Server 或浏览器扩展准备开源：
- 触发与扫描：向 AI 发送“帮我准备开源这个项目” → 自动识别品类，执行 5 重隐私扫描，阻断路径指纹与未清理缓存；
- 生成社区与 CI 文件：自动生成符合 GitHub 2026 规范的 YAML Issue Forms、
SECURITY.md、LICENSE以及 Node/Python 矩阵 CI 流水线； - 渐进式渲染门面：严格根据品类调阅对应模版，生成包含痛点解构、现代运行器矩阵 (
uvx/bunx)、配置代码块的中英文 README； - 验证与分发：本地运行
selftest.py自动化回归自检，输出完整可审查项目包，在获得授权后一键发布 GitHub、Release 资产与对应生态中心。
- 先审后改（Audit Before Change）：本地整理默认只读扫描并输出差异报告，绝不擅自强行覆盖用户现有文件。
- 渐进式隔离（Progressive Isolation）：处理特定项目时仅读取专属模板，杜绝上下文冗余与环境参数污染。
- 五重严密防御：对代码、文档、
.git/config与历史提交进行全面深度扫描，阻断任何敏感信息。 - 分阶段明确授权：本地开源整理、远程仓库创建、Release 打包分发与外部推广分别独立确认，绝不越权连带执行。
| 方式 | 命令 / 链接 |
|---|---|
| HTTPS | git clone https://github.com/hyt315/github-oss-prep.git |
| SSH | git clone git@github.com:hyt315/github-oss-prep.git |
| GitHub CLI | gh repo clone hyt315/github-oss-prep |
| ZIP 压缩包 | 下载 ZIP |
| Tar 归档 | 下载 Tar |
| 单文件 (SKILL.md) | curl -O https://raw.githubusercontent.com/hyt315/github-oss-prep/main/SKILL.md |
| 参考文档 | 核心内容 | 推荐阅读时机 | 预估耗时 |
|---|---|---|---|
📑 十大品类完整 README 模板库 (readme-template.md) |
10 大软件形态完整开箱即用 Markdown 骨架与现代终端运行器表 | 为项目生成或重构 README 时 | 4 分钟 |
🚨 开源准备避坑库与官方规范基线 (github-oss-prep-pitfalls.md) |
GitHub Insights 100% 门禁、Git 历史凭据残留洗库与 CI 供应链 Action 锁定 | 评估安全基线与排查深水陷阱时 | 4 分钟 |
🛡️ 五重隐私与安全扫描 (privacy-scan.md) |
5 重扫描防御网、真伪泄露实战比对表与脱敏规则 | 执行本地安全自检与脱敏排查时 | 3 分钟 |
🏛️ 社区健康文件与 CI 模板 (community-templates.md) |
现代交互式 YAML Issue Forms、Node/Python 矩阵 CI 工作流与 Dependabot | 补齐 GitHub 社区文件与持续集成时 | 3 分钟 |
🚀 全渠道分发与发版指南 (release-and-distribution.md) |
uv、npm、HuggingFace、ChromeStore、Docker 发版实操、国内镜像源与 Checksums | 发布到全球平台或 GitHub Release 时 | 4 分钟 |
🏷️ Description 与 Topics 指南 (description-guide.md) |
精准 120 字仓库简介与高权重标签生成指南 | 设置 GitHub 仓库门面信息时 | 3 分钟 |
🌐 开源发现与推广策略 (discovery-and-promotion.md) |
Launch Kit 营销包、社交预览与全网发布渠道 | 准备发布与对外推广项目时 | 3 分钟 |
🔐 GitHub 推送与 MCP 指引 (mcp-push-guide.md) |
官方 MCP 与标准 CLI 推送流程 | 执行远程推送与仓库创建时 | 2 分钟 |
🚦 PR 与发布门禁工作流 (pr-and-release-workflow.md) |
分支、PR、CI 测试与发布自动化校验 | 建立持续集成与发版流水线时 | 3 分钟 |
github-oss-prep/
├── SKILL.md # 核心技能定义、渐进式披露与轻量化工作流
├── README.md # 中文说明文档
├── README.en.md # 英文说明文档
├── CHANGELOG.md # 版本发布记录
├── LICENSE # MIT 开源许可证
├── .gitignore # Git 忽略规则
├── CONTRIBUTING.md # 社区贡献指南
├── CODE_OF_CONDUCT.md # 行为准则
├── SECURITY.md # 安全策略
├── SUPPORT.md # 支持渠道
├── manifest.json # 技能元数据清单
├── agents/ # 多 Agent 平台元数据
├── scripts/
│ ├── validate_repo.py # 仓库结构、规范与隐私安全校验器
│ └── selftest.py # 自动化回归自测脚本
├── tests/
│ └── test_skill.py # Pytest 自动化测试套件入口
├── .github/
│ ├── CODEOWNERS # 代码审查者配置
│ ├── pull_request_template.md # 标准 PR 模板
│ ├── workflows/ # CI 自动化工作流
│ └── ISSUE_TEMPLATE/
│ ├── bug_report.yml # 交互式 Bug 反馈表单
│ ├── feature_request.yml # 交互式功能建议表单
│ └── config.yml # Issue 模板选择器配置
└── references/ # 深度参考文档
├── github-oss-prep-pitfalls.md # 开源准备核心避坑库与官方规范基线
├── readme-template.md # 十大品类专属 README 完整模板库
├── privacy-scan.md # 五重深度隐私与环境安全扫描指南
├── community-templates.md # GitHub 2026 社区文件库与 CI 模板
├── release-and-distribution.md # 全渠道现代分发与发版实操指南
├── description-guide.md # Description 与 Topics 标签优化指南
├── discovery-and-promotion.md # 开源发现、Launch Kit 与推广策略
├── mcp-push-guide.md # GitHub 推送与授权指引
├── pr-and-release-workflow.md # PR、CI 与发布门禁
├── github-pat-setup.md # GitHub PAT 配置指南
└── github-pat-comparison.md # GitHub PAT 权限类型对比
面向独立开发者与开源团队的完整工具链闭环：
| 阶段 / 角色 | 推荐技能 | 核心使命与能力 | GitHub 仓库 |
|---|---|---|---|
| 📦 开源前准备 | github-oss-prep |
自动化生成规范门面、中英双语 README、CI 工作流、社区资产与合规审计 | hyt315/github-oss-prep |
| 🩺 质量体检 | skill-doctor |
50+ 项工业级静态规则 + 动态实跑自测，确保 Agent Skill 100% 满分无死角 | hyt315/skill-doctor |
| ⚙️ 开源后运营 | github-oss-ops |
智能分流 Issue、AI 垃圾防御、PR 辅助审查、GHSA 私有漏洞协同与发版全渠道广播 | hyt315/github-oss-ops |
| 🚀 贡献者导航 | github-oss-contribute |
面向贡献者的全程向导：Fork 同步、Rebase 冲突消解、DCO 签名、反 AI Slop 质量门禁 | hyt315/github-oss-contribute |
- Q: 整理和打包需要 GitHub Token 吗？
A: 不需要。项目扫描、隐私检查、规范补齐、README 生成与源码 ZIP 打包均在本地完成，只有最终向 GitHub 推送时才需要授权。 - Q: 它会擅自修改我的现有代码吗？
A: 绝对不会。本技能坚持“先审后改”原则，仅在用户明确批准后才创建或修改文件。 - Q: 我的项目不是 AI 技能，也能使用吗？
A: 完全可以。内置十大全景品类模板引擎，对 MCP Server、AI 模型权重、CLI 工具、浏览器扩展、类库 SDK、IaC 配置与 Web 应用均有深度针对性支持。 - Q: 为什么技能主干
SKILL.md能够保持轻量？
A: 技能严格遵循渐进式披露架构，将各领域的详细模板下沉到references/独立模块中，避免 AI 上下文过载与交叉污染。
欢迎提交 Issue 与 Pull Request！详见 CONTRIBUTING.md。如果这个技能对你有帮助，欢迎在 GitHub 上点个 Star ⭐！
本项目采用 MIT 许可证 开源。
详见 CHANGELOG.md 了解版本演进历史。
🌏 English: README.en.md